Rational ClearCase Commands Referenceannotate
apropos
catcr
catcs
cc.icon
cc.magic
cd
chactivity
chbl
checkin
checkout
checkvob
chevent
chflevel
chfolder
chmaster
chpool
chproject
chstream
chtype
chview
clearaudit
clearbug
cleardescribe
cleardiffbl
cleardiff
clearexport_ccase
clearexport_cvs
clearexport_pvcs
clearexport_rcs
clearexport_sccs
clearexport_ssafe
clearfsimport
cleargetlog
clearhistory
clearimport
clearjoinproj
clearlicense
clearmake
clearmake.options
clearmrgman
clearprojexp
clearprompt
cleartool
clearviewupdate
clearvobadmin
comments
config_ccase
config_spec
cptype
credmap
creds
deliver
describe
diffbl
diffcr
diff
dospace
edcs
endview
env_ccase
events_ccase
export_mvfs
exports_ccase
file
find
findmerge
fmt_ccase
getcache
get
getlog
help
hostinfo
init_ccase
ln
lock
lsactivity
lsbl
lscheckout
lsclients
lscomp
lsdo
lsfolder
lshistory
ls
lslock
lsmaster
lspool
lsprivate
lsproject
lsregion
lsreplica
lssite
lsstgloc
lsstream
lstype
lsview
lsvob
lsvtree
makefile_aix
makefile_ccase
makefile_gnu
makefile_pmake
makefile_smake
makefile_sun
man
merge
mkactivity
mkattr
mkattype
mkbl
mkbranch
mkbrtype
mkcomp
mkdir
mkelem
mkeltype
mkfolder
mkhlink
mkhltype
mklabel
mklbtype
mkpool
mkproject
mkregion
mkstgloc
mkstream
mktag
mktrigger
mktrtype
mkview
mkvob
mount_ccase
mount
msdostext_mode
mvfslog
mvfsstorage
mvfstime
mvfsversion
mv
omake
pathnames_ccase
permissions
profile_ccase
promote_server
protect
protectvob
pwd
pwv
query_language
quit
rebase
recoverview
reformatview
reformatvob
register
relocate
rename
reqmaster
reserve
rgy_backup
rgy_check
rgy_passwd
rgy_switchover
rmactivity
rmattr
rmbl
rmbranch
rmcomp
rmdo
rmelem
rmfolder
rmhlink
rmlabel
rmmerge
rmname
rmpool
rmproject
rmregion
rmstgloc
rmstream
rmtag
rmtrigger
rmtype
rmver
rmview
rmvob
schedule
schemes
scrubber
setactivity
setcache
setcs
setplevel
setsite
setview
shell
snapshot.conf
softbench_ccase
space
startview
type_manager
umount
uncheckout
unlock
unregister
unreserve
update
version_selector
view_scrubber
vob_restore
vob_scrubber
vob_sidwalk
vob_snapshot
vob_snapshot_setup
wildcards_ccase
winkin
xclearcase
xcleardiff
xmldiffmrg
DESCRIPTION
The shell script listed in the Synopsis section is invoked at system startup and shutdown. It can also be executed as a shell command.
CLEARCASE AND CLEARCASE LT STARTUP
When invoked with the argument start (or without an argument), the script performs initialization as follows:
- Starts the Location Broker Daemon, albd_server.
- Starts the database lock manager process, lockmgr.
- (On Solaris, AIX 4, Digital UNIX, UnixWare) Dynamically loads the MVFS (multiversion file system) into the operating system kernel.
- Initializes the viewroot directory (default name /view).
- Mounts public VOBs listed in storage registry. If the network is partitioned into multiple network regions, only the VOBs that have public VOB-tags in the local host's region are mounted.
- Exports VOBs through particular views to enable access by non-ClearCase hosts; the list of VOBs to be exported is read from the ClearCase file /etc/exports.mvfs (all platforms except Digital UNIX) or /etc/exports (Digital UNIX).
Startup Retry Loop
The startup script resides outside the host's ClearCase or ClearCase LT installation area. It calls on another script, which resides inside the installation area, to do the actual startup processing. If this other script, ccase-home-dir /etc/clearcase, cannot be accessed, the startup script enters a retry loop. (This can occur when the ClearCase or ClearCase LT installation area is located on a remote host and that host is currently unavailable.)
In its retry loop, the startup script tries periodically to invoke ccase-home-dir/etc/clearcase.The retries continue indefinitely; if you want to terminate the loop, remove the flag file /tmp/ClearCase.retrying.
The Viewroot Mount Command
The startup script runs a standard mount command to mount the viewroot directory as a file system of type MVFS. This mount command is architecture specific:
You can change the extending naming symbol by appending a string to the argument that follows the –o option:
This specifies a character string to be used on the local host as the ClearCase extended naming symbol. By default, the string @@ is used. Be careful: this option affects the local host only; other hosts may use the default extended-naming symbol or another symbol specified with this mount option.
You can specify a directory other than /view as the viewroot. Whatever directory you specify (for example, /ccasevu) must exist at system startup time. Note that you must specify this directory name twice in the mount command.
Mounting the viewroot directory enables use of ClearCase views on the local host. When a view is activated (by startview, setview, or mktag), its view tag is entered into the viewroot directory. For example, activating a view whose view tag is gamma creates the directory entry /view/gamma. See the pathnames_ccase reference page for a discussion of view-extended pathnames that use such directory entries.
A mounted viewroot directory is not actually an on-disk directory. Rather, it is a data structure maintained in main memory by the MVFS code loaded into the operating system kernel. The viewroot directory's list of view tags is lost whenever ClearCase operation on the local host is stopped (including an operating system shutdown).
The viewroot directory cannot be exported and cannot be mounted by any other host. Each ClearCase host must have its own viewroot directory.
SHUTDOWN
When invoked with the argument stop, the script shuts down ClearCase or ClearCase LT as follows:
- Unexports any view/VOB combinations that were exported through /etc/exports.mvfs to enable non-ClearCase access
- (On Solaris, Digital UNIX, Reliant UNIX) Kills all user processes that are using the MVFS (multiversion file system)
- Unmounts all VOBs
- Kills the vob_server processes for VOBs whose storage directories are on the local host
- Kills the albd_server process, which also causes view_server, db_server, and vobrpc_server processes to exit
- Kills the lockmgr process
- (On Solaris, AIX 4, Digital UNIX, UnixWare) Unloads the MVFS from the operating system kernel
- Unmounts the viewroot directory