About this task
Archive conversion is optional in Rational Synergy 7.1. You can perform archive conversion any time after you upgrade your Rational Synergy database to Release 7.1.
Note: You must be a CM administrator to run an archive conversion.
To convert archived data:
Procedure
- Start the Rational Synergy Web Administration Interface.
- Open a browser.
- Type http://server:port/admin
where server:port is the server and port number on which the Rational Synergy Web Administration Interface resides, for example,
http://usir-sol2:8400/admin
To view the URL for CCM servers, use the ccm monitor command.
- 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 a button to start or stop conversions, or to remove databases that no longer need to be converted.
- Start archive conversion for a database by clicking the Start button. The button changes from Start to Stop, and the status changes to Initializing while the conversion program queries for objects that need to be converted. This initial query can take several minutes.
- You can stop archive conversion for a database at any time by clicking the Stop button. The button changes from Stop to Start. The next time you start conversion, it continues from where it left off.
- 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.
- If archive conversion fails to convert all archives, the status column shows an Error link. Errors during conversion require you to contact IBM 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 IBM Rational Synergy Support site.
- After the archive conversion has completed, the button changes to Remove. Click the Remove button 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 button changed to Start, the archive conversion is not complete. Check for errors as described in 6. Then, run the command ccm fs_check as described in Checking for file system archive errors.
- 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 want to run ccm clean_cache again to recover this space. In some cases, you might need to run ccm clean_cache repeatedly while the archive conversion is in progress, if you are short of disk space for the database cache.