Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ failover(4M) — DG/UX R4.11

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

admfailovervtc(1M)



failover(4M)                     DG/UX R4.11                    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, IP
       Takeover, and VTC/PTC Failover.

       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
                           (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.

                           This file is only present if the Failover package
                           is installed.

            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.


       failovervtc         The  entries  in  this  file  correspond  to  the
                           controllers setup for VTC/PTC failover.

            The format of entries in the failovervtc file is:

            primary-controller-name
                           Name of primary VTC/PTC device on this host.

            hostname       Name  of  host  that  contains  the remote backup
                           VTC/PTC.   Set  to  "None"  if  a  remote  backup
                           controller  does  not  exist  for  the  specified
                           primary controller.

            remote-backup-controller-name
                           Name of remote  backup  VTC/PTC  device  for  the
                           primary  VTC/PTC.   Set  to  "None"  if  a remote
                           backup  controller  does  not   exist   for   the
                           specified primary controller.

            local-backup-controller-name
                           Name  of  local  backup  VTC/PTC  device  for the
                           primary VTC/PTC.  Set to "None" if a local backup
                           controller  does  not  exist  for  the  specified
                           primary controller.


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

                           This file is only present if the Failover package
                           is installed.

            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.


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

                           This file is only present if the Failover package
                           is installed.

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

                           This file is only present if the Failover package
                           is installed.

            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
                           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
       admfailovervtc(1M)


Licensed material--property of copyright holder(s)

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