C    Modifications to System Files

The following system-configuration and installation-related files are created or modified as a result of installing the TruCluster Server Version 5.1B software:

/.rhosts

If the file does not exist, clu_create creates it. The clu_create command adds the fully qualified host name associated with the cluster alias. The clu_create and clu_add_member commands add the IP name (or IP names, for LAN interconnects) associated with each cluster interconnect interface.

/cluster/admin/.membern.cfg

These files are installation-configuration files; there is one for each member. The files are created by and appended to by clu_create or clu_add_member. Each file contains a list of name/value pairs representing the selections made when running clu_create or clu_add_member for that particular member.

These files are maintained by clu_create and clu_add_member. Do not edit them.

/cluster/admin/.member.list

This text file is used by clu_create and clu_add_member to keep track of assigned cluster member IDs.

This file is maintained by clu_create and clu_add_member. Do not edit it.

/cluster/admin/clu_check_config.log

This log file is maintained by clu_check_config.

/cluster/admin/clu_create.log

This log file is maintained by clu_create. Each time you run clu_create, it appends a log of the session to this file.

/cluster/admin/clu_add_member.log

This log file is maintained by clu_add_member. Each time you run clu_add_member, it appends a log of the session to this file.

/cluster/admin/clu_upgrade

This directory is where clu_upgrade stores log files from completed upgrades.

/cluster/admin/clu_upgrade.log

This log file is maintained by clu_upgrade. When a rolling upgrade completes, clu_upgrade moves the log file to the /cluster/admin/clu_upgrade/history/release_version directory.

/etc/fdmns

The clu_create command creates the domain directories for the clusterwide root (/), /usr, /var, and optionally, i18n file systems, and for the first cluster member. The clu_add_member command creates a domain directory for each additional member.

/etc/gated.conf

If gated is configured on the Tru64 UNIX system, the file is copied to the first member and propagated to the remaining members. If gated is not configured, it is created for each member by the installation scripts. In a cluster, /etc/gated.conf is a CDSL whose target file is /cluster/members/{memb}/etc/gated.conf.

Note

The aliasd daemon creates a /etc/gated.conf.membern for each cluster member. The daemon starts gated using this file as gated's configuration file rather than the member's /cluster/members/{memb}/etc/gated.conf file.

/etc/hosts

The clu_create and clu_add_member commands add the IP address and interface name (or addresses and names, for LAN interconnects) associated with each member's cluster interconnect interface. The clu_create command adds the IP address, fully qualified host name, and unqualified host name for the default cluster alias.

/etc/ifaccess.conf

Both clu_create and clu_add_member add deny entries for all noncluster-interconnect network interfaces on a cluster member. The deny entries prevent IP packets coming from outside the cluster from being directed to the cluster interconnect through these interfaces.

/etc/inittab

Both clu_create and clu_add_member add a sysconfig command line for cms (cluster mount service).

/etc/rc.config

This file is copied by clu_create from the system running Tru64 UNIX to the first cluster member. Created from .new..rc.config by clu_add_member for all other members. Table C-1 lists the configuration variables that are set during installation.

/etc/sysconfigtab

The installation scripts initialize several sysconfigtab attributes. For some attributes, the scripts prompt for information; for others, the scripts silently set the values. (See Table C-2 for a list of configuration variables initialized by the installation procedure.)

/etc/sysconfigtab.cluster

The clu_create and clu_add_member commands set the value of cluster_expected_votes.

Table C-3 lists the configuration variables initialized by the installation procedure.

/sys/conf/HOSTNAME.list

This file registers the cluster software with the kernel before the installation procedure calls the doconfig program. HOSTNAME is the host name of the system.

/sys/HOSTNAME/vmunix

A new kernel is built and placed in /sys/HOSTNAME/vmunix, where HOSTNAME is the name of the configuration file specified during installation. The clu_create and clu_add_member commands copy each member's vmunix file to that member's boot partition.

Table C-1 lists the /etc/rc.config variables that are created or modified by clu_create or clu_add_member.

Table C-1:  /etc/rc.config Variables

