Distributing cache files for UNIX

You can distribute the Rational® Synergy storage root directories anywhere across local file systems of networks using NFS. The most common and useful method for distributing the directories is to move the cache subdirectory to a separate file system. You move the cache directory and set up a symbolic link. You must copy all files under the cache directory to a subdirectory readable and writable by userccm_root. Verify that this directory exists. If it does not exist, create it.
For Informix

Before you begin

If you did not set up CCM_HOME and PATH for user ccm_root during installation, set these environment variables now.

Procedure

  1. Ensure that there are no users on the database.
  2. Set user to ccm_root.
    $ su - ccm_root
    Password: *****
  3. Shut down the database.

    $ ccmdb shutdown database_path

  4. Pack the database.

    $ ccmdb pack database_path

  5. Change directory to st_root.

    $ cd database_path/st_root

  6. Copy all files.

    Copy all files under the cache directory to a subdirectory readable and writable by user ccm_root. In the following command, this directory is called new_cache. (If a directory readable and writable by user ccm_root does not exist, you must create one.)

    $ find cache -print | cpio -pdma /extra/new_cache

  7. Remove the cache subdirectory.

    $ rm -rf cache

  8. Create a link to the new cache subdirectory.

    $ ln -s /extra/new_cache/cache cache

  9. After the files are copied (see 6), all cache files are owned by ccm_root. To make Rational Synergy update working files so that they have the correct ownership, delete the file that lists the users whose ownerships have already been updated.

    $ rm -f database_path/db/file_acs_update_list

  10. Exit from user ccm_root.

    This procedure physically relocates the entire cache subdirectory.

    Attention: Alternatively, you can move any or all subdirectories under st_root (for example, workarea, archive) to separate locations. You also can relocate the individual hashed subdirectories of the cache. For example, each of the cache/source/#nn directories can be a link to a different location.

    For OracleThe ccmdb pack and ccmdb backup commands for Oracle databases do not follow symbolic links. So, do not back up cache or archive files moved using the technique described in this procedure. You must use an alternative backup process for Oracle databases where you have distributed the cache or archive across file systems. See Database dump method and Database backup.

    If you need assistance, contact IBM® Rational Software Support.


Feedback