To update snapshot views

About this task

To make sure that your snapshot view contains the set of versions that the config spec selects, you must update it. You can also update chosen directories and files.

Tip: You cannot update a checked-out file. To undo changes to a checked-out file and start over with the version in the VOB, cancel the checkout.

You can update a snapshot view from the command line, from DevOps ClearCase® Explorer, from Windows Explorer, or from Visual Studio.

To update a snapshot view, complete one of the following options:
  • From the command line, use the following command with the path of the snapshot view root directory:
    
    cleartool update -graphical path 
    
    Tip: Alternatively, you can navigate to the snapshot view root directory and enter the following command without the path: cleartool update -graphical
    The Update Tool starts. You can click Advanced and change default options for the Update Tool. If you need to resolve hijacked files, select a method. You have these choices:
    • Leave hijacked files in place
    • Rename the hijacked files and load the selected version from the VOB
    • Delete hijacked files and load the selected version from the VOB
    You can also select a method for handling timestamps. You have these choices:
    • Set file times to current time
    • Set file times to version creation time
    You can also choose to do a preview without actually performing the update. When the preview completes, the window displays a categorized list of actions to be taken to update the view, and you can then perform the update.
  • From ClearCase Explorer, do the following:
    1. Click Toolbox > Base ClearCase. Then click Update View. The Start Update window opens.
    2. In Which view do you want to update?, select the root directory of the snapshot view to be updated. Use the drop-down list or click Browse to navigate to the snapshot view root directory.
    3. In the Start Update window, you can do the following:
      • Select the Preview only check box and do a preview without actually performing the update. When the preview completes, you can perform the update.
      • Click the Advanced tab and change default options for the Update Tool. If you need to resolve hijacked files, select a method. You have these choices:
        • Leave hijacked files in place
        • Rename the hijacked files and load the selected version from the VOB
        • Delete hijacked files and load the selected version from the VOB
        You can also select a method for handling timestamps. You have these choices:
        • Set file times to current time
        • Set file times to version creation time
    4. Click OK.

      The update procedure begins and a progress indicator is displayed. When the update is complete, the Snapshot View Update window displays a categorized list of the actions taken to update the view.

    Windows tip: In ClearCase Explorer, to start the update automatically without opening the Start Update window, right-click the root directory of the view and click Update View.
  • From Windows Explorer, do the following:
    1. Right-click the root directory of the snapshot view and click ClearCase > Update View.
    2. In the Start Update window, you can do the following:
      • Select the Preview only check box and do a preview without actually performing the update. When the preview completes, you can perform the update.
      • Click the Advanced tab and change default options for the Update Tool. If you need to resolve hijacked files, select a method. You have these choices:
        • Leave hijacked files in place
        • Rename the hijacked files and load the selected version from the VOB
        • Delete hijacked files and load the selected version from the VOB
        You can also select a method for handling timestamps. You have these choices:
        • Set file times to current time
        • Set file times to version creation time
    3. Click OK.

      The update procedure begins and a progress indicator is displayed. When the update is complete, the Snapshot View Update window displays a categorized list of the actions taken to update the view.

  • From Visual Studio, from the ClearCase Add-In toolbar, click Update View.