admfailovergiveaway(1M) DG/UX R4.11MU05 admfailovergiveaway(1M)
NAME
admfailovergiveaway - manage failover giveaway database
SYNOPSIS
admfailovergiveaway -o delete -h hostname -l local-diskname [ fs-
source ]
admfailovergiveaway -o modify -h hostname -l local-diskname [ -r new-
remote-diskname ] [ -n new-fs-source ] [ -m mount-
directory ] [ -p fstab-options ] [ -d dump-freq ] [ -t
fs-type ] [ -k fsck-passno ] [ -eu ] [ -P export-
options ] fs-source
admfailovergiveaway -o list [ -qv ]
DESCRIPTION
admfailovergiveaway provides operations for manipulating entries in
the failover(4M) giveaway database. The entries in this database are
descriptions of all virtual disks and file systems pertaining to
physical disks registered on this host, that have been setup for
failover using the admfailoverdisk command. The information is used
to take a physical disk off-line on one host and bring it on-line on
another host. The important feature of this database is that the
entries pertain to physical disks that are currently registered on
this host.
From this information file systems can be checked, added, mounted,
and exported. Virtual disks are made available when the physical disk
is registered on the new host.
The operations provided in the admfailovergiveaway command are for
updating the giveaway database when information pertaining to a
physical disk already set up for failover has changed.
Operations
delete Delete specified giveaway entry, or all giveaway entries for
the specified hostname and local-diskname. You can delete a
specific giveaway entry by specifying the fs-source argument
of the virtual disk whose entries will be deleted. You can
also delete all entries for a specific physical disk by only
specifying the hostname physical diskname pair. The delete
operation will change the sync state of the failover
database. The admfailoverdisk command should then be used to
re-sync the failover databases of those hosts affected by the
delete operation.
modify Modify the specified giveaway entry. When changing a virtual
disk entry that did not contain a file system to add
information about a file system, all file system options (-m,
-p, -d, -t, -k) must be specified. Additionally, -e and -P
may be specified to export the file system. The modify
operation will change the sync state of the failover
database. The admfailoverdisk command should then be used to
re-sync the failover databases of those hosts affected by the
modify operation.
list List information about giveaway entries in the failover
database. The list operation reports the following failover
database information to stdout:
the name of the host that physical disks can be failed over
to/from
the name of the physical disk as it appears on the current host
the name of the physical disk as it appears on the remote host
the name of the virtual disk
the mount point directory of a file system
the file system type
the mount options for the file system
the dump frequency for the file system
the fsck pass number for the file system
the file system id for NFS takeover
Y if the file system is exportable, N if it is not, or
doesn't exist
export options if file system is exportable
With the "verbose" format (-v), information is printed in
aligned columns with column headers. With the "quiet" format
(-q), headers are suppressed and each giveaway entry is
printed on a separate line. If both -q and -v are specified,
the output will be in "quiet" format.
Options
The following options must be used with the delete and modify
operations:
-h hostname
The name of the host to which the physical disk can be
given. This must be a valid hostname and already exist in
the failover hosts database.
-l local-diskname
The name of the physical disk as it appears on this host,
in DG/UX common format. For example, da(hada(),6).
The following options can be used with the modify operation:
-r remote-diskname
The name of the physical disk as it appears on the remote
host, in DG/UX common format. For example, da(hada(),6).
-n new-fs-source
The new name of the virtual disk.
-m mount-point
A valid mount-point corresponding to the fstab entry for
this virtual disk if a file system is present on this
virtual disk.
-p fstab-options
A valid fstab-options corresponding to the fstab entry for
this virtual disk if a file system is present on this
virtual disk.
-d dump-freq
A valid dump-freq corresponding to the fstab entry for this
virtual disk if a file system is present on this virtual
disk.
-t fs-type
A valid fs-type corresponding to the fstab entry for this
virtual disk if a file system is present on this virtual
disk.
-k fsck-passno
A valid fsck-passno corresponding to the fstab entry for
this virtual disk if a file system is present on this
virtual disk.
-e This option will allow the file system to be exported when
the physical disk is failed over.
-u This option will prevent the file system from being
exported when the physical disk is failed over.
-P export-options
This option will set the export options for the file system
when the physical disk is failed over.
Options for the list operation
-q Quiet. Produce an unformatted listing with no headers,
fields delimited by a single space.
-v Verbose. Produce a formatted listing with headers and
aligned columns. This option is enabled by default.
EXAMPLE
For this example, assume that on host machineA you wish to delete all
entries for host machineB and local diskname "da(hada(),8)". You
would delete the giveaway entries by using
admfailovergiveaway -o delete -h machineB -l "da(hada(),8)"
FILES
/etc/failover failover database files
DIAGNOSTICS
Errors
- An attempt was made to add a giveaway entry.
- An attempt was made to delete or modify a giveaway entry that
does not exists.
- An attempt was made to modify an entry without all of the
correct file system information.
Exit Codes
0 The operation was successful.
1 The operation was unsuccessful.
2 The operation failed due to access restrictions.
3 There was an error in the command line.
SEE ALSO
sysadm(1M), failoverd(1M), admfailoverapplication(1M),
admfailoverhosts(1M), admfailovertakeaway(1M), failover(4M),
appropriate_privilege(5).
cap_defaults(5).
NOTES
You must have appropriate privilege to perform all operations except
list. For systems supporting the DG/UX Capability Option,
appropriate privilege is defined as having one or more specific
capabilities enabled in the effective capability set of the user.
See cap_defaults(5) for the default capabilities for this command.
On systems without the DG/UX Capability Option, appropriate privilege
means that your process has an effective UID of root. See the
appropriate_privilege(5) man page for more information.
After deleting or modifying giveaway entries using the
admfailovergiveaway command, you should use the admfailoverdisk
command to synchronize the changes with the specific hosts.
Licensed material--property of copyright holder(s)