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
Note: You must be a CM administrator to
run an archive conversion.
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 is located, 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 must be converted
and the status of each archive conversion. The far right column contains
an icon to start or stop conversions, or to remove databases that
do not require converting.
- 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.
- 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.
- 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 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.
- 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. 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 be required to run ccm clean_cache repeatedly
while the archive conversion is in progress, if you are short of disk
space for the database cache.