admfailoveraltcommpath(1M)     DG/UX R4.11MU05    admfailoveraltcommpath(1M)


NAME
       admfailoveraltcommpath - manage failover alternate communications
       paths

SYNOPSIS
       admfailoveraltcommpath -o add -h hostname [ -c ] alternate-hostname

       admfailoveraltcommpath -o check -h hostname [ alternate-hostname ...
                     ]

       admfailoveraltcommpath -o delete -h hostname [ alternate-hostname ...
                     ]

       admfailoveraltcommpath -o modify -h hostname -n new-alternate-
                     hostname [ -c ] alternate-hostname

       admfailoveraltcommpath -o list [ -qv ] [ -h hostname ]

DESCRIPTION
       admfailoveraltcommpath provides operations for manipulating entries
       in the failover altcommpath(4M) database and checking the
       accessibility of the alternate communications paths. The entries in
       this database will be used by the failovermon(1M) monitor process to
       monitor the specified host.

       Since the failovermon(1M) monitor uses all of the communication paths
       for monitoring, the order of the paths in the database is not
       important. If an alternate communication path is added after a
       failovermon(1M) monitor has been started, the monitor will need to be
       stopped and restarted for the new path to be used.

   Operations
       add       Add an entry for an alternate communications path to the
                 failover altcommpath database. These paths will be used by
                 the failovermon(1M) monitor to help make a correct
                 detection of failure.

       check     Check to see if an alternate communications path is
                 accessible. This operation will send a single heartbeat
                 message to the specified host via the specified
                 communication path.

       delete    Delete an entry for an alternate communications path from
                 the failover altcommpath database.

       modify    Modify an entry for an alternate communications path in the
                 failover altcommpath database.

       list      List failover altcommpath database entries. The list
                 operation reports the following altcommpath information to
                 stdout:

                     the primary hostname
                     the alternate name of the primary host

                 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.  Specifying both -q and -v produces output
                 in `quiet' format.

   Options
       The following option must be used with the add, check, delete, and
       modify operations:

       -h hostname
                 This is the primary name of the remote host.

       The following option must be used with the modify operation:

       -n new-alternate-hostname
                 This is the new alternate name of the remote host that is
                 used to service TCP/IP requests on the alternate
                 communications path.

       The following option can be used with the add and modify operations:

       -c        This option will instruct the admfailoveraltcommpath
                 command to check the alternate communications path being
                 added or modified.

EXAMPLE
       To add an alternate communications path to the failover altcommpath
       database to hostb whose alternate host name is hostb-alt, you should
       issue the following command line:

         admfailoveraltcommpath -o add -h hostb hostb-alt


FILES
       /etc/failover/altcommpath
                           failover altcommpath database

DIAGNOSTICS
   Warnings
       -      An attempt was made to delete an altcommpath database entry
              that did not exist.

       -      An attempt was made to send a heartbeat over an inaccessible
              communications path.

   Errors
       -      An attempt was made to add, delete, modify, or list an
              alternate communications path for an invalid host.

       -      An attempt was made to modify or list an altcommpath database
              entry that did not exist.

       -      An attempt was made to add an altcommpath database entry that
              already existed.

   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), failovermon(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)