Sun Cluster 2.2 Software Installation Guide

Netscape Mail

Sun Cluster HA for Netscape Mail can be used with Netscape Mail or with Netscape Messaging Server. This section describes the steps to take when installing Netscape Mail to enable it to run as the Sun Cluster HA for Netscape Mail data service. If you are using Netscape Messaging Server, see "Netscape Messaging Server".

The Sun Cluster HA for Netscape Mail data service is an asymmetric data service. Only one logical host in the cluster provides the mail services.

Note -

The Sun Cluster HA for Netscape Mail service fault probing might cause /var/log/syslog to fill up quickly. To avoid this, disable logging of mail.debug messages in the /etc/syslog.conf file by commenting out the mail.debug entry and sending a HUP signal to the syslogd(1M) daemon.

The following are required on the Sun Cluster servers before configuring Sun Cluster HA for Netscape Mail:

Each server must have a unique user ID and unique group ID that contains only this unique user ID. These particular IDs will be used by the mail system. The names and numbers must be identical on all servers running Sun Cluster HA for Netscape Mail.
DNS must be configured and enabled on all servers running Sun Cluster HA for Netscape Mail. All Sun Cluster servers must have the same /etc/resolv.conf file, and the hosts entry in the /etc/nsswitch.conf file must include dns.

Because Netscape Mail is installed on one server, Sun Cluster HA for Netscape Mail requires some variation from the default installation parameters, notably:

Specifying the logical host name rather than the physical host name
Installing the Netscape Mail software and spool directories on the multihost disks
Do not use the default server root disk when prompted, your files must reside on the multihost disk
When supplying the base install directory pathname, this should be the location of the start and stop scripts

How to Install Netscape Mail

Before you begin this procedure, complete the appropriate pre-requisite steps listed in Table 8-2.

This procedure shows the user interaction with the ns-setup command and Sun Cluster commands. Only the sections that are specific to Sun Cluster HA for Netscape Mail are shown here. For the other sections, choose or change the default value as appropriate.

All of the steps in this procedure must be performed as root.

Make sure each logical host is served by its default master.

The Netscape application will be installed from the physical host that is the logical host's default master. If necessary, switch over the logical hosts to be served by their respective default masters.

Note -
The logical host names you use in your Sun Cluster configuration should be used as the server names when you install and configure the Netscape application in the following steps. This is necessary for failover of the Netscape server to work properly.

Run the ns-setup command from the Netscape Mail install directory on the CD.

Change directory to the Netscape Mail distribution location on the CD, and run the ns-setup command:

phys-hahost1# cd /cdrom/commerce/solaris/us/https/mail
phys-hahost1# ./ns-setup

Note -

The Netscape directory on the CD might be different from that shown in the example. Check your Netscape documentation for the actual location.

After the licensing agreement you should see something like the following:

Netscape Communications Corporation 
Netscape SuiteSpot Server Installation
---------------------------------------------------------------
This program will extract the server files from the distribution
media and install them into a directory you specify. This 
directory is called the server root and will contain the server 
programs, the Administration Server, and the server configuration 
files.

Server root [/usr/netscape/suitespot]:
To accept the default in brackets, press return.

Enter the logical host name for the Netscape Web Server and the appropriate DNS domain name.

A full name is of type hostname.domainname, such as hahost1.sun.com. You can enter any directory name you might have created for the data service here as well.

Note -
You must use the logical host name rather than the physical host name here and everywhere else you are asked, for Sun Cluster HA for Netscape Mail to fail over correctly.

For example:
Machine's name [phys-hahost1]: hahost1
Follow the screen instructions (in many cases you may want to accept the default choices) for the server installation.

Enter Server Administrator ID and password when asked.

Follow the guidelines for your system.

Note -
The default administration port is not the port on which the data services will listen, so it is an acceptable default.

You see information similar to the following:
Attempting to start Netscape Admin Server...
Continue with the installation when prompted.

Specify user, group, and domain names.

Enter the user name you configured for the mail server on all Sun Cluster servers running Sun Cluster HA for Netscape Mail.

Specify directories for system components.

You are asked the names of directories where the various components of the system will be installed. Enter a location on the logical host, for example, /hahost1/mail/mailbox, and /hahost1/mail/postoffice.

Specify a Server Identifier name.

Specify whether to use the NIS module and the Greeting Forms feature.

You see a confirmation of the information you specified as in the following example:

Mail user name: 
Domain name: 
Mailbox directory: 
Post Office directory: 
Server Identifier: 
NIS lookups: 
Greeting forms: 

You may accept these choices or quit the installation.

Install Netscape Messaging Server? [y]:

Install the Netscape Messaging Server and reply to queries when prompted.

Depending on how you set up your configuration, specify items appropriately. After all changes take effect, you see:
Netscape Messaging Server installation complete

Start the Netscape Messaging Server when prompted.

If the service is not yet registered, use the hareg(1M) command to register it.

To register the service only on the logical host, include the -h option and logical host name:
# hareg -s -r nsmail [-h logicalhost]

Run the hadsconfig command from the physical host:
[phys-hahost1]: hadsconfig

Enter the number for the nsmail menu item at the prompt.

Your choices may vary depending on the services installed.

Enter the number for the Create a new instance item at the prompt.

Name of the instance [nsmail]  [?]
Logical host [?] 
Take over flag [y]

Following are the specifications of this instance
Name of the instance : 
Logical host : 
Number of times to retry : 
Time between retries (sec) : 
Configuration File : 
Fault probe program : 
Time between probes (sec) : 
Time out value for the probe (sec) : 
Take over flag : 
Add this instance ?  (yes/no) [yes] 
Instance added to workfile
Press enter to return to main menu

Enter the name for the instance.

Enter your logical hostname.

Either accept or change the defaults for the remaining items depending on your configuration.

You can change these defaults now if necessary.

Add this instance.

You see Instance added to workfile.

Go to the Main Menu when prompted.

You see Configuration has changed in workfile.

Update the configuration from the workfile when prompted.

Enter the Quit menu item number.

Return to the root prompt of your physical host.

Register and activate the service by using the hareg(1M) command.

Run the hareg(1M) command on only one host.
# hareg -y nsmail

This completes the installation of Netscape Mail.