Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ failover(4M) — DG/UX 5.4R3.00

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

admfailoveraltcommpath(1M)

admfailoverapplication(1M)

admfailoverdisk(1M)

admfailoverip(1M)

admfailovergiveaway(1M)

admfailoverhosts(1M)

admfailovertakeaway(1M)

failoverd(1M)

failovermon(1M)



failover(4M)                   DG/UX 5.4R3.00                   failover(4M)


NAME
       failover - failover database

SYNOPSIS
       /etc/failover

DESCRIPTION
       The  /etc/failover  directory  contains  all of the failover database
       files used in configuring and maintaining failover. The files in this
       directory  are  used  for  Operator and Machine Initiated failover as
       well as for IP Takeover.

       The files within this directory are:

       altcommpath         file containing information about  the  alternate
                           communication paths to be used by the failovermon
                           monitor. If there are entries in this  file,  the
                           failovermon  monitor  will  use them to establish
                           additional communication paths to  the  specified
                           host. Using redundant LAN's or SLIP lines in this
                           database  will  reduce  the  possibility  of  the
                           monitor  taking  control of the physical disks if
                           the network becomes partitioned.

            The format of entries in the altcommpath file is:

                 hostname  Primary name of system to be monitored.

                 alternate-hostname
                           The alternate name of the host, on  which  TCP/IP
                           communications  are  to  be  used when monitoring
                           hostname.


       application         file containing application startup scripts to be
                           executed when a physical disk is failed over.

            The format of entries in the application file is:

                 hostname  Name  of  dual ported host where physical disk is
                           coming from.

                 local-diskname
                           Local disk module specification.

                 remote-diskname
                           Remote disk module specification.

                 application-command
                           Full pathname to a script that cannot fail,  that
                           will  be executed when the disk is failed over to
                           this  host.  This  script  is  executed  by   the
                           admfailoverdisk command and must contain the path
                           to the interpreter to be used, as the first  line



Licensed material--property of copyright holder(s)                         1




failover(4M)                   DG/UX 5.4R3.00                   failover(4M)


                           (eg.,  #!/bin/sh  ).  This  script  must have the
                           proper permissions on it in order to be  executed
                           by the admfailoverdisk command.


       failoverip          The  entries  in  this  file  correspond  to  the
                           floating IP addresses that can  be  cooperatively
                           managed  by  this  host  and  the specified host.
                           This floating IP  address  is  what  is  used  to
                           provide  NFS and telnet/rlogin services to client
                           systems that want  high  availability  access  to
                           physical disks in a dual-initiator configuration.

            The format of entries in the failoverip file is:

            hostname       Name of host to transfer floating IP  address  to
                           and from.

            float-name     Hostname associated with floating IP address.

            local-interface-name
                           Name   of   network   interface  associated  with
                           floating IP address on this host.

            remote-interface-name
                           Name  of  network   interface   associated   with
                           floating IP address on remote host.

            start-on-reboot
                           A  flag indicating whether or not the floating IP
                           address is to  be  started  when  the  system  is
                           rebooted.  If  this  value  is 1, the rc.failover
                           script will  use  the  admfailoverip  command  to
                           start the floating IP address.


       hosts               file  containing  communications  and sync status
                           information for failover hosts.

            The format of entries in the hosts file is:

                 hostname  Name of dual-ported host.

                 communications-path
                           the word "network" to indicate communications are
                           via the network.

                 sync-status
                           The  current  sync  status  of this host with the
                           specified host. The  host  is  either  INSYNC  or
                           NOTSYNC.  Before  a give or take operation can be
                           attempted the database state must be INSYNC.





Licensed material--property of copyright holder(s)                         2




failover(4M)                   DG/UX 5.4R3.00                   failover(4M)


       giveaway            file containing entries for physical  disks  that
                           can be given to other hosts

       takeaway            file  containing  entries for physical disks that
                           can be taken from other hosts

            The format of entries in the giveaway and takeaway files is:

                 hostname  Name of dual ported host to give physical disk to
                           or take physical disk from.

                 local-diskname
                           Local disk module specification.

                 remote-diskname
                           Remote disk module specification.

                 vduname   Virtual disk name.

                 mount-point
                           File system mount point.

                 fs-type   File system type.

                 mount-options
                           File system mount options.

                 dump-frequency
                           File system dump frequency.

                 fsck-passno
                           File system fsck pass number.

                 fsid      File  system id for reservations in NFS takeover.

                 export    File system export flag.

                 export-options
                           File system export options.


       monitors            file containing information about the failovermon
                           monitors that will run on this system.

            The format of entries in the monitors file is:

                 hostname  Name of the system to monitor.

                 pid       The  process id of the monitor if it is currently
                           running. This is written to  the  file  when  the
                           monitor is started.

                 start-on-reboot
                           A  flag  indicating whether or not the monitor is



Licensed material--property of copyright holder(s)                         3




failover(4M)                   DG/UX 5.4R3.00                   failover(4M)


                           to be started when the  system  is  rebooted.  If
                           this  value is 1, the rc.failover script will use
                           the failovermon command to start the monitor.

                 interval  Interval in seconds between message cycles

                 retries   Number of times to  retry  message  cycle  before
                           executing lost_pulse action script.

                 lost-pulse-script
                           Pathname  to  user defined script to execute when
                           pulse is lost.  This script is  executed  by  the
                           failovermon  monitor and must contain the path to
                           the interpreter to be used,  as  the  first  line
                           (eg.,  #!/bin/sh  ).   This  script must have the
                           proper permissions on it in order to be  executed
                           by the failovermon monitor.

                 regain-pulse-script
                           Pathname  to  user defined script to execute when
                           pulse is regained.  This script  is  executed  by
                           the failovermon monitor and must contain the path
                           to the interpreter to be used, as the first  line
                           (eg.,  #!/bin/sh  ).   This  script must have the
                           proper permissions on it in order to be  executed
                           by the failovermon monitor.

FILES
       /etc/failover

SEE ALSO
       admfailoveraltcommpath(1M),               admfailoverapplication(1M),
       admfailoverdisk(1M),   admfailoverip(1M),    admfailovergiveaway(1M),
       admfailoverhosts(1M),     admfailovertakeaway(1M),     failoverd(1M).
       failovermon(1M).






















Licensed material--property of copyright holder(s)                         4


Typewritten Software • bear@typewritten.org • Edmonds, WA 98026