Customizing the Process Server settings used to connect to Process Center

After you install and configure IBM® Business Process Manager, you can use the wsadmin command to change the Process Server settings that are used for connecting to the Process Center.

Before you begin

Restriction: The BPMAuthor role must point to the same user in both the Process Center and the Process Server, and must have the same password.

About this task

Use the following procedure to customize the Process Server connection settings:

For example, you can complete the following tasks:

Update the host and port name of the Process Center connection details.
Change Process Server from an offline server to a Process Center connected server (online server), and vice versa.
Change the Process Center connection URL.

Procedure

To customize the settings that are used by Process Server to connect to a Process Center, complete the following steps.

Note: For network deployment Process Server environments, complete the following steps on the deployment manager node, synchronize the nodes, and restart the application cluster member.

Stop the Process Server environment. In a network deployment environment, stop the deployment manager and the nodes.
Complete the following steps to update the server settings with the WebSphere command-line administration tool (wsadmin) AdminConfig commands.
1. Start the wsadmin scripting tool. To start wsadmin using the Jython language, run the following command from the bin directory of the server profile:
```
wsadmin -conntype NONE -lang jython
```
2. Get the process server configuration of the application cluster.
  - on a clustered environment, enter the following command:
```
wsadmin> ps = AdminConfig.getid("/Cell:/ServerCluster:application_cluster_name/BPMClusterConfigExtension:/BPMProcessServer:/")
```
  - for a stand-alone server, enter the following command:
```
wsadmin> ps = AdminConfig.getid("/Cell:/Node:node_name/Server:server_name/BPMServerConfigExtension:/BPMProcessServer:/")
```
3. Update the processCenterUrl variable.
```
wsadmin> AdminConfig.modify(ps, [['processCenterUrl', 'https://new_server_name/ProcessCenter’]])
```
4. If you are using IBM BPM V8.5.0.1, update the processCenterInternalUrl variable, which is the same as ProcessCenterUrl but with the literal string Internal appended at the end for the context root.
```
wsadmin> AdminConfig.modify(ps, [['processCenterInternalUrl', 'https://new_server_name/ProcessCenterInternal’]])
```
5. To change the state of an offline Process Server to online, update the heartBeatInterval value to a number that is larger than 0 (zero). The heartbeat interval is the polling interval, in seconds, that is used by the Process Server to communicate its location and characteristics to the Process Center. For example, to set the value to 60 seconds, enter the following command:
```
wsadmin> AdminConfig.modify(ps, [['heartBeatInterval', '60']])
```
  To bring the server offline, disable polling by setting the heartBeatInterval value to a negative number:
```
wsadmin> AdminConfig.modify(ps, [['heartBeatInterval', '-1']])
```
  -1 is the special value to use for an offline server.
6. Verify your updates.
```
wsadmin> print AdminConfig.show(ps)
```
7. Save the changes and exit.
```
wsadmin> AdminConfig.save()
wsadmin> exit
```
Review the Business Process Manager security roles by navigating in the WebSphere Application Server administrative console to Servers > Deployment Environments > Deployment Environment Name > Related Items > Authentication Aliases. See IBM Business Process Manager security roles.
Note the authentication alias for the ProcessCenterUser and BPMAuthor roles.
If it does not exist, create the ProcessCenterUserAlias. See Modifying authentication aliases. For ProcessCenterUserAlias, use a valid user name and password from the Process Center environment. The user does not need any special authorization in Process Center.
Optional: If you plan to use a user other than DeAdmin (the default) to deploy snapshots from Process Center to the runtime Process Server, create a new BPMAuthorAlias. For BPMAuthorAlias, use a valid user name and password from the Process Server environment that has the authority to access and deploy snapshots to the runtime Process Server. This user is saved in the LSW_SERVER table in the Process Center database and used when the process application is deployed to this Process Server.
In the Business Process Manager security roles screen, map the ProcessCenterUser role to ProcessCenterUserAlias and the appropriate alias to the BPMAuthor role.

Verify your updates.

wsadmin> print AdminConfig.show(ps)

The output looks something like this example:

...
[heartBeatInterval 60]
...
[processCenterUrl https://hostname:9082/ProcessCenter]

Save the changes and exit.

wsadmin> AdminConfig.save()
wsadmin> exit

If you are using IBM BPM V8.5.0.1, you must verify that the Process Server root signer SSL certificate is imported into Process Center because Process Center connects to Process Server by HTTPS by default. If you configure the processCenterUrl variable or the processCenterInternalUrl variable to use HTTPS, then you also must verify that the Process Center root signer certificated is imported in Process Server. Follow the steps in Configuring Secure Sockets Layer (SSL) communication in a network deployment environment.
Tip: If you want to change the Process Center to connect to Process Server by HTTP, complete the following steps. Then you do not need to import the Process Center root signer certificates into Process Server. Note that this change reverts back to the 8500 behavior of calculating unencrypted URLs for many scenarios, not only online deployment.
1. Stop the Process Center environment. In a network deployment environment, stop the deployment manager and the nodes.
2. Update the following server settings with the wsadmin AdminConfig commands.
  1. Start the wsadmin scripting tool. To start wsadmin using the Jython language, run the following command from the bin directory of the deployment manager profile:
```
wsadmin -conntype NONE -lang jython
```
  2. Get the Process Center configuration of the application cluster:
```
wsadmin> pc = AdminConfig.getid("/Cell:/ServerCluster:application_cluster_name/BPMClusterConfigExtension:/BPMProcessCenter:/")
```
  3. Update the useHTTPSURLPrefixes variable:
```
wsadmin> AdminConfig.modify(pc, [['useHTTPSURLPrefixes', 'false’]])
```
  4. Verify your updates:
```
wsadmin> print AdminConfig.show(pc)
```
  5. Save the changes and exit:
```
wsadmin> AdminConfig.save()
wsadmin> exit
```
3. Stop the Process Server environment. In a network deployment environment, stop the deployment manager and the nodes.
4. Update the following server settings with the wsadmin AdminConfig commands.
  1. Start the wsadmin scripting tool. To start wsadmin using the Jython language, run the following command from the bin directory of the deployment manager profile:
```
wsadmin -conntype NONE -lang jython
```
  2. Get the Process Server configuration of the application cluster:
```
wsadmin> pc = AdminConfig.getid("/Cell:/ServerCluster:application_cluster_name/BPMClusterConfigExtension:/BPMProcessServer:/")
```
  3. Update the useHTTPSURLPrefixes variable:
```
wsadmin> AdminConfig.modify(pc, [['useHTTPSURLPrefixes', 'false’]])
```
  4. Verify your updates:
```
wsadmin> print AdminConfig.show(pc)
```
  5. Save the changes and exit:
```
wsadmin> AdminConfig.save()
wsadmin> exit
```
Restart the Process Server cluster or server. For network deployment Process Server environments, synchronize the nodes and restart the application cluster member.

Results

The settings that are used to connect Process Server to Process Center are customized and the same changes are to the custom nodes.