IBM BPM, V8.0.1, All platforms > Administer the IT infrastructure > Manage IBM Process Servers > Modify runtime server configuration properties

Modify IBM Process Server connection properties

Update the server configuration file to connect a Process Server in your runtime environment to a different Process Center, to connect an offline server, or to modify other connection properties.

Typically, each Process Server in a runtime environment is connected to a Process Center; a single Process Center can be connected to multiple servers. You can install process application snapshots from the Process Center to one or more of these connected Process Servers.

The relevant configuration settings are stored in 99Local.xml and 100Custom.xml.

If the same setting is found in both files, the value set in 99Local.xml is the one that is applied unless the merge attribute in 100Custom.xml is set to replace.

Update the Authentication Alias Configuration page and run the Admin task to update the connection properties. Access the Authentication Alias Configuration page by clicking Security > Global Security > Java Authentication and Authorization Service > J2C authentication data from the administrative console. An example to update the author alias is provided here. 

AdminTask updateBPMConfig {-nodeName Node_Name -serverName Server_Name -authorAuthAlias Author_Alias} AdminConfig save

The updateBPMconfig admin task is available to update the XML configuration files including the 100Custom.xml file to provide a single file that has all of the changes applied to the environment. The admin task creates the 100Custom.xml file if it does not exist. If you have multiple versions of the custom file, such as 101Custom.xml, 102Custom.xml, and so on, then only the 100Custom.xml file is updated.


Procedure

  1. Stop the Process Server.
  2. Open the original server configuration file and your local configuration file in text editors.

    • PROFILE_HOME\config\cells\ cell_name\nodes\ node_name\servers\ server_name\process-server\config\system\99Local.xml
    • PROFILE_HOME\config\cells\ cell_name\nodes\ node_name\servers\ server_name\process-server\config\100Custom.xml

  3. Copy the following section from the 99Local.xml file to the 100Custom.xml file. 
    <repository-server-url>http:// process-center-host-name: port/ProcessCenter</repository-server-url>
<repository-server-user-auth-alias>BPMRuntimeServer_Auth_Alias</repository-server-user-auth-alias>
<repository-server-designated-user-auth-alias>BPMAuthor_Auth_Alias</repository-server-designated-user-auth-alias>
<repository-server-interval>5</repository-server-interval>

  4. In the 100Custom.xml file, edit the values for the connection properties you want to modify, and then save your changes.

  5. Optional: Edit the <repository-server-user-auth-alias> and <repository-server-designated-user-auth-alias> property values. The <repository-server-user-auth-alias> value specifies the authentication alias for a user to connect from the process server to the Process Center. The user and password set in this alias must be present in the Process Center.

    The <repository-server-designated-user-auth-alias> value specifies the authentication alias for a user to access and deploy snapshots to the runtime process server and access that process server from the Process Inspector, which is located in IBM Process Designer. This authentication alias must be defined in both that process server and the Process Center and the passwords must match.

  6. To prevent the values in 99Local.xml from being used instead of the ones that you have edited in 100Custom.xml, add merge attributes to the parent tree and to each line of the calls that you edited. The result would be something like this example: 
    <properties>
  <server merge="mergeChildren">
    <repository-server-url merge="replace">http:// process-center-host-name: port/ProcessCenter</repository-server-url>
    <repository-server-user-auth-alias merge="replace">BPMRuntimeServer_Auth_Alias2</repository-server-user-auth-alias>
    <repository-server-designated-user-auth-alias merge="replace">BPMAuthor_Auth_Alias2</repository-server-designated-user-auth-alias>
    <repository-server-interval merge="replace">6</repository-server-interval> 
  </server>
</properties>
  7. Save your changes and close both the 100Custom.xml file and the 99Local.xml file.

  8. Start the Process Server.

Modify runtime server configuration properties