Chapter 9. Summing Up / Cleaning Up

We hope that you have gotten the “feel” of using ClearCase. Numerically, you have used only a small fraction of the product's commands and features. But these are the commands that you will use most often in your day-to-day development work. Before cleaning up, take a few moments to review what you have accomplished.

Get your bearings

At the end of the preceding lesson, you were in the src directory, in a shell set to view USER_HOST_tut. Verify that you are still in the same situation.

% cleartool pwv -short
USER_HOST_tut
% pwd
VOBTAG/src

If you've gotten lost, you may need to use a full pathname to find the source directory.

cd VOBTAG/src

If this command fails, it is probably because you exited the shell that was set to your view. Here's how to reestablish your view context, and then go to the right source directory in the VOB.

cleartool setview USER_HOST_tut
cd VOBTAG/src

Verify that all binaries are accessible in the `bin' directory

The bin directory contains all three releases of the hello program. Each is checked-in as a version of element ../bin/hello. Let's execute all the versions, just to see how far the project has progressed.

% cd ../bin
% hello@@/main/REL1
Hello, world!
% hello@@/main/REL2
Hello, USER!
Your home directory is /net/HOST/home/USER.
It is now DATESTRING
.
% hello@@/main/REL3
Hello, USER!
Your home directory is /home/USER.
It is now DATESTRING.


Note: The remaining steps guide you through a cleanup process that returns your machine to its state when you began this tutorial. If you wish to work further with the data and views you've created, you can stop right here.


Exit the view

There is no further use for the views you've created, so you can delete them. First, however, exit your shell process, which is set to the USER_HOST_tut view.

% exit
% cleartool pwv -short
** NONE **
% pwd
HOME

You are now back where you started, in a shell that is not set to any view.

Unmount the VOB

Unmount the VOB that you have used in this tutorial, and remove the mount-over directory.

% cleartool umount VOBTAG
% rmdir VOBTAG

Delete all the views you've created

The REL1REL2 script you executed at the start of this tutorial created a view with view-tag USER_HOST_old. You created two additional views, USER_HOST_tut and USER_HOST_fix. Use rmview (“remove view”) commands to delete the storage areas of these views and to remove their view-tag and view storage entries in the ClearCase registry files.

% cleartool rmview -force -tag USER_HOST_tut
% cleartool rmview -force -tag USER_HOST_old
% cleartool rmview -force -tag USER_HOST_fix

The -force option suppresses error conditions related to the fact that a VOB associated with a view still holds derived objects created in that view.

Remove the VOB storage area

Having unmounted the VOB, you can delete its storage area (which you created back at Step 5 in HOME/tut or /usr/tmp/USER/tut).

% cleartool rmvob HOME/tut/tut.vbs

Remove versioned object base "HOME/tut/tut.vbs"?  [no] yes
Removed versioned object base "HOME/tut/tut.vbs".

Confirmation is required for this step, unless you use the -force option.

Remove the directory that contained all the storage areas

The tut directory is now empty, since the three view storage areas and the VOB storage area are all gone. You can now remove this empty directory.

% rmdir tut

That completes the cleanup!

Say good-bye!

This concludes the ClearCase Tutorial. We hope that you have enjoyed the trip, and have gotten a good idea of how ClearCase can help you get your work done more easily and more reliably.