Changing the properties that identify an IBM Process Server

A Process Server passes information about itself when it connects to a Process Center. The Process Server administrator can configure the information that describes the Process Server by editing the 100Custom.xml file.

About this task

The Process Center uses information about the Process Server to determine the address that should be used to install process applications onto the Process Server. It displays that information on the Process Center Servers tab.

The following table shows the properties that the Process Server passes to the Process Center.

Property	Description
<server-name>	The name of this Process Server. This name is shown on the Servers tab of the Process Center.
<server-description>	A textual description of this server. You can see this text by hovering over the information icon of the Process Server entry on the Servers tab.
<server-host>	The host name that is used by Process Center to communicate with this Process Server. If the Process Server is fronted by an HTTP router, the address of the router is typically specified as the server host.
<server-port>	The port number that will be used by Process Center to communicate with this Process Server.
<environment-type>	The type of this Process Server. The types are development, test, staging, or production.

The Process Server information is specified as a set of elements in the <server> section of the 99Local.xml file for the Process Server. The Process Server administrator can configure the information that describes the Process Server by providing values in the 100Custom.xml file of the Process Server. Those values override the values in the 99Local.xml file. Note that in a clustered environment, all Process Server cluster members must supply the same values.

Procedure

To configure the server name and associated properties, follow these steps:

To see the current settings, open the 99Local.xml file and locate the server properties.

<properties>
   <server merge="mergeChildren">
      <server-name>server x</server-name>
      <server-description>a running process server</server-description>
      <server-host>host name</server-host>
      <server-port>9088</server-port>
      <environment-type>test</environment-type>
   </server>
</properties>

To make changes, copy and paste the needed lines under a <server> tag in the 100Custom.xml file and make the changes that you need, such as in the following example. Make your changes in the deployment manager or stand-alone profile. In a network deployment environment, the path is PROFILE_ROOT\config\cells\cell_name \clusters\cluster_name\server_type \config\100Custom.xml.

<properties>
   <server merge="mergeChildren">
      <server-name merge="replace">server z</server-name>
      <server-description merge="replace">a running process server</server-description>
      <server-host merge="replace">new host name</server-host>
      <server-port merge="replace">new port number</server-port>
      <environment-type merge="replace">staging</environment-type>
   </server>
</properties>

Save your changes and close both the 99Local.xml file and the 100Custom.xml file.
Complete a full node synchronization in a network deployment environment so that changes are propagated to the nodes. This step is not needed for a stand-alone profile.
Restart the Process Server.