Copying utilities

About this task

Use the ccm_copy_tools command to copy utilities from a Synergy 6.5 or 7.0 installation directory to the Rational Synergy 7.1 installation directory. Or, you can use it to save the utilities from a previous release, or apply previously saved utilities into a Rational Synergy Release 7.1 installation.

This command must be run as user ccm_root because it must be able to write to your Rational Synergy 7.1 installation directory.

Note: The client uses ObjectMake and diff/merge tools. As a result, you must update each client installation using ccm_copy_tools, as well as the server installation. The client installation only needs the ObjectMake and diff/merge tools (ccm_copy_tools -m and -d). However, it is harmless to copy the archive tools to the client installations as well.

The following section describes the command syntax.

ccm_copy_tools old_installation_dir new_installation_dir

In this form of the command, 6.5 tools are copied directly from the old Synergy installation directory to the new one.

You see an error in the following cases:

It is legal for the old_install_directory to refer to an existing Rational Synergy 7.0 or 7.1 directory that was previously updated with 6.5 tools. So, it is possible to copy tools from one 7.1 installation to another, or from a 7.0 installation to a 7.1 installation, and so on.

ccm_copy_tools -o output_file old_install_dir

This form of the command copies 6.5 tools from an existing Rational Synergy 6.5, 7.0, or 7.1 installation to a saved file for later installation elsewhere. This information is useful when the previous and new Synergy installations are not visible to each other. The direct copying performed in the previous form of the command cannot be used.

ccm_copy_tools -i input_file [new_install_dir]

This form of the command copies 6.5 tools from a saved file into an existing Rational Synergy 7.0 or 7.1 installation. The saved file must have been produced by an earlier use of the ccm_copy_tools -o command. You see an error if the new installation directory is not from Rational Synergy 7.0 or 7.1.

In all modes, you can also use the following options:

-a Copy the tools used for archiving.

-m Copy the files used for ObjectMake.

-d Copy the tools used for diff and merge.

-v Show the path to each file as it is copied.

The default is to copy files needed for all purposes.


Feedback