IBM Support

How to move the view storage location of a web view

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.



  1. Unregister the web view
    cleartool unregister -view <view_storage>

    Note: Do not include the hostname: in the view_storage path.

  2. Remove the web view tag
    cleartool rmtag -view <view_tag>

  3. 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

  4. 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).

  5. 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

  6. Register the web view in its new location

    cleartool register -view <view_storage>

    Note: Do not include the hostname: in the view_storage path.

  7. 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

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU004","label":"Hybrid Cloud"},"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":""},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU004","label":"Hybrid Cloud"},"Component":"ClearCase Web (CCWeb)","Platform":[{"code":"","label":""}],"Version":"","Edition":""},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU004","label":"Hybrid Cloud"},"Component":"ClearCase Web (CCWeb)","Platform":[{"code":"","label":""}],"Version":"","Edition":""},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU004","label":"Hybrid Cloud"},"Component":"ClearCase Remote Client (CCRC)","Platform":[{"code":"","label":""}],"Version":"","Edition":""}]

Document Information

Modified date:
16 June 2018

UID

swg21150413