13.2 Loading the PSE Software Kit

This section describes how to load the PSE kit onto each PSE cluster member.

13.2.1 Registering Your Software License

The PSE software includes support for the License Management Facility (LMF). You must register your License Product Authorization Key (License PAK) in the License Database (LDB) of each PSE cluster member in order to use the PSE software. The License PAK is shipped along with the kit if you ordered the license and media together; otherwise, it is shipped separately to a location based on your license order.

If you are installing the PSE software as an update on a PSE cluster member already licensed for this software, you have already completed the License PAK registration requirements.

If you are installing prerequisite or optional software along with the PSE software, review the PAK status and install the PAKs for any prerequisite or optional software before you install the PSE software.

To register a license, log in as superuser root .

At the superuser prompt, edit the partially completed PAK template in /var/adm/lmf/template and save it as /var/adm/lmf/PSE-O . Use the lmf register command to add your unique License PAK information as follows:

#  lmf register -</usr/var/adm/lmf/PSE-O

PSE-O is the LMF product name on the License PAK.

After you register your license, use the following LMF command to copy the license details from the LDB to the kernel cache:

#  lmf reset

For More Information:

On using the License Management Facility, see the Digital UNIX Software License Management Manual and the lmf(8) man page.

13.2.2 Deleting Existing PSE Software Subsets

Before loading a new version of the PSE software, any previous versions of the software must be deleted.

If you are upgrading from a previous version of PSE, Digital recommends you follow the upgrading procedure detailed in the release notes.

To delete PSE software, you must be superuser (username root ). Make sure there are no HPF applications currently running. The command for deleting PSE software is:

# cd /
# setld -d PSEHPFnnn PSEPPEnnn PSEWSFnnn PSEKBINxxxnnn PSEMANnnn

Replace nnn with the PSE version number (e.g. 080 for version 0.8), and xxx with the Digital UNIX version number (e.g. 320 for version 3.2).

For More Information:

On upgrading from a previous version of PSE, see the instructions in the release notes.

13.2.3 Installing and Starting a PSE Cluster

This section summarizes the PSE software installation procedure, and explains the starting of a basic PSE cluster.

13.2.3.1 PSE Installation Summary

This section contains a brief summary of the PSE software installation procedure. The procedure is explained in detail in Chapter 14.

To load the PSE software kit onto a host, follow these steps:

For installation from a CD-ROM:
1. Log in as superuser (login name root ).
2. Type the following commands (substitute your CD-ROM drive name for rzxxc .
```
# cd /
# mount -rd /dev/rzxxc /mnt
# setld -l /mnt/pse120/kit
```
3. Refer to Section 13.1.1.4.3 to select the appropriate subsets.
For installation from an RIS (Remote Installation Service) server:
1. Log in as superuser (login name root ).
2. Type the following commands (substitute your RIS server for nodename):
```
# cd /
# setld -l nodename:
```
3. Refer to Section 13.1.1.4.3 to select the appropriate subsets.

For More Information:

On using setld to install the PSE software, see Chapter 14.
On using the pse-remote-install utility to propagate the PSE software to other hosts, see Section 13.3 and Chapter 15.
On setld , see the setld(8) manpage.

13.2.3.2 Formation of a Basic PSE Cluster

A fully-functioning PSE cluster is established merely by installing the PSE software on one or more hosts in the same IP subnet.

The installation script for the PSE system software subset (PSEWSF120) automatically configures the system to start a farmd daemon for a basic PSE cluster named "psefarm". This is a special cluster which does not require a database. The farmd daemon for the basic PSE cluster provides a default PSE cluster containing a single partition, called "all-hosts".

The farmd daemon for the basic PSE cluster also detects the presence of other farmd daemons in the same network segments, and adds new nodes to the "all-hosts" partition.

13.2.3.3 Installing PSE Software in a Dataless Environment

This section applies only if you want to propagate the PSE kit to Dataless Management Services (DMS) clients. For all other types of installation, continue with Section 13.3.

Use the dmu utility on the DMS server to build a dataless environment and to install the PSE Software (the pse- remote-install utility cannot be used for DMS clients). Refer to the dmu(8) manpage and the Digital UNIX manual Sharing Software on a Local Area Network for detailed instructions.

To install the PSE Network Kernel Binaries subset for Digital UNIX V3.0 PSEKBIN300120 on all the DMS clients, execute the following steps on the DMS server after you install the PSE software, but before you configure the dataless environment:

% su
Password:
# cd /var/adm/dms/dms[n].alpha/root/usr/sys/UDP_PRIME
# ./Install

This replaces several kernel object files in the environment with the UDP_PRIME kernel object files. In configuring the dataless environment, dmu builds a DATALESS kernel using the replaced kernel object files.

For existing clients to have access to the newly installed software subsets, delete the clients from the old environment and add them to the newly configured environment.

Like all other PSE cluster members, a dataless client PSE cluster member must satisfy the PSE cluster member requirements listed in Section 13.1.2.

Once a client is configured, verify your configuration. Details for configuration verification are described in Section 13.5.