Getting started: Server and database administrators

The following picture shows the Rational Synergy client and server architecture:

Rational Synergy clients connect to a Rational Synergy Web server using HTTP. The Rational Synergy server manages a pool of back-end sessions, which all run on the server system.

CCM server

The CCM server manages back-end Rational Synergy sessions on the server system. This section provides information about configuring and administering the CCM server.

User authentication

Rational Synergy users are authenticated using the IBM® Rational® Directory Server (RDS). Rational Synergy can share a single RDS lightweight directory access protocol (LDAP) installation with IBM® Rational® Change and other software tools. RDS 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 RDS, the CM administrator must add user IDs and their associated roles to each Rational Synergy database in which they will work, to identify which databases they can access and the privileges they have in each databases.

Changing Rational Directory Server passwords

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

http://server:port/user.

http://server:port/user.

Scripting with Rational Synergy

The command line interface is referred to as Rational Synergy CLI.

The Rational Synergy CLI provides equivalent commands for most functions available in the Rational Synergy GUI. Most administration commands are not supported in the Rational Synergy CLI yet, including those described in this Information Center.

You will need to port your existing scripts written for the Classic CLI to the Rational Synergy CLI.

Database terminology

The term Rational Synergy database is used throughout this Information Center.

Rational Synergy database is used to refer to the configuration management schema and meta-data that can be stored in a database, as well as the corresponding source file data that is 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 administer Rational Synergy databases, but not to administer Oracle or INFORMIX databases. Oracle or INFORMIX databases must be created and administered manually. Users should refer to the Oracle or INFORMIX database product documentation for administration.

CCM_HOME location

CCM_HOME is the Rational Synergy product 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 would need to change the directory to CCM_HOME\etc.

$CCM_HOME is the Rational Synergy product installation directory. Many procedures shown in this guide 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 Rational Synergy default text editor. If you change text editors, substitute the appropriate command. See Rational Synergy Help for instructions on changing your text editor.

The default Rational Synergy UNIX text editor is vi. You can change the default text editor (described in "Default Settings" in Rational Synergy CLI Help).

Opening command windows for Windows

When running administrative commands, you can use the Rational Synergy command prompt instead of typing the full path to your Rational Synergy installation area (CCM_HOME). This starts 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. Select Start > All Programs > IBM Rational > IBM Rational Tools > IBM Rational Synergy 7.1 > CM Command Prompt.

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 as follows:

\\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