Converting archived data

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

Before you begin

See:

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

Procedure

  1. Access the Web Administrator User interface:
    1. Open a browser.
    2. Type http://HostName:ccm_server_port_number/admin

      where HostName:ccm_server_port_number is the server and port number on which the Rational Synergy web administration interface is located. Example: http://hawk:8890/admin

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

  2. In the Archive Conversion tab, click Start to start the conversion.

    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.

    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.

  3. In the Status section, monitor the conversion process.

    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.

    You can stop archive conversion for a database at any time by clicking Stop. The icon changes from Stop to Start. When you click Start, the process continues from where it left off.

  4. Monitor the process for errors that are reported during the conversion.

    If archive conversion fails to convert all archives, the status column shows an Error link. Errors during conversion require that you contact IBM® Rational 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 Support site.

  5. When the conversion is successfully completed, in the Web Administrator User interface, click Remove to remove the database from the Archive Conversion tab.

    The Remove button displays after the successful completion of the archive conversion. If the database is still listed on the Archive Conversion tab after you click Remove, it is removed after you run the ccm clean_cache and ccm fs_check commands.

  6. Run the ccm clean_cache to clean up the disk space.

    > ccm clean_cache -c “+1:0:0:0” –u –v

    Each file that is converted is extracted to the cache if the file is not there.

    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 the archive conversion is completed, rerun the ccm clean_cache command to recover this space. In some cases, you might run ccm clean_cache repeatedly while the archive conversion is in progress, if the database cache is short of disk space.

  7. Rerun the ccm fs_check to verify that the conversion did not cause any errors.
  8. Click the Logout link to the right of the tabs to exit the Web Administrator User interface.

Feedback