8.7.2 Configuration Parameters for the Sun Cluster HA for Netscape Data Services (Sun Cluster 2.2 Software Installation Guide)

Sun Cluster 2.2 Software Installation Guide

8.7.2 Configuration Parameters for the Sun Cluster HA for Netscape Data Services

This section describes the information you supply to the hadsconfig(1M) command to create configuration files for each Sun Cluster HA for Netscape data service. The hadsconfig(1M) command uses templates to create these configuration files. The templates contain some default, some hard coded, and some unspecified parameters. You must provide values for those parameters that are unspecified.

The fault probe parameters, in particular, can affect the performance of Sun Cluster HA for Netscape data services. Tuning the probe interval value too low (increasing the frequency of fault probes) might encumber system performance, and also might result in false takeovers or attempted restarts when the system is simply slow.

Fault probe parameters are configurable for Sun Cluster HA for Netscape HTTP, Sun Cluster HA for Netscape News, and Sun Cluster HA for Netscape LDAP. Fault probe parameters are not configurable for Sun Cluster HA for Netscape Mail.

All Sun Cluster HA for Netscape data services require you to set the takeover flag. This flag specifies how Sun Cluster will handle partial failover. There are two options:

-y (yes) - Sun Cluster will attempt to switch over the logical host to another master, but if the attempt fails the logical host will remain on the original master.
-n (no) - Sun Cluster will not move the logical host to another master, even if it detects problems with the data server, nor will it take any action against the faulty data server or database on the logical host.

8.7.2.1 Configuration Parameters for Sun Cluster HA for Netscape News

Configure the Sun Cluster HA for Netscape News parameters listed in the hadsconfig(1M) input form by supplying options described in Table 8-4.

Table 8-4 Configuration Parameters for Sun Cluster HA for Netscape News


Parameter	Description
Name of the instance	Nametag used as an identifier for the instance. The log messages generated by Sun Cluster HA for Netscape News refer to this nametag. The `hadsconfig(1M)` command prefixes the package name to the value you supply here. For example, if you specify "`nsnews_119`," the `hadsconfig(1M)` command produces "`SUNWscnew_nsnews_119`."
Logical host	Name of the logical host that provides service for this instance of Sun Cluster HA for Netscape News.
Base directory of product installation	Rooted path name specifying the location on the multihost disk of the Netscape News installation. This is the "instance path," for example, `/hahost1/news-hahost1`.
Probe interval	The time, in seconds, between fault probes. The default interval is 60 seconds.
Probe timeout	The time, in seconds, after which a fault probe will time out. The default timeout value is 20 seconds.
Server port number	Unique port for this instance of Sun Cluster HA for Netscape News. This is the "Server Port" value you supplied to the `ns-setup` command.
Takeover flag	Specifies whether a failure of this instance will cause a takeover or failover of the logical host associated with the data service instance. Possible values are `-y` (yes), or `-n` (no).

Note -

Do not use an HA administrative file system for the Sun Cluster HA for Netscape News installation base directory. Check the vfstab.logicalhost file to verify that the base directory you have chosen is not an HA administrative file system.

8.7.2.2 Configuration Parameters for Sun Cluster HA for Netscape HTTP

Configure the Sun Cluster HA for Netscape HTTP parameters listed in the hadsconfig(1M) input form by supplying options described in Table 8-5.

Table 8-5 Configuration Parameters for Sun Cluster HA for Netscape News


Parameter	Description
Name of the instance	Nametag used as an identifier for the instance. The log messages generated by Sun Cluster refer to this nametag. The `hadsconfig(1M)` command prefixes the package name to the value you supply here. For example, if you specify "nshttp_80," the `hadsconfig(1M`) command produces "SUNWschtt_nshttp_80."
Logical host	Name of logical host that provides service for this instance of Sun Cluster HA for Netscape HTTP.
Base directory of product installation	This is the base directory of the product installation, plus the server type and server port number. For example, `/hahost1/https-hahost`.
Probe interval	The time, in seconds, between fault probes. The default interval is 60 seconds.
Probe timeout	The time, in seconds, after which a fault probe will time out. The default timeout value is 20 seconds.
Server port number	Unique port for this instance of Sun Cluster HA for Netscape HTTP. This is the "Server Port" value you supplied to the `ns-setup` command.
Takeover flag	Specifies whether a failure of this instance will cause a takeover or failover of the logical host associated with the data service instance. Possible values are `-y` (yes), or `-n` (no).

Note -

Do not use an administrative file system for the Sun Cluster HA for Netscape HTTP installation base directory. Check the vfstab .logicalhost file to verify that the base directory you have chosen is not an administrative file system.

8.7.2.3 Configuration Parameters for Sun Cluster HA for Netscape Mail

Configure the Sun Cluster HA for Netscape Mail parameters listed in the hadsconfig(1M) input form by supplying options described in Table 8-6.

Table 8-6 Configuration Parameters for Sun Cluster HA for Netscape Mail


Parameter	Description
Name of the instance	Nametag used as an identifier for the instance. The log messages generated by Sun Cluster refer to this nametag. The `hadsconfig(1M)` command prefixes the package name to the value you supply here. For example, if you specify "nsmail," the `hadsconfig(1M`) command produces "SUNWscnsm_nsmail."
Logical host	Name of logical host that provides service for this instance of Sun Cluster HA for Netscape Mail.
Takeover flag	Specifies whether a failure of this instance will cause a takeover or failover of the logical host associated with the data service instance. Possible values are `-y` (yes), `-n` (no).

8.7.2.4 Configuration Parameters for Sun Cluster HA for Netscape LDAP

Configure the Sun Cluster HA for Netscape LDAP parameters listed in the hadsconfig(1M) input form by supplying options described in Table 8-7.

Table 8-7 Configuration Parameters for Sun Cluster HA for Netscape LDAP


Parameter	Description
Name of the instance	Nametag used as an identifier for the instance. The log messages generated by Sun Cluster refer to this nametag. The `hadsconfig(1M)` command prefixes the package name to the value you supply here. For example, if you specify "nsldap," the `hadsconfig(1M`) command produces "SUNWhansm_nsldap."
Logical host	Name of logical host on which the Netscape Directory Server resides.
Base directory of product installation	This is the base directory of the product installation. Include the logical host name prefixed with `ns-slapd_`. For example, `/hahost1/d1/ns-home/ns-slapd_hahost1/`. Make sure the directory you specify includes the `start` script.
Server port number	Unique port for this instance of Sun Cluster HA for Netscape LDAP. This is the "Server Port" value you supplied to the `ns-setup` command. The default value is 389.
Takeover flag	Specifies whether a failure of this instance will cause a takeover or failover of the logical host associated with the data service instance. Possible values are `-y` (yes), or `-n` (no).
Probe interval	The time, in seconds, between fault probes. The default interval is 60 seconds.
Probe timeout	The time, in seconds, after which a fault probe will time out. The default timeout value is 30 seconds.