init_ccase

Startup and shutdown script

Applicability

Product

Command type

VersionVault

command

Platform

UNIX®

Linux®

Synopsis

Linux

service versionvault { start | stop }

or

systemctl { start | stop } versionvault

Solaris

/etc/init.d/versionvault { start | stop }

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.

VersionVault 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) 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-VersionVault hosts; the list of VOBs to be exported is read from the VersionVault file /etc/exports.mvfs.

Startup retry loop

The startup script resides outside the host's VersionVault installation area. It calls on another script, which resides inside the installation area, to do the actual startup processing. If this other script, versionvault-home-dir/etc/versionvault, cannot be accessed, the startup script enters a retry loop. (This can occur when the VersionVault 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 versionvault-home-dir/etc/versionvault.The retries continue indefinitely; if you want to terminate the loop, remove the flag file /tmp/VersionVault.retrying.

Shutdown

When invoked with the argument stop, the script shuts down VersionVault as follows:

  • Unexports any view/VOB combinations that were exported through /etc/exports.mvfs to enable non-VersionVault access
  • (On Solaris) 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) Unloads the MVFS from the operating system kernel
  • Unmounts the viewroot directory