pfrinit
Purpose
Performs the following tasks:
- Modifies the default Cognos Analytics 11 capabilities to fit the InForm reporting environment.
- Creates new Cognos Analytics 11 groups that match InForm reporting requirements.
- Sets Public folders permissions so that only Publishers can write to this public area.
- Maps study-specific reporting groups to the Cognos Analytics 11 groups and roles.
- Creates study-specific data connection and set permissions so that it is restricted for the use of study members only.
- Copies the InForm Trial Management package present in the InForm folder and renames it as a study-specific package.
- Creates a study folder that contains all the standard folders and reports that point to the study-specific package. Relative paths within reports will be modified to reflect the new location.
- Validates all copied reports so that all successfully validated reports are syntactically correct and able to run against the study-specific packages.
Location
The InForm Application Server folder of the server where the Cognos Application Tier components are installed. For example, <Installation_Directory>\InForm\bin.
Usage
pfrinit [setupinform]
Command parameters
Option |
Parameter |
---|---|
setupinform |
When specified, configures the reporting environment without a study. When migrating the reporting environment to a new machine, run the command with this parameter before you import export packages. |
Command line prompts
You are prompted for the following parameters:
- sysadmin_namespace—Oracle Directory Server admin namespace.
- sysadmin_uid—User name for the Oracle Directory Server admin namespace.
- sysadmin_pass—Password you chose when creating the crnsysadmin user.
- publisher_namespace—Custom Authentication Provider (CAP) namespace. Enter informcap.
- publisher_uid—InForm study user who is a member of the following Reporting groups:
- Publishers.
- Either Sponsor Users or Site Users.
- publisher_pass—Password of the InForm study user.
- dispatcher_url—Internal URI that the InForm server uses to communicate with the Cognos Analytics 11 server.
- trial_name—Name of the InForm study.
- reportdb_pass—Study PID.
- in_place_upgrade—Y/N. Indicate if the PFRInit command is being run as part of an in-place upgrade (required for an in-place upgrade).
For legacy purposes, you can also pass the parameters by using the /accountparams:"path_to_parameter_file" command option.
When specified, this option includes the path to a text file that contains the values required to run the command. The format of the parameter file is parameter=value. There is a new line for each parameter, and there are no spaces on a line.
Note
The recommended InForm study user for running pfrinit is pfreportinguser. You can change the password for this user using the InForm user interface as with any other user. After you change the password, however, you must run the PFADMIN command, using this syntax:
PFADMIN SETSERVER PFREPORTINGUSERPW <studyname>
When prompted, enter the pfreportinguser password.
This command sets a property used by Reporting when it needs the credentials of the pfreportinguser.
For more information, see pfadmin.
Example
pfrinit "E:\scripts\init.txt"