FileNet P8 Process Engine, Version 5.0.+              

Configuring a Process Engine virtual server and database silently

Configure a Process Engine virtual server and database silently by using the PEInit command-line tool.

Be sure that you have available the Installation and Upgrade Worksheet that was completed during your planning activities.

Configure a Process Engine virtual server and database silently by using the PEInit command with appropriate parameters. These activities are broken into steps which you must run in the following order.

  1. Configure the virtual server. This step creates the vwserver.ini configuration file. This configuration file identifies basic database configuration information to each host, including where the Process Engine database is located and how to log on to it.
  2. Configure and initialize the Process Engine database. This step includes configuring the database table spaces and file groups, the connection to Content Engine and all user authentication information. This configuration information is stored in the Process Engine database.
Create two input parameter files.

To configure a Process Engine virtual server and database silently:

  1. Log on to the Process Engine server. Any user can create the input parameter files. To run the commands in the PEInit tool, you must enter the pe_service_user user name and password.
  2. Create the virtual server:
    1. Change the current directory to pe_install_path\data where pe_install_path is the location of the program files that was specified during the Process Engine installation.
    2. Make a copy of the PEInitV.properties.sample file and save it as PEInitV.properties.
    3. Using a text editor, edit the PEInitV.properties file by providing the parameter values for your configuration.
    4. Enter the parameters, one parameter per line in the following format:
      parameter name=value
      Parameter Description
      DBType Define the database type. Valid values are:
      • DB2
      • Oracle
      • MSSQL
      Enter the database type as defined by the DBType property in the worksheet. This parameter is required. You distinguish between DB2® for z/OS® and DB2 for Linux®, UNIX® and Windows® by using the DBVersion parameter.
      DBVersion This parameter is required for DB2 databases, and valid values are:
      • DB2LUW
      • DB2zOS
      DBName Enter the name of the Process Engine database that is defined by the DBName property in the worksheet. This parameter is required. If you are using the PEInitV.properties file, set DBName to the DB2 for z/OS instance name.
      DBHost Enter the server host name where the Process Engine database resides. The host is identified by the DBHost property in the worksheet. If the parameter is not provided, the default value is localhost. This parameter is not required if you provide the DBConnectURL. If the default URL format is not acceptable, enter the DBConnectURL instead of the DBHost and DBPort in the PEInitV.properties file.
      DBPort Enter the value for the database port as identified by the DBPort property in the worksheet. Default values are:
      1433
      The default value for an SQL Server database instance. The port number is used to identify the SQL Server instance, and the instance name is not required in the configuration parameters.
      60000
      The default port number for a DB2 database.
      1521
      The default port number for an Oracle database.
      If no alternative port is identified, the default value for the port is assigned. This parameter is not required if you provide the DBConnectURL. If the default URL format is not acceptable, enter the DBConnectURL instead of the DBHost and DBPort in the PEInitV.properties file.
      DBConnectUrl This parameter is the optional database connection URL to be used to configure the database connection. Use this URL or use the DBHost and DBPort. If you specify the DBHost and DBPort, the DBConnectURL is automatically created for SQL Server, DB2, and Oracle databases as follows:
      • jdbc:sqlserver://DBhost:DBport;DatabaseName=DBName
      • jdbc:db2://DBhost:DBport/DBName
      • jdbc:oracle:thin:@DBhost:DBport:DBName
      If the default URL format that is specified is not acceptable, enter the DBConnectURL instead of the DBHost and DBPort. If the default URL is acceptable, enter only the DBHost and DBPort values in the PEInitV.properties file.
      DBUserName This parameter is the database user name that was identified by the pe_db_user parameter in the installation worksheet. This value is required.
      DBpw This parameter is the password for the database user. This value is required. If the password is encrypted, enter the value as @encrypted_pe_db_password. To encrypt the password, see the information in Encrypting passwords for Process Engine. If you enter the password as a non-encrypted value in the PEInitV.properties file, the password will be automatically encrypted in the vwserver.ini file. If you enter the password as a non-encrypted value in the PEInitV.properties file, delete the PEInitV.properties file after the configuration is complete.
    5. Configure a single virtual server by running the following command, entered as a single line:
      PEinit virtual_server_name -V 
      PEInitV.properties 
      where virtual_server_name is the name of the virtual server you are defining. If you do not specify the virtual server name, this server name is defined as default.
  3. Configure the database. These steps initialize the database, create the global tables (the ones not specific to an isolated region), store the table space information that is used to create the global tables, and store the Content Engine connection information.
    1. Make a copy of the PEInitD.properties.sample file and save it as PEInitD.properties.
    2. Using a text editor, edit the PEInitD.properties file by providing the parameter values for your configuration.
    3. Enter the parameters, one parameter per line in the following format:
      parameter name=value
      Parameter Description
      High availability farmed server environments PEServerVirtualHost Enter the host name of the machine that contains the load balancer. This parameter is needed only for virtual servers with more than one machine.
      PEServerMainPort Enter the Process Engine server port number that is used to handle public API requests. Port 32777 is used by default. Enter the port number as defined by the PEServerMainPort property in the worksheet. This parameter is required and must be unique for each virtual server on a machine.
      PEServerNamingServicePort Enter the Process Engine server port number that is used to handle naming service requests. Port 32776 is used by default. Enter the port number as defined by the PEServerNamingServicePort property in the worksheet. This parameter is required and must be unique for each virtual server on a machine.
      ServiceUser This parameter is the LDAP name that is used by Process Engine to connect to Content Engine. Enter the short name for this user, which is defined by the pe_service_user in the worksheet. This value is required.
      ServicePW Enter the password for the pe_service_user. If the password is encrypted, enter the value as @pe_service_user_password. To encrypt the password, see the information in Encrypting passwords for Process Engine. This value is required.
      CEURL Enter the URL that is used by Process Engine to connect to Content Engine This value is required and corresponds to the value that was entered when the Content Engine Client software was installed. This value is identified as the Content Engine Client Software URL (WSI) parameter in the worksheet. When used here, do not include the cemp in the string from the worksheet value. Enter the value as defined by the CEURL in the worksheet.
      SysAdminGroup Enter the Process Engine administrators group name, which is defined by the pe_admin_group parameter in the worksheet. This value is required.
      SysConfigGroup Enter the Process Engine configuration group name, which is defined by the pe_config_group in the worksheet. This value is optional.
      pe_data The name of the data table space for DB2 for Linux, UNIX and Windows or Oracle or the name of the file group for SQL Server. When using the PEInitD.properties file, specify only the pe_data information. Use the real DB2 for z/OS database name for the data tablespace name.
      pe_index The name of the optional index table space
      pe_blob The name of the optional BLOB table space, only for DB2
    4. Configure the database by running the following command, entered as a single line:
      PEinit virtual_server_name -D PEInitD.properties
       -Y pe_service_user+pe_service_user_password
      where virtual_server_name is the name of the virtual server you are defining. If you do not specify the virtual server name, this server name is defined as pesvr.default.
  4. Log off and log back on before running any other Process Engine program, such as Process Task Manager or Process Configuration Console.
Before the Process Engine database is ready for use you must configure an isolated region and, if the configuration is for IBM® Case Manager, create a link between the region and a Content Engine object store.


Feedback

Last updated: November 2010


© Copyright IBM Corporation 2010.
This information center is powered by Eclipse technology. (http://www.eclipse.org)