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 all OpenPages application servers, including the deployment manager.  See Stopping application servers for details.
3. If your deployment includes a workflow server stop the IBM Business Process Manager node and application server, but start the deployment manager.

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 [app.dmgr] section with the new hostname of the deployment manager server, and save the file.

Update the Hostname on the Deployment Manager Server

Perform the following steps on the server hosting the OpenPages deployment manager:

1. Open the file <OP_HOME>/temp/perlinstall/install.properties in a text editor, where <OP_HOME> is the location of your OpenPages installation.  Update the following properties using the new deployment manager server hostname, and save the file.
   • OP_DMGR_HOST
   • OP_HOST
2. Open the file <OP_HOME>/temp/wasconfig/<CellName>.dmgr.config.props in a text editor, where <CellName> is the name of your OpenPages cell.  Update the property HOST using the new hostname, and save the file.
3. Run the sequence of commands 

   <WAS_HOME>/bin/wsadmin.sh|.bat -lang jython -conntype NONE
AdminTask.changeHostName('-hostName <NewHostName> -nodeName <DmgrNodeName>')
AdminConfig.save()
exit

   where <WAS_HOME> is the installation location of IBM WebSphere Application Server, <NewHostName> is the new hostname of the deployment manager, and <DmgrNodeName> is the name of the deployment manager node profile.

4. 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:

1. Open the file <OP_HOME>/temp/perlinstall/install.properties in a text editor, where <OP_HOME> is the location of your OpenPages installation.  Update the following properties using the new deployment manager server hostname, and save the file.
   • OP_DMGR_HOST
2. Open the file <OP_HOME>/temp/wasconfig/<CellName>.dmgr.config.props in a text editor, where <CellName> is the name of your OpenPages cell.  Update the property HOST using the new hostname, and save the file.
3. Open the file <OP_HOME>/installer/deploy.properties in a text editor.  Update the host property under the [app.dmgr] section with the new hostname of the deployment manager, and save the file.
4. 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.

5. Start the OpenPages node and application servers.  See Starting application servers for details.

Update the Hostname on the Workflow Server

If your deployment includes a workflow server, perform the following steps on your workflow server:

1. 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 opHostName using the new OpenPages deployment manager hostname, fill in the password properties, and save the file.
2. Run the integration script for OpenPages and IBM BPM.  See Running the integration script for details.