How to install a second (multiple) instance of the Implementation Toolset on Unix or Linux.

Products

• Gen
• Gen - Workstation Toolset
• Gen - Host Encyclopedia
• Gen - Run Time Distributed

Issue/Introduction

Situations occur where a second instance of the Implementation Toolset is needed on Unix or Linux.  Perhaps users need both a Gen r8.0 instance and a Gen r8.5 instance, or users may need multiple instances of the same release level containing different configurations.  If users installed the first instance using the default instance name, two methods exist to add a second instance.

 

Environment

Release: KGNDDL99000-8.5-Gen-DBP Developer License
Component:

Resolution

1.  Uninstall the first instance containing the default instance name and reinstall each instance specifying a unique instance name for each at install time. Use the -I parameter documented in Gen r8.5, CA Gen Distributed Systems Install Guide as follows: "./setup -I <instance_name>" to make the instances unique.

2.  A work-around exists to allow users to install a second instance of the IT without uninstalling the first instance. The work-around renames the existing instance from the default name to something unique, allowing users to add a second Gen r8.0 or r8.5 instance.  Here are the instructions to rename the existing instance from the default name to a unique name. In this example, it uses Gen r8.0 as the existing instance, this method applies to Gen r8.5 as well.

As root user, perform the following tasks:

1.  cd to:  /opt/CA/install/administration/admi
2.  ls to list the set of products that have been install using CA’s PIF tool. 
   - You should see a CAGen directory.  This represents an installation using the default  instance name.
   - If you see other CAGen.* directories, these represent other installations that used  the –I instance flag when installing.
3.  Rename this directory to give it a unique instance name, such as CAGen.80:
   - mv CAGen CAGen.80
4.  cd to newly renamed CAGen.80
5.  cd to next directory (this should be the actual installed build number)
6.  Rename the prm file to match the newly named directory:
   - mv CAGen.@prm CAGen.80.@prm
7.  Edit CAGen.80.@prm and make 2 changes:
   - Change #phead: CAGen , to #phead: CAGen.80 ,
   - Add #instancename: 80; after #multiinst
8.  Perform lsm –l |grep CAGen to verify that installed CA Gen instances show this instance name as CAGen.80, and that instance name CAGen is no longer found.

At this point the user should be able to install a second instance of Gen r8.0 or r8.5, using the –I instance name flag mentioned above.