Question & Answer
Question
How do you move the view storage location of an IBM® Rational® ClearCase® Web or IBM Rational ClearCaseRemote Client view?
Cause
You want to move from one web server to another or from one directory to another on the same web server on Microsoft® Windows®, UNIX®, or Linux®.
Answer
Notes:
These instructions do not pertain to the working view root location which resides on the client.
This information applies only for views of the same architecture. Not supported are:
- Windows to UNIX or Linux
- UNIX or Linux to Windows.
- Unregister the web view
cleartool unregister -view <view_storage>
Note: Do not include the hostname: in the view_storage path.
- Remove the web view tag
cleartool rmtag -view <view_tag>
- Stop ClearCase on the Web Server
UNIX and Linux:
/opt/rational/clearcase/etc/atria_start stop
Windows:
Stop ClearCase from the ClearCase control panel or from the command line. For command-line instructions, see the following technote.
Start and stop ClearCase from the Windows command line
- Move the view storage to the new location.
Note: Be sure to use copy utilities that preserve ACLs on Windows as you could run into permission problems later on (see results below).
- Restart ClearCase on the Web server
UNIX/Linux:
/opt/rational/clearcase/etc/atria_start start
Windows:
Stop ClearCase from the ClearCase control panel or from the command line. For command-line instructions, see the following technote.
Start and stop ClearCase from the Windows command line
- Register the web view in its new location
cleartool register -view <view_storage>
Note: Do not include the hostname: in the view_storage path.
- Make a new tag for the view
cleartool mktag -view -tag <tag> -ngpath <local_view_storage_path>
Note: Be sure to use the -ngpath switch in mktag when creating a web view as it is local to the server and does not use a global path.
Example performed on Windows (same for UNIX and Linux):
- LIST VIEW BEFORE
C:\>cleartool lsview
ccweb_view HOST1:C:\ccweb\user1\ccweb_view\view.stg
- UNREGISTER
C:\Program Files\Rational\ClearCase\var\ccweb\user1.HOST1>cleartool unregister -view C:\ccweb\user1\ccweb_view\view.stg
- RMTAG
C:\Program Files\Rational\ClearCase\var\ccweb\user1.HOST1>cleartool rmtag -view ccweb_view
- SHUT DOWN CLEARCASE SERVICES (
See Start and stop ClearCase from the Windows command line
C:\>NET STOP ALBD
The Atria Location Broker service is stopping.
The Atria Location Broker service was stopped successfully.
C:\>NET STOP LOCKMGR
The Rational Lock Manager service is stopping.
The Rational Lock Manager service was stopped successfully.
C:\>NET STOP CCCREDMGR
The Rational Cred Manager service is stopping.
The Rational Cred Manager service was stopped successfully.
- MOVE VIEW STORAGE
- START UP CLEARCASE SERVICES
C:\>NET START CCCREDMGR
The Rational Cred Manager service is starting.
The Rational Cred Manager service was started successfully.
C:\>NET START LOCKMGR
The Rational Lock Manager service is starting.
The Rational Lock Manager service was started successfully.
C:\>NET START ALBD
The Atria Location Broker service is starting.
The Atria Location Broker service was started successfully.
- REGISTER THE VIEW
[<code srctext="codesnippet">]
C:\Program Files\Rational\ClearCase\var\ccweb\user1.HOST1>cleartool register -view E:\views\HOST1\user1\ccweb_view\view.stg
Note: If you receive the following error when registering the view, the ACLs of the view storage have been changed and need to be re-protected with the fix_prot utility.
cleartool: Error: Failed to record hostname "HOST1" in storage directory "E:\views\HOST1\user1\ccweb_view\view.stg". Check that root or the ClearCase administrators group has permission to write to this directory.
cleartool: Error: Unable to add a registry entry for "E:\views\HOST1\user1\ccweb_view\view.stg": error detected by ClearCase subsystem
- FIX_PROT:
C:\Program Files\Rational\ClearCase\var\ccweb\user1.HOST1>fix_prot -r -root -chown user1 -chgrp clearuser E:\views\HOST1\user1\ccweb_view\view.stg
- Review About fix_prot for more information about how to run the fix_prot utility.
- MAKE A VIEW TAG
C:\Program Files\Rational\ClearCase\var\ccweb\user1.HOST1>cleartool mktag -view -tag ccweb_view -ngpath E:\views\HOST1\user1\ccweb_view\view.stg
- LIST THE VIEW
C:\>cleartool lsview
ccweb_view HOST1:E:\views\HOST1\user1\ccweb_view\view.stg
- TEST FROM THE CLIENT
Related Information
[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"ClearCase Remote Client","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.0;8.0.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"ClearCase Web (CCWeb)","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"ClearCase Web (CCWeb)","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"ClearCase Remote Client (CCRC)","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21150413