8.7 Configuring the Sun Cluster HA for Netscape Data Services
After you have installed the Sun Cluster HA for Netscape packages and the Netscape applications, you are ready to configure the individual data services.
Sun Cluster currently supports these Netscape data services: Sun Cluster HA for Netscape News, Sun Cluster HA for Netscape HTTP, Sun Cluster HA for Netscape Mail, and Sun Cluster HA for Netscape LDAP.
Sun Cluster HA for Netscape allows configurable instances, which are independent of each other. For example, you can install and configure any number of web servers; each such server is considered an instance.
All Sun Cluster HA for Netscape data services are configured by using the hadsconfig(1M) command.
8.7.1 How to Configure the Sun Cluster HA for Netscape Data Services
-
Run the hadsconfig(1M) command to configure your Sun Cluster data service(s).
The hadsconfig(1M) command is used to create, edit, and delete instances of a Sun Cluster HA for Netscape data service. See the hadsconfig(1M) man page for details. Refer to "8.7.2 Configuration Parameters for the Sun Cluster HA for Netscape Data Services", for information on the input to supply to hadsconfig(1M).
phys-hahost1# hadsconfig
Note -Sun Cluster HA for Netscape News and Sun Cluster HA for Netscape HTTP support installation of multiple instances of news and http servers, which can be located anywhere in the cluster. Because the mail protocol listens to a well-known port, only one instance of Sun Cluster HA for Netscape Mail can exist in a cluster.
-
Register the Sun Cluster HA for Netscape data services.
Register the data services by running the hareg(1M) command.
If you installed the data service packages on all potential masters of a logical host but not on all hosts in the cluster, use the -h option and specify the logical host name.
Table 8-3 Data Service Registration Names and SyntaxData Service
Registration Syntax
Sun Cluster HA for Netscape HTTP
hareg -s -r nshttp [-h logicalhost]
Sun Cluster HA for Netscape News
hareg -s -r nsnews [-h logicalhost]
Sun Cluster HA for Netscape Mail
hareg -s -r nsmail [-h logicalhost]
Sun Cluster HA for Netscape LDAP
hareg -s -r nsldap [-h logicalhost]
-
Run the hareg -Y command to enable all services and perform a cluster reconfiguration.
phys-hahost1# hareg -Y
The configuration is complete.
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. |
|
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. |
- © 2010, Oracle Corporation and/or its affiliates