B Modifications to System Files

The following files are created or modified as a result of installing TruCluster software:

/etc/hosts

The IP address and interface name associated with the primary network interface.

For Production Server, the IP address of the cluster_cnx service.

/etc/rc.config

Table B-1 lists the configuration variables that are either manipulated by the installation procedure or are of interest during installation.

See the TruCluster Software Products Administration manual for a complete list of TruCluster rc.config variables.

/etc/sysconfigtab

Table B-2 lists the configuration variables that are either manipulated by the installation procedure or are of interest during installation.

See the TruCluster Software Products Administration manual for a complete list of TruCluster sysconfigtabvariables.

/sys/conf/NAME.list

This file registers the cluster software and revised SCSI bus numbers with the kernel before the installation procedure calls the doconfig program.

/sys/NAME/vmunix

A new kernel is built and placed in /sys/NAME/vmunix, where NAME is the name of the configuration file specified during installation.

/var/ase/config/config.state

For Production Server and Available Server, the file created and maintained by the ase_fix_config command to store SCSI controller information.

You must manually modify the files described in Table B-3 on each cluster member after Production Server is installed on all member systems.

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

Variable Product Comment

PS AS MC

ASE X X ASE="on" indicates that the ASE is configured. The installation procedure adds the ASE variable and sets its value to on or off depending on user input during the installation.

ASE_ID X X The system's ASE identifier; legal values are 0-63. The installation procedure adds the ASE_ID variable. For Production Server, the installation procedure assigns the user-specified value; for Available Server, the value defaults to 0.

ASELOGGER X X ASELOGGER=1 indicates that the system will run an ASE logger daemon. The installation procedure adds the ASELOGGER variable, and sets its value to 0 or 1 depending on user input.

CLUSTER_NET X X For PS and AS, the name of the system's primary network interface. The installation procedure adds a CLUSTER_NET entry and sets its value to the user-specified interface name.

CNX_DISK X The device name of the tie-breaker disk specified using the cnxset utility. See Section 3.14 for information on setting up a tie-breaker disk.

IMC_AUTO_INIT X X IMC_AUTO_INIT=1 indicates that 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 1.

IMC_MAX_ALLOC X X 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.

IMC_MAX_RECV X X 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.

NETDEV X X X The network device name for the system's primary PS, AS, or MC network interface. The installation procedure adds a NETDEV_n entry.

NUM_NETCONFIG X X X The number of configured network devices. The installation program increments the value of NUM_NETCONFIG.

TCR_INSTALL X X X Indicates a successful installation when its value is TCR, ASE, or MCA. Indicates an unsuccessful installation when its value is BAD.

TCR_PACKAGE X X X Indicates TruCluster product installed on system: TCR for Production Server; ASE for Available Server; MCA for MEMORY CHANNEL

