Getting started: Server and database administrators

Rational® Synergy clients connect to a Web server using HTTP. This topic discussed administrative information.

CCM server

The CCM server manages back-end Rational Synergy sessions on the server system.

User authentication

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.

Changing Rational Directory Server passwords

Users can change their Rational Directory Server password on the CCM server website:

http://server:port/user

Scripting with Rational Synergy

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.

Database terminology

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 location

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.

Default text editor

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.

Opening command windows for Windows

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:

  1. Access the Windows task bar.
  2. From the Windows Start menu, go to Start > All Programs > IBM Rational > IBM Rational Tools > IBM Rational Synergy 7.2 > CM Command Prompt.

    If you are running a GUI session, you can start a CLI session from the main menu: Tools > Start Synergy CLI

Universal naming convention for Windows

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.


Feedback