Upgrade Guide › JBoss Version › Upgrade on a JBoss Cluster › How to Migrate CA Identity Manager on a JBoss Cluster › Create the Master Node

Create the Master Node

You begin creating the JBoss cluster by creating the master node, the first node in the cluster.

Note: On Windows, IPv6 is not supported for a JBoss cluster with the current release of the JDK. Each node must be an IPv4 system or part of an IPv4/IPv6 stack.

To create the master node

1. Install JBoss and the JDK on the computer.
2. Start the Identity Manager installation program.
   • Windows: From your installation media, run the following program:

     ca-im-release-win32.exe
     

   • UNIX: From your installation media, run the installation program. For example, for Solaris:

     ca-im-release-sol.bin
     

   release represents the current release of CA Identity Manager.

   Important! Make sure that you have the collected the information needed by the installer, such as user names, host names, and ports.

   Be sure to provide the existing CA Identity Manager database credentials during the install and that all values from the previous release of CA Identity Manager are replaced with r12.5 SP8 values. If you are upgrading from CA Identity Manager r12 and you have different database stores for task persistence, workflow, audit, and reports, you will need to update the data sources manually after installation to point to the separate stores.

   Note: If you see options to upgrade the workflow database and migrate task persistence data during the installation, enable those options. They appear in some situations when your previous installation was CA Identity Manager r12.

3. Complete the Select Components section by including the Identity Manager Server and any other components that you need on this system.

   

4. Complete the other sections based on your requirements for the installation.
5. When you enter any password or shared secret in the installation, be sure to provide a password that you can recall when needed.

   

6. Complete the JBoss Application Server Information page as follows:
   1. Enter the Access Server URL and port with the URL and port number of the web server used for load balancing.
   2. Select Cluster Installation.
   3. Enter a Peer ID, a unique number between 0 and 255. Make a record of the Peer ID, so that you use a different number for other nodes.

   

7. If the multicast address test failed, perform one of the next two steps for Windows or Solaris.
8. On a Windows system, edit run.bat in the jboss_home\bin directory:
   1. Locate the line that begins as follows:

      ARGS="${ARGS}
      

   2. Add a multicast address preceded by the -u argument as follows:

      ARGS="${ARGS} -g IdmPartition -Djboss.messaging.ServerPeerID=PeerID -u multicast-address"
      

   3. If you are installing on a system that supports IPv6/IPv4, uncomment the IDM_OPTS entry:

      set IDM_OPTS=%IDM_OPTS% -Djava.net.preferIPv4Stack=true
      

9. For a Solaris system, edit run.sh in the jboss_home\bin directory:
   1. Locate the line that begins as follows:

      ARGS="${ARGS}
      

   2. Add a multicast address preceded by the -u argument as follows:

      ARGS="${ARGS} -g IdmPartition -Djboss.messaging.ServerPeerID=PeerID -u multicast-address"
      

   3. If you are installing on a system that supports IPv6, modify one of the following properties in the IDM_OPTS entry:
      • For IPv6 only systems, uncomment the following entry:

        	IDM_OPTS="$IDM_OPTS -Djava.net.preferIPv6Addresses=true"
        

      • For IPv6/IPv4 systems, uncomment the following entry:

        	IDM_OPTS="$IDM_OPTS -Djava.net.preferIPv4Stack=true"
        

If any issues occur during installation, inspect the installation logs.