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
- Access the Web Administrator User interface:
- Open a browser.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Rerun the ccm fs_check to verify that
the conversion did not cause any errors.
- Click the Logout link to the right
of the tabs to exit the Web Administrator User interface.