Variable Comment
BASE_VERSION Version of the Tru64 UNIX operating system on which TruCluster Server is installed. If set on the current member, set by clu_add_member to the value of the current member.
CLU_BOOT_FILESYSTEM Domain and fileset for this member's boot disk. Set by both clu_create and clu_add_member.
CLU_NEW_MEMBER Set to 1 during installation; set to 0 after the member boots into the cluster for the first time.
CLU_VERSION Version number of the installed TruCluster Server product. If set on the current member, set by clu_add_member to the value of the current member.
CLUSTER_NET IP name of the system's virtual cluster interconnect interface. The installation procedure adds a CLUSTER_NET entry and sets its value to the user-specified interface name.
GATED If neither GATED nor ROUTED is set to yes on the Tru64 UNIX system, clu_create sets GATED to yes. Set by clu_add_member to the value of the current member.
GATED_FLAGS Set by clu_add_member to the value of the current member.
HOSTNAME Set to the user-specified value when adding a member.
IFCONFIG_n IP address and the netmask for the cluster virtual interconnect interface. The installation procedure adds an IFCONFIG_n entry.
IMC_AUTO_INIT If set to 1, libimc will be automatically initialized whenever the system boots. This initialization involves reserving approximately 4.5 MB for the library. The default value at installation is 0; the library is not initialized. If set on the current member, set by clu_add_member to the value of the current member.
IMC_MAX_ALLOC Determines the maximum aggregate amount, in MB, of Memory Channel address space that libimc can allocate for its use across the cluster. If the value of this variable differs among cluster members, the largest value specified is used. The default value at installation is 10. If set on the current member, set by clu_add_member to the value of the current member.
IMC_MAX_RECV Determines the maximum aggregate amount, in MB, of physical memory that libimc can map for reading Memory Channel address space. This limit is node-specific. The default value at installation is 10. If set on the current member, set by clu_add_member to the value of the current member.
MAX_NETDEVS If not set, set to 24 by clu_add_member.
NETDEV_n Network device name (ics0) for the system's virtual cluster interconnect interface. The installation procedure adds a NETDEV_n entry. For a LAN interconnect, if you specify an existing NetRAIN set, the installation procedures use the NETDEV_n entry associated with that set.
NRCONFIG_n Interfaces in a NetRAIN interface set. If the member uses an existing NetRAIN set for a LAN interconnect, cleared by clu_create. NetRAIN for clusters is defined in /etc/sysconfigtab, not /etc/rc.config
NRDEV_n NetRAIN interface name. If the member uses an existing NetRAIN set for a LAN interconnect, cleared by clu_create. NetRAIN for clusters is defined in /etc/sysconfigtab, not /etc/rc.config
NR_DEVICESn Number of NetRAIN devices. If the member uses an existing NetRAIN set for a LAN interconnect, cleared by clu_create. NetRAIN for clusters is defined in /etc/sysconfigtab, not /etc/rc.config
NUM_NETCONFIG Number of configured network devices. The clu_create command increments the value of NUM_NETCONFIG, unless you specify an existing NetRAIN set for the cluster interconnect. The clu_add_member command sets the value of NUM_NETCONFIG to 1.
PAGERAW Set to 1 by clu_add_member.
ROUTER If set on the current member, set by clu_add_member to the value of the current member.
TCR_INSTALL If set to TCR, the installation was successful. If set to BAD, the installation was unsuccessful. If set on the current member, set by clu_add_member to the value of the current member.
TCR_PACKAGE Set to TCR. If set on the current member, set by clu_add_member to the value of the current member.
XLOGIN If set on the current member, set by clu_add_member to the value of the current member.
XNTPD_CONF If set on the current member, set by clu_add_member to the value of the current member. If not set on the current member, set to YES.
XNTPD_OPTS If set on the current member, set by clu_add_member to the value of the current member. If not set on the current member, set to -g.
XNTP_SERVn All members of the cluster are configured as peers of each other. A fudge command is placed in each member's ntp.conf file and, if fewer than three servers are configured, server 127.127.1.0 is added to each member's rc.config file.

