pfrinit

Purpose

Performs the following tasks:

• Modifies the default Cognos Analytics capabilities to fit the Oracle InForm reporting environment.
• Creates new Cognos Analytics 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 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 Oracle InForm Trial Management package present in the Oracle 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 Oracle InForm Application Server folder of the server where the Cognos Application Tier components are installed. For example, the <Installation_Directory>\InForm\bin folder.

Usage

pfrinit [setupinform]

Where:

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 — Oracle InForm study user who is a member of the following Reporting groups:
  • Publishers
  • Either Sponsor Users or Site Users.
• publisher_pass — Password of the Oracle InForm study user.
• dispatcher_url — Internal URI that the Oracle InForm server uses to communicate with the Cognos Analytics server.
• trial_name — Name of the Oracle 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 more information, see the Upgrade and Migration Guide.

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 Oracle 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.

Examples

pfrinit "E:\scripts\init.txt"