Changing server properties in 100Custom.xml

To modify a Process Server or Process Center configuration, update the server's 100Custom.xml file. Here, you can modify the elements that comprise the server configuration, including environment name, repository server information, and Performance Data Warehouse communication methods.

About this task

This topic provides general guidance for modifying server properties in the 100Custom.xml file, as well as an example and links to other topics with instructions for performing specific types of server property configuration. The Process Server 100Custom.xml file is located in the directory PROFILE_HOME\config\cells\cell_name\nodes\node_name\servers\server_name\process-server\config. The Process Center 100Custom.xml file is located in the directory PROFILE_HOME\config\cells\cell_name\nodes\node_name\servers\server_name\process-center\config.
Note: The updateBPMconfig admin task was added in V7.5.1.1. This admin task updates 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.
IBM® Business Process Manager merges the changes you make in the 100Custom.xml file with the original configuration based on the value of the merge attribute. Use one of the following values, depending on how you want to merge updated elements between the 100Custom.xml and the original configuration. Remember that attribute values must be in quotation marks (for example, "mergeChildren").
Table 1.
Value for merge attribute Description
append Appends the new tag
mergeChildren Merges the new tag with the first of the existing tags (default behavior)
replace Replaces all old tags with the new one
To update the server configuration properties in the 100Custom.xml file, perform the following steps.

Procedure

  1. Stop the server for Process Server or Process Center.
  2. Open the original configuration file (for example, PROFILE_HOME\config\cells\cell_name\nodes\node_name\servers\server_name\process-server\config\system\99Local.xml) in a text editor.
  3. Copy the relevant sections from the 99Local.xml file to the 100Custom.xml file and make the necessary changes. See the related links at the bottom of this topic for information on specific types of property configuration.
  4. Save your changes in the 100Custom.xml file.
  5. Start the server for Process Server or Process Center.

Example

The following example shows how to modify the environment-name property for the server.
  1. Stop the server.
  2. Open the 99Local.xml file and locate the following text:
    <properties>
    		<common merge="mergeChildren">
    			<environment-name>My Environment</environment-name>
    		</common>
    </properties>
  3. Copy and paste that text into the 100Custom.xml file.
  4. Update the environment-name property in the text you pasted into the 100Custom.xml file, as shown below:
    <properties>
    		<common merge="mergeChildren">
    			<environment-name merge="replace>My New Environment</environment-name>
    		</common>
    </properties>
  5. Save your changes and restart the server.