Variable	Product	Comment
`ASE`	X	X		`ASE="on"` indicates that the ASE is configured. The installation procedure adds the `ASE` variable and sets its value to `on` or `off` depending on user input during the installation.
`ASE_ID`	X	X		The system's ASE identifier; legal values are 0-63. The installation procedure adds the `ASE_ID` variable. For Production Server, the installation procedure assigns the user-specified value; for Available Server, the value defaults to `0`.
`ASELOGGER`	X	X		`ASELOGGER=1` indicates that the system will run an ASE logger daemon. The installation procedure adds the `ASELOGGER` variable, and sets its value to `0` or `1` depending on user input.
`CLUSTER_NET`	X	X		For PS and AS, the name of the system's primary network interface. The installation procedure adds a `CLUSTER_NET` entry and sets its value to the user-specified interface name.
`CNX_DISK`	X			The device name of the tie-breaker disk specified using the `cnxset` utility. See Section 3.14 for information on setting up a tie-breaker disk.
`IMC_AUTO_INIT`	X		X	`IMC_AUTO_INIT=1` indicates that `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 `1`.
`IMC_MAX_ALLOC`	X		X	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`.
`IMC_MAX_RECV`	X		X	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`.
`NETDEV`	X	X	X	The network device name for the system's primary PS, AS, or MC network interface. The installation procedure adds a `NETDEV_n` entry.
`NUM_NETCONFIG`	X	X	X	The number of configured network devices. The installation program increments the value of `NUM_NETCONFIG`.
`TCR_INSTALL`	X	X	X	Indicates a successful installation when its value is `TCR`, `ASE`, or `MCA`. Indicates an unsuccessful installation when its value is `BAD`.
`TCR_PACKAGE`	X	X	X	Indicates TruCluster product installed on system: `TCR` for Production Server; `ASE` for Available Server; `MCA` for MEMORY CHANNEL

Table B-2: /etc/sysconfigtab Attributes

Subsystem Attribute Product Comment

PS AS MC

clubase cluster_disable X X X For Production Server and Available Server, when cluster_disable is set to 1, disables all cluster components. For MEMORY CHANNEL, when cluster_disable is set to 1, the MEMORY CHANNEL API library is not automatically initialized at boot time (even if IMC_AUTO_INIT is set to 1 in /etc/rc.config). The default value is 0.

cluster_version X X X TruCluster product version string. Set by installation procedure.

dlm dlm_disable_rd X During installation, new DLM features are deliberately disabled until turned on by the dlm_enable script, which sets dlm_disable_rd=0. See Section 3.10 and Section 4.4 for more information on this attribute. The default value is 1.

mchan mchan_debug X X Set to 1 for verbose MEMORY CHANNEL error messages. The default value is 0.

rm rm-no-inheritance X X Controls MEMORY CHANNEL object inheritance at fork(). Required in order to use libimc routines. The value is set to 1 by the installation procedure.

Subsystem	Attribute	Product	Comment
`clubase`	`cluster_disable`	X	X	X	For Production Server and Available Server, when `cluster_disable` is set to `1`, disables all cluster components. For MEMORY CHANNEL, when `cluster_disable` is set to `1`, the MEMORY CHANNEL API library is not automatically initialized at boot time (even if `IMC_AUTO_INIT` is set to `1` in `/etc/rc.config`). The default value is `0`.
	`cluster_version`	X	X	X	TruCluster product version string. Set by installation procedure.
`dlm`	`dlm_disable_rd`	X			During installation, new DLM features are deliberately disabled until turned on by the `dlm_enable` script, which sets `dlm_disable_rd=0`. See Section 3.10 and Section 4.4 for more information on this attribute. The default value is `1`.
`mchan`	`mchan_debug`	X		X	Set to `1` for verbose MEMORY CHANNEL error messages. The default value is `0`.
`rm`	`rm-no-inheritance`	X		X	Controls MEMORY CHANNEL object inheritance at `fork()`. Required in order to use `libimc` routines. The value is set to `1` by the installation procedure.

Table B-3: Manual Modifications to System Files

File Modification

/etc/fdmns/domainname If you renumbered shared SCSI buses, correct the symbolic links in these directories to point to the new device names.

/etc/fstab If you renumbered shared SCSI buses, modify entries in this file to reference the new device names.

/etc/hosts Add a host entry for each member system.

/etc/svc.conf Make sure that the access path for the hosts database lists local first.

/sys/HOSTNAME/vmunix Move the new kernel built during cluster kernel configuration to the root (/) directory.

File	Modification
/etc/fdmns/`domainname`	If you renumbered shared SCSI buses, correct the symbolic links in these directories to point to the new device names.
`/etc/fstab`	If you renumbered shared SCSI buses, modify entries in this file to reference the new device names.
`/etc/hosts`	Add a host entry for each member system.
`/etc/svc.conf`	Make sure that the access path for the `hosts` database lists `local` first.
/sys/`HOSTNAME`/vmunix	Move the new kernel built during cluster kernel configuration to the root (`/`) directory.