Table C-2 lists the /etc/sysconfigtab variables that are modified or created by clu_create or clu_add_member.

Table C-2:  /etc/sysconfigtab Attributes

Subsystem Attribute Comment
clubase cluster_interconnect Interconnect type used for cluster internode communications. If a LAN interconnect is used, the clu_create and clu_add_member commands set this attribute to tcp. If Memory Channel is used, the attribute is set it to mct.
  cluster_name Unqualified cluster name. Set by both clu_create and clu_add_member.
  cluster_expected_votes Sum of all votes held by the cluster members plus the vote assigned to the quorum disk (if configured).
  cluster_node_inter_name IP name associated with this member's cluster interconnect interface; for example, polishham-ics0. The installation procedure prompts for this information.
  cluster_node_name Unqualified host name of this member.
  cluster_node_votes Fixed number of votes that a node contributes toward quorum. Each node with a nonzero value is considered a voting member.
  cluster_qdisk_major Major device number of the h partition on the quorum disk.
  cluster_qdisk_minor Minor device number of the h partition on the quorum disk.
  cluster_qdisk_votes Fixed number of votes that the quorum disk contributes toward quorum.
  cluster_seqdisk_major Major device number of the h partition on a member's boot disk.
  cluster_seqdisk_minor Minor device number of the h partition on a member's boot disk.
drd drd_nopr_list First entry on the list of hardware IDs for devices on which the device request dispatcher subsystem will not perform persistent reservations. If set on the current member, set by clu_add_member to the value of the current member.
generic act_vers_high Version number used during an upgrade to synchronize changes across the cluster. Do not modify.
  act_vers_low Version number used during an upgrade to synchronize changes across the cluster. Do not modify.
  memberid Cluster memberid for this member. Each member must have a unique memberid (1-63). The installation procedure prompts for the value of this attribute.
  msgbuf_size If less than 16384, set to 16384 by clu_create. Set to the value of the current member by clu_add_member.
  new_vers_high Version number used during an upgrade to synchronize changes across the cluster. Do not modify.
  new_vers_low Version number used during an upgrade to synchronize changes across the cluster. Do not modify.
  rolls_ver_lookup Set to 0 by clu_create and clu_add_member. Set to 1 by clu_upgrade for members using tagged files during a rolling upgrade or patch. Reset to 0 by clu_upgrade when the member has rolled. Do not modify.
ics_ll_tcp ics_tcp_inetaddr0 Set to the IP address of the physical cluster interconnect device (for example, 10.1.0.1) by clu_create and clu_add_member. (LAN interconnect only)
  ics_tcp_netmask0 Subnet mask for the cluster interconnect. Set by clu_create and clu_add_member to 255.255.255.0. (LAN interconnect only)
  ics_tcp_adapter0 Name of the physical cluster interconnect device (for example, tu0 or nr0). Set by clu_create and clu_add_member. (LAN interconnect only)
  ics_tcp_nr0 If the ics_tcp_adapter0 attribute indicates a NetRAIN set, this attribute is an array indicating the device names of the network adapters that make up the set. (LAN interconnect only)
lsm lsm_rootdev_is_volume Set to 0 by clu_create and clu_add_member.
sec acl_mode If set, set to the value of the current system or member. If not set, set to disable. Set by clu_create and clu_add_member.
vm swapdevice Swap device for this member. The installation procedure uses the b partition of the device you specify as this member's boot disk as the value of this attribute.
  vm_page_free_reserved If value is less than 20, set to 20 by clu_create and clu_add_member.
  vm_page_free_min If value is less than 30, set to 30 by clu_create and clu_add_member.

Table C-3 lists the /etc/sysconfigtab.cluster variables that are modified or created by clu_create or clu_add_member.

Table C-3:  /etc/sysconfigtab.cluster Attributes

Subsystem Attribute Comment
clubase cluster_expected_votes Sum of all votes held by the cluster members plus the vote assigned to the quorum disk (if configured). Set by clu_create and clu_add_member.