Installation Guide › JBoss Version › Installation on a JBoss Cluster › How to Install CA Identity Manager on a JBoss Cluster › Add Cluster Nodes

Add Cluster Nodes

To add cluster nodes

If you need to run additional nodes of JBoss on the same system, modify the port assignments of JBoss based on the vendor instructions. You will need to modify the JNDI names in the procedure to create the first cluster node, so that it uses the correct port number. Also, modify files from step 10 in the procedure to create the first cluster node; include the changed port number for this node.

Important! In a production environment, we recommend that a JBoss cluster use one computer per node, using the default JBoss ports.

The location of the new JBoss node is jboss_home_n. It may reside on the same system as the first node of the cluster or another system.

1. Copy the following files from jboss_home\bin to the additional cluster node location: jboss_home_n\bin:
   • workpoint_client.policy
   • run_idm.bat or run_idm.sh
   • run_idm.ico
2. Copy the following files from jboss_home\server\all\deploy-hasingleton\jms\ to jboss_home_n\server\all\deploy-hasingleton\jms:
   • jbossmq-destinations-service.xml
   • workflow-service.xml
3. For HTTP load balancing with sticky sessions:
   • Modify jboss_home_n/server/all/deploy/jboss-web.deployer/META-INF/jboss-service.xml to set the UseJK attribute to true.
   • Modify jboss_home\server\all\deploy\jboss-web.deployer\server.xml by adding the following to the <Engine> tag in this format:

     jvmRoute="worker1">
     

4. Copy login-config.xml from jboss_home\server\default\conf to jboss_home_n\server\all\conf.
5. Copy the following files from jboss_home\server\default\lib to jboss_home_n\server\all\lib:
   • sqljdbc.jar (MS-SQL)
   • ojdbc14.jar (Oracle)
6. Copy the following files of jboss_home\server\all\farm to jboss_home_n\server\all\farm:
   • castylesr5.1.1.ear
   • IdentityMinder.ear
7. To create a data source for a relational database User Store, place the data source file under all/farm on one cluster node.

   Note: For more details, see the Configuration Guide.

Important! If you are installing a JBoss cluster on an IPv6/IPv4 stack, modify the sample files on each system and replace jnp://localhost with jnp://host-name used in run_idm.bat or run_idm.sh. Modify all jboss.xml files.