Copying utilities

Use the ccm_copy_tools command to copy utilities from a previous 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 apply previously saved utilities into a Rational Synergy Release 7.2 installation.

This command must be run as user ccm_root in order to write to your Rational Synergy 7.2 installation directory.

Command syntax

When you run the following command, 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:
  • Either of the two installation directories does not exist.
  • The two installation directories are the same.
  • The old installation directory is not from Rational Synergy 6.5 or later.
  • The new installation directory is not from Rational Synergy 7.2, 7.0, 7.1, or 7.1a.

The old_install_directory might reference an existing Rational Synergy 7.0, 7.1, or 7.1a 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 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.
-d Copy the tools used for diff and merge.
-m Copy the files used for ObjectMake.
-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 UNIX, modify the following line in the ccm.properties file:
ccm.cli.tools.compare.ascii.unix=%ccm_home/bin/util/ccm_dff -o %outfile %file1 %file2

Feedback