admfailoverhosts(1M) DG/UX R4.11MU05 admfailoverhosts(1M)
NAME
admfailoverhosts - manage failover hosts database
SYNOPSIS
admfailoverhosts -o add hostname
admfailoverhosts -o delete hostname
admfailoverhosts -o modify hostname
admfailoverhosts -o list [ -qv ]
DESCRIPTION
admfailoverhosts provides operations for manipulating entries in the
failover(4M) hosts database. This database is used to maintain host
specific information about hosts that have been setup for failover
with this host. This file contains the name of the hosts, the
communications path to the host, and the current sync state of the
failover databases.
For DG/UX 5.4.2 the only supported communications path is the
network. In order to use the failover software, both hosts must be
accessible on a local area network.
The sync state is used to determine if both hosts failover databases
are in sync. When modifications to a failover database are made, the
sync state is set to a value that will prohibit failover of a
physical disk. The sync state is changed to a value that will allow a
failover of a physical disk, by using the sync operation of the
admfailoverdisk(1M) command.
Operations
add Add the specified entry to the hosts database and setup and
start the associated communications services. A host entry
must exist on both machines that are dual porting a
physical disk that can be failed overbefore the machines
will be able to communicate with each other. Only a user
with appropriate privilege may execute this operation.
delete Delete the specified host entry and the associated
communications services for that host. Only a user with
appropriate privilege may execute this operation.
modify Modify host entry. This operation currently does nothing,
and is reserved for future use. Only a user with
appropriate privilege may execute this operation.
list List information about hosts 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 communications path the hosts will use
the current sync status
With the "verbose" format (-v), information is printed in
aligned columns with headers. With the "quiet" format (-q)
headers are suppressed and each host entry is printed on a
separate line. If both -q and -v are specified, the output
will be in "quiet" format.
Options
Arguments for the add, delete, and modify operations:
hostname The hostname argument is the name of the host that the
operation will be performed for. For an add operation, the
hostname must be a valid hostname and not already exist in
the failover hosts database. For the delete and modify
operations, the hostname must be a valid hostname and must
already exist in the failover hosts database.
Options for the list operation
-q Quiet. Produce an unformatted listing (i.e. 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 hostA you wish to add a host entry
for a host that is dual porting a physical disk that you wish to
setup failover for. The name of the host dual porting the physical
disk is hostB. You would add the host to the failover database using
admfailoverhosts -o add hostB
FILES
/etc/failover failover database files
DIAGNOSTICS
Errors
- An invalid hostname was specified for an operation.
- An attempt was made to add a hosts entry that already exists
in the database.
- An attempt was made to delete or modify a hosts entry that
does not exists.
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), admfailovertakeaway(1M), failover(4M),
appropriate_privilege(5), cap_defaults(5).
NOTES
You must have appropriate privilege to perform all operations except
list. On a traditional DG/UX system, appropriate privilege means
that you have an effective UID of 0. See the
appropriate_privilege(5) man page for more information.
On a system that supports the DG/UX Capability option, appropriate
privilege is defined as having one 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.
The admfailoverhosts command should be performed on the backup system
before a sync operation is performed on the primary system.
Licensed material--property of copyright holder(s)