UP(1) —

NAME

up, down − client Remote Virtual Disk (RVD) utilities

SYNOPSIS

up [ −adfrtxv ] [ −Rn ] [ −Tn ] [ name ... ] [ −p passwd ]
up [ −ftv ] [ −Rn ] [ −Tn ] −c pack driveno server mode mount-directory [ passwd ]
down [ −adrtxv ] [ name ... ]

DESCRIPTION

The up utility spins up and mounts RVD packs; the down utility unmounts and spins them down.

By default, up spins up and mounts packs based on information stored in the /etc/rvd/rvdtab file. You can also use up to spin up and mount packs that are not specified in /etc/rvd/rvdtab. See the −c option described below.

When up spins up a pack in exclusive mode, the utility automatically checks the pack’s file system with the Unix file system checker fsck. Up will skip this file system check if you use the −f option described below.

The options to up are as follows:

−a Up tries to spin up every pack specified in /etc/rvd/rvdtab.

−c Lets you specify an arbitrary rvdtab-style line to up. This is useful for spinning up and mounting a “one-time” pack that is not specified in /etc/rvd/rvdtab. Note that all fields must be specified, except the password field which you will want to specify only if you are using up in a shell script. If you are using up as a command to the shell, don’t specify the password on the command line. up will prompt you for it after you enter the command.

−d Up tries to spin up every default pack specified in /etc/rvd/rvdtab. Default packs are marked by either a ∗ or %.

−f Up skips the file system check on all selected packs spunup in exclusive mode ( −x). Normally, all packs spunup in exclusive mode are checked and a failure results in the pack being not mounted and spundown.

−t Up processes the selected packs, then produces a listing of the approximate state of the client RVD system.

−r,−x Up spins up all selected packs in the given mode, overriding the default mode specified in /etc/rvd/rvdtab. The /etc/rvd/rvdtab entry must “allow” the given mode in order to be selected. Any number of these can be specified, but only the last one specified takes effect.

−v Verbose mode. Up displays a status message after processing each pack.

−R# Retry count, where # specifies the number of times up will retry a pack that fails to spin up the first time. Those entries marked with a ∗ will be retried if a failure occurred and some other pack was not spunup on the drive. If you use the −R option without providing a specific #, up will retry the pack an infinite number of times. If you provide a numerical argument, up will try to process the pack that number of times before giving up.

−T# Time interval for retries, where # specifies the number of seconds between retry attempts. If you do not provide a specific #, up will retry the pack every 60 seconds.

The name arguments refer to pack names found in /etc/rvd/rvdtab. The pack name may be of the form “host:pack” where either “host:” or “pack” may be null. Up selects those entries in /etc/rvd/rvdtab that match as much of the pack name as specified.

If the pack you want to spin up requires a password, you will be prompted to supply it. For those of you who write shell scripts that use the up command, the −p option lets you specify pack passwords in command lines. Use it as follows:

up packname -p passwd

where packname specifies the rvd pack, and password specifies the pack’s passwd.

The options to down are as follows:

−a Down tries to process every pack specified in /etc/rvd/rvdtab.

−d Down tries to process every default pack specified in /etc/rvd/rvdtab.

−t Down processes the selected packs, then produces a listing of the approximate state of the client RVD system.

−r,−x Only one of these can be specified (as for up above).

The remaining arguments are pack names (as for up above).

DIAGNOSTICS

Intended to be self-explanatory.

Each server involved in an invocation of up is queried (by rvdgetm(8)) for an “RVD message of the day” (of sorts). These are displayed as each RVD server host is contacted to spinup a disk.

FILES

/etc/rvd/rvdtabRVD client data base

Museum