Creates a server storage location for views or VOBs.
Product | Command Type |
---|---|
ClearCase | cleartool subcommand |
ClearCase LT | cleartool subcommand |
Platform |
---|
UNIX |
Windows |
ClearCase:
ClearCase LT:
The mkstgloc command creates and registers a named server storage location for view or VOB storage directories. The command initializes a physical directory and writes information describing that directory to the ClearCase or ClearCase LT registry. For information on the registry, see the Administrator's Guide.
You can also use mkstgloc for other purposes:
Adopting an existing directory as a server storage location. An existing directory is adopted if stgloc-pname specifies that directory.
(ClearCase) Registering an existing server storage location in a new region. A server storage location is registered in a new region if stgloc-pname specifies an existing server storage location. Specify new arguments for options such as -region and -host as appropriate for the region in which you are registering the server storage location.
Refer to the mkview and mkvob reference pages for information on the default selection of server storage locations in view and VOB creation.
Before creating a server storage location for a ClearCase view or VOB, determine whether there is file system connectivity between the server storage location's host and its clients in the regions that advertise the server storage location. File system connectivity determines how you can use the server storage location, as follows:
Server storage location use | File system connectivity |
---|---|
Dynamic views | Required (a global path to the server storage location must exist) |
VOB to be accessed through dynamic views | Required (a global path to the server storage location must exist) |
Snapshot views | Not required |
VOB to be accessed only through snapshot views | Not required |
To be accessible to its clients, a ClearCase server storage location needs to be registered with the following information:
The name of the host where the server storage location resides.
A host-local pathname to the server storage location.
For dynamic views or VOBs accessed through dynamic views, a global pathname to the server storage location relative to the host's network region.
The network region in which the host resides.
In many cases, ClearCase heuristically derives appropriate accessibility information from the stgloc-pname argument. In cases where there is no file-system connectivity between the server storage location and its clients, ClearCase derives the host name and host-local path, but because no meaningful global path can be derived, you must specify -ngpath to unset the global path information.
An unusual network configuration may defeat the heuristic by which accessibility information is derived, thereby preventing access to the server storage location by some or all ClearCase clients. In such cases, set the registry information explicitly, following these guidelines:
To create a server storage location for dynamic views or for VOBs intended to be accessed through dynamic views, use the option set, -host -hpath -gpath.
To create a server storage location for snapshot views or for VOBs intended to be accessed only through snapshot views, use these options:
-host -hpath -gpath when there is file-system connectivity between the server storage location host and its clients.
-ngpath -host -hpath when there is no file-system connectivity between the server storage location host and its clients.
To create a server storage location on a supported network attached storage (NAS) device, you must specify the option set, -host -hpath -gpath. (NAS devices must be specially configured for use with ClearCase. See the Administrator's Guide for more information.)
For ClearCase LT, issues related to file system connectivity and client accessibility to server storage locations are not as complex as they can be for ClearCase. ClearCase LT assumes there is no file system connectivity such as that provided by NFS, so there are no command options or arguments related to the presence or absence of file system connectivity.
All server storage locations reside at the ClearCase LT server host. ClearCase LT clients learn the name of that host at client-install time. In rare cases, the host chosen to serve as the ClearCase LT server host is known by different names through different network interfaces. However, ClearCase LT requires that the ClearCase LT server host be known to all its clients by the same host name. Therefore, you must set up the host's network configuration to ensure that a single host name maps to different network addresses that are appropriate for the various client hosts of the server. See the Administrator's Guide for more information.
SPECIFYING THE OBJECT TYPE FOR WHICH A SERVER STORAGE LOCATION IS TOBE CREATED. Default: None.
CONFIRMATION STEP. Default: Prompts for confirmation that the server storage location is to be created as specified only if you are adopting an existing directory (see Other Uses for mkstgloc).
SPECIFYING A NETWORK REGION. Default: The host's network region.
SPECIFYING NETWORK ACCESSIBILITY. Default: A host name, host-local path, and global path are derived from the specified stgloc-pname.
SPECIFYING A NAME AND PATH FOR THE SERVER STORAGE LOCATION. Default: None.
The UNIX examples in this section are written for use in csh. If you use another shell, you may need to use different quoting and escaping conventions.
The Windows examples that include wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you may need to change the wildcards and quoting to make your command interpreter process the command appropriately.
In cleartool single-command mode, cmd-context represents the UNIX shell or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.
Create a server storage location for VOBs that dynamic views can access, allowing mkstgloc to derive client accessibility information from the specified server storage location pathname.
cmd-context mkstgloc -vob stgloc_vob1 ~/stgloc_vob1
Created and advertised Server Storage Location.
Host-local path: peroxide:/export/home/bert/stgloc_vob1
Global path: /net/peroxide/export/home/bert/stgloc_vob1
Create a server storage location for dynamic views, allowing mkstgloc to derive client accessibility information from the specified server storage location pathname.
cmd-context mkstgloc -view stgloc_view1 ~/stgloc_view1
Created and advertised Server Storage Location.
Host-local path: peroxide:/export/home/bert/stgloc_view1
Global path: /net/peroxide/export/home/bert/stgloc_view1
Create a server storage location for a VOB that only snapshot views will access.
cmd-context mkstgloc -vob -ngpath store1 C:\store1
Created and advertised Server Storage Location.
Host-local path: peroxide: C:\store1
Global path: <no-gpath>
Create a server storage location for VOBs on a NAS device. The VOB server will run on ClearCase host ccvobsvr1
cmd-context mkstgloc -vob -host ccvobsvr1 -gpath \\nasdevice\vobstg\nasvobstg \
-hpath \\nasdevice\vobstg\nasvobstg ccnasvobstg \\nasdevice\vobstg\nasvobstg
Created and advertised Server Storage Location.
Host-local path: ccvobsvr1:\\nasdevice\vobstg\nasvobstg
Global path: \\nasdevice\vobstg\nasvobstg
lsstgloc, mkview, mkvob, rmstgloc, Administrator's Guide
Feedback on the documentation in this site? We welcome any comments!
Copyright © 2001 by Rational Software Corporation. All rights reserved. |