The CCM server manages back-end Rational Synergy sessions on the server system.
Rational Synergy users are authenticated using the IBM® Rational Directory Server. Rational Synergy can share a single Rational Directory Server lightweight directory access protocol (LDAP) installation with IBM Rational Change and other software tools. Rational Directory Server is installed and administered separately from Rational Synergy. For more information, see the IBM Rational Directory Server Administration Guide and the IBM Rational Directory Server Install Guide on the Rational Software Information Center at http://publib.boulder.ibm.com/infocenter/rsdp/v1r0m0/index.jsp.
In addition to defining users in Rational Directory Server, the CM administrator must add user IDs and their associated roles to each database in which they work. These settings identify which databases administrators can access and the privileges they have in each databases.
Users can change their Rational Directory Server password on the CCM server website:
http://server:port/user
The command line interface is called the CLI.
The CLI provides equivalent commands for most functions available in the GUI.
You must port your scripts written for the Classic CLI to the Rational Synergy CLI. See Migrating from the Classic CLI to the Synergy CLI technical note for more information.
The term Rational Synergy database and the database are used throughout this information center.
Both terms refer to the configuration management schema and metadata stored in a database, and to the corresponding source file data stored in the file system.
Oracle database refers to the actual Oracle database.
Informix database refers to the actual INFORMIX database.
Utilities are provided to create and administer Rational Synergy databases. Rational Synergy bundles IBM INFORMIX by default. When using the INFORMIX version, Rational Synergy automatically creates an underlying INFORMIX database when creating a Rational Synergy database. Users who use Oracle rather than INFORMIX must create and administer the Oracle database separately. Oracle users can read the Oracle database product documentation for administration details.
CCM_HOME is the Rational Synergy product Windows installation directory. Many procedures in this information center require that you change a file somewhere in the CCM_HOME directory hierarchy. For example, to edit the remexec.cfg file, which resides in the etc directory in the Rational Synergy installation area, you must change the directory to CCM_HOME\etc.
$CCM_HOME is the Rational Synergy product UNIX installation directory. Many procedures shown in this information center require that you change a file somewhere in the $CCM_HOME directory hierarchy.
Instructions for editing text files are given using Notepad, the default text editor. If you change text editors, substitute the appropriate command.
The default Rational Synergy UNIX text editor is vi. You can change the default text editor, if necessary.
When running administrative commands, use the Rational Synergy command prompt instead of typing the full path to your Rational Synergy installation area (CCM_HOME). You can start a command prompt window with the environment properly set for Rational Synergy command use.
To open a command window for Windows:
If you are running a GUI session, you can start a CLI session from the main menu:
You can use the universal naming convention (UNC) any time you type a path to an administrative command. UNC makes network access to files, machines, and other devices easier, so you can reference remote machines and files.
The UNC format is:
\\computer_name\share_name\path
In the following example, "c:\users\ccmdb\base" is a regular database path. A UNC-style path is "\\loon\ccmdb\tstgonzo":
> ccmdb copy c:\users\ccmdb\base \\loon\ccmdb\tstgonzo
Most Rational Synergy commands accept both UNC paths and paths with drive letters. However, three commands, ccmdb create, ccmdb copy, and ccmdb unpack, require UNC paths to create databases.