IBM Enterprise Records, Version 5.1.2   

Installing IBM Enterprise Records in a high availability environment

You can install IBM® Enterprise Records in a IBM FileNet® P8 high availability environment.

Procedure

To install IBM Enterprise Records in a high availability environment:

  1. Install IBM Enterprise Records on each node of the application server cluster.
    • If IBM Enterprise Records is to be installed on an existing Application Engine or Workplace XT cluster, the site preferences object in the Content Platform Engine object store must be checked out with IBM Administration Console for Content Platform Engine to verify the correct URL for Application Engine or Workplace XT. The XML element <setting key="workplaceBaseURL"> must be set to the URL of the load-balancer or proxy server in the Application Engine or Workplace XT farm. If the <workplaceBaseURL> element is not set, check out the XML document, correct the setting, and check it back in.
    • In the "Installing IBM Enterprise Records software" task you are required to specify the server name of Content Platform Engine. If Content Platform Engine is clustered, specify the cluster host name or IP address of the service group that the API Listener belongs to. This information ensures all IBM Enterprise Records cluster nodes can connect to the active node of the Content Platform Engine cluster.
    • This task also requires the path to the bootstrap.properties file. Select the location that was created to host the Application Engine or Workplace XT configuration data here (likely a Windows shared server or NFS export location).
      Restriction: Do not install IBM Enterprise Records nodes with different bootstrap.properties files.
  2. Run IBM Enterprise Records Configuration Manager to configure and deploy IBM Enterprise Records and Application Engine or Workplace XT. Run an instance of the Configuration Manager on a single node. Then deploy it to all the other nodes of the application server cluster by changing the server or node you are targeting.
    • If the configuration files, for example Actions.xml, for IBM Enterprise Records are shared among all the nodes, specify a shared directory in Configure Web Application task for the Web Deployment profile. By using a shared directory, perform the configuration steps (run the Configure Web Application task) on a single node. Then deploy the web applications to every node in the group in the HA environment.
    • If the configuration files are not shared, run the Configure Web Application task on each node in the HA environment.
      Important: When you change one of the configuration files, you might see inconsistent behavior. This behavior is because the change is not made to all of the files. You can create a shared folder for the configuration file to keep the user interface consistent across all nodes.
    • For JBoss Application Server, configure and deploy the software on every server node.
  3. Deploy IBM Enterprise Records by using the following table:
    Server Instructions

    WebSphere® Application Server

    In the Web application deployment profile settings for IBM WebSphere Application Server, change the application server host, SOAP port, and cell to the correct values for your application server. In the settings for the Deploy Web Application task, select the appropriate server node where IBM Enterprise Records Configuration Manager is deploying.

    Deploy the IBM Enterprise Records web application on theIBM WebSphere Application Server 6.x or 7.x, after you create the cluster and load balancer instances by using the administrative console. By using these steps, you can deploy IBM Enterprise Records on the cluster and proxy server instances.

    WebLogic Server

    In the Web application deployment profile settings for WebLogic Server, change the application server host and SOAP port to the correct application server. Select the appropriate target name where IBM Enterprise Records Configuration Manager is deploying.

    Deploy the WebLogic Server 9.x, or 10.x, after you create the WebLogic domain, administration server and cluster. Use these steps to deploy IBM Enterprise Records on the cluster.

    JBoss Application Server

    On the JBoss Application Server you configure and deploy the IBM Enterprise Records web application in a group of independent application server instances.

    In this configuration, because you do not have a central administration server, every server acts as a separate server instance. Every server must be configured separately.

  4. Run the RMAccessRole tool on the IBM Enterprise Records server node.

    Set up the Classified Records Security Personnel Access Role for highly available IBM Enterprise Records by running the RMAccessRole tool on only one IBM Enterprise Records installation in the environment.

    Follow the instructions in the “Adding marking sets and add-ons to the FileNet P8 domain“ or “(DoD Classified only) Creating the classified records security personnel access role” task.

  5. If a load-balancer or proxy server is used in this configuration, use this URL for the remaining IBM Enterprise Records installation steps that require an application URL.

    If the application is deployed to a group of application servers, and a load-balancer is configured for this group, a URL for Application Engine might be http://proxy_url:proxyport/Workplace.

    An example of the IBM Enterprise Records URL is: http://proxy_url:proxyport/EnterpriseRecords. Use this URL when you complete the installation steps for IBM Enterprise Records.

    Important:
    • Perform the Transfer Workflow Definitions task from the command prompt by running the Transfer Workflows task. Run this task on one node per HA environment only, and not on every node in the group.
    • Perform configuration steps that use the Process Task Manager (to make configuration changes to the Component Manager) or the IBM Enterprise Records Sweep applications. Perform these steps on each node in the group of application servers.


Feedback

Last updated: November 2013
frmic127.htm

© Copyright IBM Corporation 2013