Avnet Technology Solutions


Home

Sales

Software Downloads

On-Line Documentation

         
 

SavWareHA File and Program Descriptions

 
/etc/sentinel.d/administrators

(Text File)

List of users on both the Primary and Standby System s that have been designated as system administrators. Each administrator will have a login id listed on separate lines. For example:

root

mary_r

dmann@aa.sa.org (requires proper configuration of MMDF)

These administrators will receive mail and messages regarding the status of the SavWareHA system. This file must be manually edited using a text editor such as ‘vi ’.

Make certain that ‘mail ’ functions properly by sending a test mail message to the proposed system administrator, especially if ‘mmdf ’ must be modified. For instance, in the example above, the administrator should send mail to ‘dmann’:

mail dmann@aa.sa.org

Hello down there ;-)

[CONTROL-D]

This should initiate a ‘mmdf ’ request, and the recipient should receive it in a timely fashion. Much more information on ‘mmdf’ may be found in the SCO ‘System Administrator’s Guide’ manual .

 
/etc/sentinel.d/dkinfo

(Program)

This program displays the disk hardware name(s), size, SCSI adapter and adapter number, and SCSI target ID of each disk partition on the system found through the file ‘/etc/conf/cf.d/mscsi’. This is used in the SavWareHA setup when [F3] is pressed to configure the mirror .

 
/etc/sentinel.d/dkuse

(Program)

This program shows if and where a disk partition is used. This is invoked when [F3 ] is pressed during mirror construction.

 
/etc/sentinel.d/filesys

(Text File)

Defines the mirrored filesystems . For example, the file might read:

# bdev(primary) bdev(standby) mountpoint flags mount flags

 
/dev/mirror00 /dev/mirror00 /u A

This indicates that on the Primary System , the filesystem referenced by ‘/dev/mirror00’ will be mirrored over to the Standby System onto the filesystem ‘/dev/mirror00’. This mirror will be mounted on the Primary System on directory ‘/u’.

The flags and mount flags columns contain the flags to be passed to the mount command. The flag ‘A’ means to automatically mount the filesystem during the transition to multi-user mode. The flag ‘R’ means that this is a raw database partition that is mirrored but not automatically mounted. This file must be identical on both systems.

This file is created and modified by the SavWareHA configuration utility.

 
/usr/adm/dmx.log

(Text File)

Comprehensive log file for SavWareHA. Information regarding status changes (normal to fallback and vice versa), configuration changes, and errors will be recorded in this log.

 
/etc/sentinel.d/mode

(Text File)

Text representation of the mode of the SavWareHA system. Its value is either ‘normal’ or ‘fallback’. A copy of this is accessed on both systems.

 
/etc/sentinel.d/roles

(Text File)

Consists of two lines, one per machine, that determine the current SavWareHA configuration. For example, the file might read:

neptune primary

pluto standby

This would indicate that the machine ‘neptune ’ is currently operating as the Primary System , and ‘pluto’ is currently operating as the Standby System . This file must be identical on both systems.

Administration Recommendation: It is recommended that the network card for the data link on the primary system be given the name “neptune” and the network card for the data link on the standby system be given the name “pluto”. This must be done with netconfig before SavWareHA is configured. If this is done, the roles file will be:

netptune primary

pluto standby

This file is created and modified by the SavWareHA configuration utility.

 
/etc/sentinel.d/sentinel

(Program)

This is the SavWareHA executable program. It is linked to /etc/sentinel. All SavWareHA menu-driven functions are accessed from this program.

 
/etc/sentinel.d/sentinel.sh

(Shell Program)

This is a supporting shell script for the SavWareHA program. This program is linked to /etc/sentinel.sh.

 
/etc/sentinel.d/sentinel.strt

(Shell Program)

A link between this file, ‘/etc/rc2.d/S85sentinel’ and ‘/etc/rc0.d/K05sentinel’ is made to determine what processes are to be started up or shutdown during transition phases of the SavWareHA system.

 
/etc/sentinel.d/terminals

(Text File)

The list of terminals and serial resources that are to be enabled and disabled during transitions from normal to fallback mode . The format for this file is serial device name without the preceding ‘/dev’. For example, the file might contain:

tty1a

ttyn0101

ttybd

This would denote that terminals ‘/dev/tty1a’, ‘/dev/ttyn0101’, and ‘/dev/ttybd’ are to be enabled for login on the Primary System under ‘normal’ mode, and on the Standby System under ‘fallback’ mode. This file must be manually edited using a text editor. This file should be identical on both systems.

Administration Recommendation: It is recommended that S75inittab be used to control the terminals if more that three terminals are going to be switched. This will reduce the amount of time required for a system switchover. See application note for S75inittab.

 
/etc/default/netdisk

This is created and modified by the SavWareHA program during SavWareHA configuration. It contains the network addressing for the data link . This file is only used on the Primary System . This file can be manually edited as necessary, but the Primary System will need to be rebooted for the changes to take effect. The format of the file is:

machine:device - (Size) (0) (Unit#) (Primary LLI ) (Remote LLI)

Please note that the file requires [TAB] characters for field separators.

For example, the file might look like:

pluto:/dev/rsrp00 - 0 0 0 /dev/wdn0 /dev/wdn0

 
         
  machine  

The machine name used by the data link to access the Standby System . To route SavWareHA data over a secondary network link, modify this machine name.

 
         
  device   The slave device name on the Standby System accessed by the ‘netdisk’ driver.  
         
  Size   If this field is 0, the size will be requested from the Standby System . The size can be forced by putting the number of blocks in this field.  
         
  0   This field is reserved.  
         
  Unit #   This field relates the entries in this file to the device name ‘/dev/ndsk ?0’. This is used to cross reference the filesystems to ‘/etc/default/mirror ’.  
         
  Primary LLI   This is an optional field used to redirect the SavWareHA data requests directly to the SCO LLI drivers without using TCP/IP . If present, this field must be the LLI device name of the network card on the Primary System . (i.e. ‘/dev/wdn0’).  
         
  Standby LLI   If present, this field must be the LLI device name of the network card on the Standby System (i.e. ‘/dev/wdn0’ ).  
         
 

 
/etc/default/mirror

This file is used to describe all of the mirrors on the system. On the Primary System , it defines the primary element and the standby element for each mirror . On the Standby System , only the standby element is defined. This file is modified by the SavWareHA program and other SavWareHA utilities. The format of the file is:

(Block Dev) (Raw Dev) (Size) (0) (Unit#)(Flags)

For example, the file might contain:

#block device    raw device     size factor unit

/dev/srp00         /dev/rsrp00        0      0       0R

/dev/ndsk00     /dev/rndsk00       0      0       0R

 
         
 

Block Dev

Block Device name of the primary element of the mirror .  
         
  Raw Device   The Character Device name of the primary element of the mirror .  
         
 

Size
{usually 0}

 

If the size is 0, the size will be determined by accessing the raw device. The size can be forced by specifying the number of blocks on the device.

 
         
  0   Reserved  
         
  Unit #   This is the mirror number. It cross references the file information to the devices ‘/dev/mirror?0’.  
   
  Flags Mirror Flags
R - Read from Primary only
T - Read from Standby only
M - Standby disabled
S - Primary disabled
 
         
         
 

This site is governed by Avnet, Inc.Terms and Conditions, Legal Notices & Privacy Statements.
Copyright © 1996-2005 Avnet, Inc. All rights reserved.