Follow the guidelines presented here when installing Rational® Synergy on a computer running Informix®
About this task
When you install Rational Synergy on a computer running Informix, you must use the following guidelines to avoid potential problems. Use these guidelines regardless of the software versions Informix supports, and whether Informix is running for earlier releases of Rational Synergy or for vendor software:
- When running Rational Synergy, ensure that no one sets the ONCONFIG, INFORMIXDIR, and INFORMIXSERVER environment variables. This rule applies for regular users such as user joe, user john, and so on) and administrative users (that is, users ccm_root, informix, and root). Setting these variables can cause commands to be run on the wrong servers.
- User informix and group informix can be shared among multiple installations of Informix; you do not need to change any user or group settings.
- Ensure that each server name, on a given computer, is unique. If the Rational Synergy Informix server does not use the default server name, use the -s option and appropriate servername whenever you use the ccmsrv and ccmdb commands.
- Verify that the SERVERNUM configuration parameter is unique among all Informix database servers on the same computer. IfSERVERNUM is not unique on the computer, the servers interfere with each other.
- Ensure that the SERVERNUM configuration parameter for all Informix database servers has a value from 1 to 255, inclusive. (The valid numbers are from 0 to 255; 0 is the default. Do not use 0 because 0 does not permit multiple servers to coexist.)
Procedure
Perform the following steps to check the server number for a database server:
- Set user to informix.
$ su - informix
- Set the environment variables.
$ CCM_HOME=ccm_home; export CCM_HOME
$ PATH=$CCM_HOME/bin:$PATH; export PATH
- Edit a file in the $INFORMIXDIR/etc directory (for Rational Synergy, this directory is $CCM_HOME/informix/etc). The file name is the same as the server name in Rational Synergy, but might be different if it was not created by Rational Synergy. A typical name is onconfig. Search this file for SERVERNUM to see its value.