Steps

Prerequisite Steps

1. Ensure that all servers in the OpenPages deployment can successfully connect to the new hostname.  See Configuring the hosts file for details.
2. Stop the IBM Business Process Manager node and server.
3. Stop all OpenPages nodes and application servers.  See Stopping application servers for details.
4. Make sure the OpenPages deployment manager is running.

Update the Hostname on the Installation Server

Perform the following steps on the installation server:

1. Open the file <OPInstallerHome>/src/deployment/<deployment_name>/deploy.properties in a text editor, where <OPInstallerHome> is the location of the installer files and <deployment_name> is the name of your deployment in the OpenPages Installer.

2. Update the host property under the [bpm] section with the new hostname of the workflow server, and save the file.

Update the Hostname on the Workflow Server

In place changes of the hostname in IBM Business Process Manager is not supported.  In order to change the hostname in IBM BPM, you must follow the steps for performing a migration.  See Migrating IBM BPM to the same version on new hardware for details.

Once IBM BPM has successfully been migrated to the new hostname, perform the following steps on your workflow server:

1. Start the IBM BPM deployment manager by running the command 

   <BPM_HOME>/profiles/<DmgrProfile>/bin/startManager.sh|.bat

   where <BPM_HOME> is the location of your IBM Business Process Manager installation, and <DmgrProfile> is the name of the deployment manager profile.

2. Open the file <OP_BPM_INTEGRATION_HOME>/installBPMIntegrationConfig.sh|.cmd in a text editor, where <OP_BPM_INTEGRATION_HOME> is the directory containing the integration files for OpenPages and IBM BPM.  Update the property hostName using the new workflow server hostname, fill in the password properties, and save the file.
3. Run the integration script for OpenPages and IBM BPM.  See Running the integration script for details.

Update the Hostname on the Deployment Manager Server

Perform the following steps on the server hosting the OpenPages deployment manager after running the integration between OpenPages and IBM BPM:

1. Start the deployment manager by running the command 

   <DMGRProfileHome>/bin/startManager.sh|.bat

   where <DMGRProfileHome> is the directory containing the deployment manager profile.

Update the Hostname on Each Application Server

Perform the following steps on each application server in your deployment after running the integration between OpenPages and IBM BPM:

1. Open the file <OP_HOME>/installer/deploy.properties in a text editor.  Update the host property under the [bpm] section with the new workflow server hostname, and save the file.
2. Sync the application node by running the command 

   <OP_HOME>/profiles/<NodeName>/bin/syncNode.sh|.bat <DmgrHost> <DmgrSoapPort>

   where <NodeName> is the name of the OpenPages node on the application server, <DmgrHost> is the hostname of the deployment manager, and <DmgrSoapPort> is the SOAP port number of the deployment manager.

3. Follow the steps under Additional Information for updating the IBM BPM application URL.