admfailovertakeaway(1M) DG/UX R4.11MU05 admfailovertakeaway(1M)
NAME
admfailovertakeaway - manage failover takeaway database
SYNOPSIS
admfailovertakeaway -o delete -h hostname -l local-diskname [ fs-
source ]
admfailovertakeaway -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
admfailovertakeaway -o list [ -qv ]
DESCRIPTION
admfailovertakeaway provides operations for manipulating entries in
the failover(4M) takeaway database. The entries in this database are
descriptions of all virtual disks and file systems pertaining to
physical disks registered on another 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 not 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 admfailovertakeaway command are for
updating the takeaway database when information pertaining to a
physical disk already set up for failover has changed. These
operations are provided for use in the event a primary system crash
occurred before the databases could be synced.
Operations
delete Delete specified takeaway entry, or all takeaway entries for
the specified hostname and local-diskname. You can delete a
specific takeaway 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 not change the sync state of the failover
database.
modify Modify the specified takeaway 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 not change the sync state of the failover
database.
list List information about takeaway 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 takeaway 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
taken. 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 takeaway entries by using
admfailovertakeaway -o delete -h machineB -l "da(hada(),8)"
FILES
/etc/failover failover database files
DIAGNOSTICS
Errors
- An attempt was made to add a takeaway entry.
- An attempt was made to delete or modify a takeaway 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),
admfailovergiveaway(1M), admfailoverhosts(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.
Licensed material--property of copyright holder(s)