Copying utilities

Use the ccm_copy_tools command to copy utilities from a Rational® Synergy 7.0, 7.1, or 7.1a installation directory to the Rational Synergy 7.2 installation directory. You can also use this command to save the utilities from a previous release, or to apply previously saved utilities into a Rational Synergy Release 7.2 installation.

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

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

Command syntax

When you run the following command, 6.5 tools are copied directly from the old Rational Synergy installation directory to the new one:

ccm_copy_tools old_install_dir new_install_dir

You see an error in the following cases:

The old_install_directory might reference an existing Rational Synergy version directory that was previously updated with 6.5 tools. So, it is possible to copy tools from one 7.2 installation to another, or from a previous installation to a 7.2 installation.

ccm_copy_tools -o output_file old_install_dir

This form of the command copies 6.5 tools from an existing Rational Synergy 7.0, 7.1, or 7.1a installation to a saved file for later installation elsewhere. This information is useful when the previous and new Rational 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, 7.1, or 7.1a 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, 7.1, or 7.1a.

The default is to copy files needed for all purposes. In all modes, you can also use the following options:

Option Description
-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.

Updating CLI preferences

If you want to use the Rational Synergy 6.5 compare and merge tools, you must update your CLI preferences in addition to copying the tools to your installation directory. For example, to use ccm_dff to compare objects on Windows, modify the following line in the ccm.properties file:
ccm.cli.tools.compare.ascii.windows=%ccm_home\\\\bin\\\\util\\\\ccm_dff -o %outfile %file1 %file2

Feedback