Converting archived data

Archive conversion is required in Rational® Synergy 7.2. Releases later than 7.2 are not going to support the old archivers. You can perform archive conversion any time after you upgrade your Rational Synergy database to Release 7.2. You can also perform archive conversion before upgrading to 7.2 if you have Fixpack 7.1.0.2 installed.

About this task

You must be a CM administrator to run an archive conversion.

Procedure

  1. Start the Rational Synergy web administration interface.
    1. Open a browser.
    2. Type http://server:port/admin

      where server:port is the server and port number on which the Rational Synergy web administration interface is located, for example, http://usir-sol2:8400/admin

      To view the URL for CCM servers, use the ccm monitor command.

  2. In the Rational Synergy web administration interface, click the Archive Conversion tab.

    You see a list of databases that need converting and the status of each archive conversion. The far right column contains an icon to start or stop conversions, or to remove databases that no longer require converting.

  3. Start archive conversion for a database by clicking Start. The icon changes from Start to Stop, and the status changes to Initializing while the conversion program queries for objects that must be converted. This initial query can take several minutes.
  4. You can stop archive conversion for a database at any time by clicking Stop. The icon changes from Stop to Start. The next time you start conversion, it continues from where it left off.
  5. When the archive conversion is running, you must manually refresh the browser to view updated information, such as the total number of objects to be converted, the number remaining, and the percentage complete.
  6. If archive conversion fails to convert all archives, the status column shows an Error link. Errors during conversion require you to contact Rational Synergy Support. Click the Error link to add information to the page, such as the number of errors, a list of the objects that failed to be converted, and a link to the Rational Synergy Support site.
  7. After the archive conversion has completed, the icon changes to Remove. Click Remove to remove the row for this database from the archive conversion tab of the Rational Synergy web administration interface.

    If the database is not removed, but persists with the icon changed to Start, the archive conversion is not complete. Check for errors as described in 6.

  8. Exit the Rational Synergy web administration interface at any time by clicking the Logout link to the right of the tabs.

Results

If you have previously run ccm clean_cache on a database, archive conversion extracts the previously deleted cache files from the old archives in preparation for archiving them with the new archiver. As a result, the database might occupy more disk space. After archive conversion is completed, you might run ccm clean_cache again to recover this space. In some cases, you might run ccm clean_cache repeatedly while the archive conversion is in progress, if you are short of disk space for the database cache.


Feedback