VDDB(8) —

NAME

vddb − Remote Virtual Disk (RVD) data base manager

SYNOPSIS

vddb [ −d ] [ −n ] [ database ]

DESCRIPTION

Vddb is the data base management tool used to maintain RVD layout and allocation on the physical media used by the server. Options are:

−d Turn on debugging. A trace of the control packets sent and received is displayed.

−n No connection to server. This is used to modify the data base locally, so that changes are deferred until the server is next started.

database
Specifies an alternate file to use instead of /etc/rvd/rvddb. The tail component (what is to the right of the last “/”) of the path database will be taken as the server name. An example would be /etc/rvd/db/jinx. This file should be identical to the copy on the target server (here jinx). To ensure this, copy the file remotely (see rcp(1)) to the server host it defines after vddb exits.

COMMANDS

When executed, vddb enters a command loop. The available commands are:

add physicaladd and configure a new physical disk
add virtualsame, but a virtual disk
delete virtualdelete a virtual disk
exchange virtualswap the names of two virtual disks
help [
command
]show help on
command
listlist the contents of
database
list physicalsame, but specific to a physical disk
list virtualsame, but specific to a virtual disk
modify virtualmodify an existing virtual disk
quitexit the data base program

Parts of commands may be abbreviated.

Each operation will prompt for required information. The operations will be confirmed with “Are you sure (y or n) ?” before the action is executed.

Add physical requires two parameters: the raw character device to use, and the number of 512 byte blocks contained in the device. The number of blocks can usually be found in /etc/disktab (see disktab(5)). The raw device should be specified in full, e.g. /dev/hd1c for the c partition of hd1.

Add virtual requires 10 parameters: the virtual pack name (a string), a pack unique id (a number), the owner (a brief description of the pack), the passwords for read-only, exclusive and shared mode, the size in 512-byte blocks, the allowable modes, which is a logical OR of 1 (read-only), 2 (shared), and 4 (exclusive), the owning host name (the owning host may spin up the disk without ever giving a password), and the desired physical disk name (see “Add physical”). The response will indicate if the addition was successful.

Delete virtual prompts for one parameter: the name of the virtual disk name to delete. The pack must be spun down.

Modify virtual prompts for the fields filled in at the time the virtual disk was created; all except the password fields default to their current values.

Quit will exit the program.

Help will describe the syntax and semantics of a command, or list all commands if none is specified.

DIAGNOSTICS

Unauthorized operation generally indicates an incorrect password. Other messages are intended to be self-explanatory.

FILES

/etc/rvd/rvddbdata base of current disk layout

Museum

Related Articles