Phil for Humanity Phil for Humanity
A Guide for the Survival of Humankind and Helping the World, Society, and Yourself.



ClearCase Support: How to Create a View in ClearCase


This command to create a new View is relatively straight forward.

cleartool mkview –tag VIEW_NAME -host VIEW_SERVER_NAME
        -hpath VIEW_PATH -gpath VIEW_PATH VIEW PATH

There are only 3 arguments that need to be filled out.

First, the VIEW_NAME argument must be a unique View name. You can run this command to verify that another View does not already have this View name.

cleartool lsview | grep VIEW_NAME


If the View name is already in use, then you will just get an error message.

Second, the VIEW_SERVER_NAME argument must be the name of one of your View servers. You must have at least one View server. This View server must already be configured as a View server ahead of time.

Third, the VIEW_PATH argument is the View’s storage directory. This path is the most tricky argument to determine. First, you may have several View storage directories on different View servers, but a single View must reside on a single View storage directory. You can load balance all Views on different View servers and/or different View storage directories if performance or disk space is an issue. Second, you need to make sure the View storage directory is writable by all users and used by all users. Third, the View storage directory must be a shared directory that all computers and users can access. Finally, there must always have plenty of disk space available for View growth. A new View is under a megabyte in size, however compiling code or generating source code can result with gigabytes of data in the Views in a very short period of time.

Otherwise, if your ClearCase Adminstrators have already defined a single default View's storage directory or View path, then you can use this command instead.

cleartool mkview –tag VIEW_NAME -stgloc -auto

This command is a lot shorter and removes the possibility of users making mistakes.

by Phil for Humanity
on 20080327

Related Articles
 » ClearCase Support: How to Delete a View in ClearCase
 » ClearCase Support: How to Make a ClearCase Branch
 » ClearCase Support: How to Make a ClearCase Label