test

Sun Cluster 2.2 Data Services Update: Lotus Domino 4.6.3

Installing and Configuring Lotus Domino Partitioned Servers

The partitioned server feature of Lotus Domino 4.6.3 allows multiple Lotus Domino servers to run on a single node. This section describes the steps for installing and setting up partitioned servers on a Sun cluster. See your Lotus Domino documentation for more information about the partitioned server feature itself.

Note -

To install partitioned servers, you must have the license for Lotus Domino Advanced Services.

You can configure partitioned servers in two ways to enable network access:

These guidelines are summarized in the following table. See also "Choosing an Install Location for Lotus Binaries".

Table 1-2 Lotus Domino Server Installation Options

Server 

Installation Location for Binaries 

Single Lotus Domino server 

Local disk on all nodes, or shared disk 

Partitioned server with unique TCP port number 

Local disk on all nodes, or shared disk 

Partitioned server with unique IP address 

Local disk only, on all nodes 

Data directories 

Shared disk only 

How to Install Lotus Domino Partitioned Servers

Use this procedure to install the Lotus Domino partitioned servers and to configure the data directories. Before beginning the installation, note the configuration options described in Table 1-1 and the locations for binaries described in Table 1-2. Refer to your Lotus Domino installation documentation for additional details.

  1. Complete Step 1 through Step 7 in the procedure "How to Install and Configure Lotus Domino" to install the initial Lotus Domino server.

    You must be user root to perform the installation.

    Create the data directories from only one node, to ensure that the partition numbers of the servers are unique.

  2. During the installation, answer yes when prompted for whether to install Lotus Domino Advanced Services.

    This installs partitioned servers.

  3. After the installation is complete, log out as root and log back in as user notes.

    This ensures access to the Lotus Domino server data files.

  4. Set up partitioned servers using the Lotus Domino install program.

    To set up the first partitioned server, invoke the install program with the following command:


    # /opt/lotus/bin/notes

    Use the Lotus Domino install program to set up partitioned servers. During the installation, you will specify the location of the partitioned server binaries to be on either the local or shared disk. See Table 1-2 for more information about installation locations.

    When prompted to create data directories, create them on the shared disk. Create all data directories from one node, to ensure that the partition numbers of the servers are unique.

    Note -

    The primary (initial) Lotus Domino server must be running in order for you to install subsequent partitioned servers, and the names of the subsequent partitioned servers should already be registered with the primary partitioned server. See your Lotus Domino documentation for details.

    To set up subsequent partitioned servers, type the following command:


    # /opt/lotus/bin/notes -u

    Note -

    Make sure that user notes has write permission to all files.

  5. Configure the partitioned servers using the Lotus Domino setup program.

    The setup program comes up automatically after you install each partitioned server.

    Use your Lotus Domino documentation to complete the setup. No special Sun Cluster considerations exist for this portion.

Where to Go From Here

Proceed either to "How to Configure Lotus Domino Partitioned Servers Using Unique IP Addresses" or "How to Configure Lotus Domino Partitioned Servers Using Unique TCP Port Numbers".

How to Configure Lotus Domino Partitioned Servers Using Unique IP Addresses

After installing partitioned server binaries on the local disks and configuring data directories on the shared disk, use the following procedure to configure unique IP addresses for the partitioned servers.

  1. Edit the notes.ini file on each partitioned server to include the appropriate IP address and port number.

    This enables communication between Lotus Notes and the partitioned servers.

    In this sample, IPaddress is the IP address of the host on which the current partitioned server is installed, and port_number is the standard Lotus port number - normally 1352. The port number should be identical in the notes.ini files on all partitioned servers, while the IP address should be different for each file. 


    ...
TCPIP_TCPIPAddress=0,IPaddress:port_number
...

    See your Lotus documentation for more information about the notes.ini file.

Where to Go From Here

Proceed to "Installing and Configuring Sun Cluster HA for Lotus".

How to Configure Lotus Domino Partitioned Servers Using Unique TCP Port Numbers

After installing partitioned server binaries on either the local disk of each node or on the shared disk, and the data directories on the shared disks, use the following procedure to configure unique TCP port numbers for the partitioned servers.

  1. Select one of the partitioned servers to be the port mapper server.

    Note -

    Clients can access the partitioned servers only at a standard port (1352), which is assigned to the port mapper server. The port mapper server processes requests to the other partitioned servers. The port mapper server must be running in order to route requests to the other partitioned servers. Therefore, if the port mapper server is down, new sessions cannot connect. Existing sessions, however, remain connected.

  2. For all partitioned servers other than the port mapper server, assign a unique TCP port number by editing the notes.ini files on those partitioned servers.

    In the notes.ini file on each partitioned server that is not a port mapper server, include one line to define the IP address and port number for that partitioned server. In this example, IPaddress is the shared IP address and port_number is the unique port number of the partitioned server.


    ...
TCPIP_TcpIpAddress=0,IPaddress:port_number
...

  3. Edit the notes.ini file of the port mapper server to include the appropriate TCP settings.

    The notes.ini file on the port mapper server must include an entry for itself, in which the port_number is defined as the standard server port, 1352. Additionally, the file must include entries for all other partitioned servers, in which the port_number fields are defined as unique port numbers.

    In this example, 1352 is the port number of the current port mapper server, servername is the name of each subsequent partitioned server, org is the organization name, IPaddress is the shared IP address, and port_number is the unique port number assigned to each partitioned server.

    The IPaddress should be identical for all entries, but the port_number must be unique for each entry.


    ...
TCPIP_TcpIpAddress=0,IPaddress:1352
TCPIP_PortMapping00=CN=servername0/O=org.IPaddress:portnumber1
TCPIP_PortMapping01=CN=servername1/O=org.IPaddress:portnumber2
TCPIP_PortMapping02=CN=servername2/O=org.IPaddress:portnumber3
TCPIP_PortMapping03=CN=servername3/O=org.IPaddress:portnumber4
...

Where to Go From Here

Proceed to "Installing and Configuring Sun Cluster HA for Lotus".