Solaris Resource Manager 1.3 Installation Guide

Installing the Packages

There are eleven packages in the Solaris Resource Manager 1.3 product. These packages contain all the software, documentation, and other files required to run Solaris Resource Manager.

Note -

Only install the three Solaris AnswerBook2 Version 1.4 Documentation Server packages (SUNWab2r, SUNWab2s, and SUNWab2u) from the product CD if you are installing Solaris Resource Manager on a system running Solaris 2.6 or Solaris 7 5/99. Solaris 7 8/99, Solaris 7 11/99, and Solaris 8 systems are shipped with later versions of the AnswerBook2 server that you do not want to overwrite.

Table 1-6 Solaris Resource Manager 1.3 Packages


Package	Title	OS
`SUNWrcapm`	Solaris Resource Capping Daemon Man Pages	Solaris 8 (SPARC Platform Edition)
`SUNWrcapr`	Solaris Resource Capping Daemon (Root)	Solaris 8 (SPARC Platform Edition)
`SUNWrcapu`	Solaris Resource Capping Daemon (User)	Solaris 8 (SPARC Platform Edition)
`SUNWrcapx`	Solaris Resource Capping Daemon (64-bit)	Solaris 8 (SPARC Platform Edition)
`SUNWsrma`	Solaris Resource Manager 1.3 Collection (AnswerBook2)	Solaris 2.6 (SPARC Platform Edition) Solaris 7 (SPARC Platform Edition) Solaris 8 (SPARC Platform Edition)
`SUNWsrmb`	Solaris Resource Manager 1.3 User Commands	Solaris 2.6 (SPARC Platform Edition) Solaris 7 (SPARC Platform Edition) Solaris 8 (SPARC Platform Edition)
`SUNWsrmm`	Solaris Resource Manager 1.3 Man Pages (Note that entries associated with the Solaris Resource Capping Daemon are in the `SUNWrcapm` package)	Solaris 2.6 (SPARC Platform Edition) Solaris 7 (SPARC Platform Edition) Solaris 8 (SPARC Platform Edition)
`SUNWsrmr`	Solaris Resource Manager 1.3 Libraries and System Utilities	Solaris 2.6 (SPARC Platform Edition) Solaris 7 (SPARC Platform Edition) Solaris 8 (SPARC Platform Edition)
`SUNWab2r`, `SUNWab2s`, `SUNWab2u`	Solaris AnswerBook2 v1.4 documentation server	Solaris 2.6 (SPARC Platform Edition) Solaris 7 5/99 (SPARC Platform Edition)

To install the packages:

Log in to the system where you want to install Solaris Resource Manager, and become the superuser:
$ su Password: #

Bring the system down to single-user system administration mode:
# shutdown -i 1
Note -
This step is not necessary on Sun Enterprise 10000, Sun Fire 15K, and Sun Fire 12K servers.

Change directories to the location where the CD has been mounted:
# cd /cdrom/cdrom0
Note -
On Sun Enterprise 10000, Sun Fire 15K, and Sun Fire 12K servers, you must NFS mount the CD from the SSP that has the internal CD-ROM drive before changing directories:
# mkdir -p /cdrom/cdrom0 # mount -F nfs ssp:/cdrom/cdrom0 /cdrom/cdrom0 # cd /cdrom/cdrom0

To ensure that the CD-ROM is mounted correctly, do a listing of the directory and verify that these files appear:
# ls Copyright SolarisResourceManager_1.3 Installer Uninstaller README_en

Start the product installation tool, Installer.

If the system reports that the package already exists, see Resolving Installation Problems before continuing.

# ./Installer

The two product packages, SUNWsrmb and SUNWsrmr, will be installed first. You will see a processing message similiar to this:

Installing.....Solaris Resource Manager 1.3 (SRM)

Processing package instance <SUNWsrmb> from
 </cdrom/srm_1_3/SolarisResourceManager_1.3/Solaris_8/sparc/Product/locale/C>

Solaris Resource Manager
(sparc) 1.3,REV=2002.09.12.12.52
Copyright 2002 Sun Microsystems, Inc. All rights reserved.
Copyright 2002 Sun Microsystems, Inc. Tous droits reserves.

## Processing package information.
## Processing system information.
## Verifying package dependencies.
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.

You will be warned that the package contains scripts that will be run with superuser privileges. Since these scripts are part of the normal package installation process and are required to install the software correctly, type y when asked if you want to continue the installation:

This package contains scripts which will be executed with super-user 
permission during the process of installing this package. 
Do you want to continue with the installation of <SUNWsrmb> [y,n,?] y

As the package is installed onto the system, it will display various messages about the installation process. The package should install in a minute or two.

Installing Solaris Resource Manager as <SUNWsrmb>
## Installing part 1 of 1.
/usr/srm/bin/liminfo
/usr/srm/bin/limreport
/usr/srm/bin/srmkill
/usr/srm/bin/srmstat
/usr/srm/bin/srmuser
/usr/srm/lib/limdaemon
/usr/srm/sbin/limadm
/usr/srm/sbin/srmadm
/usr/srm/unsupport/passwd_lnodes
/usr/srm/unsupport/schedtree
[ verifying class  ]

After the successful installation of the first two packages, this message will display:

Installation of <SUNWsrmr> was successful.

Note -

During the installation, make sure that you read all the information and carefully follow the instructions displayed on the screen. If you make a mistake, you must wait until the Installer command finishes, and then use Uninstaller to remove Solaris Resouce Manager and revert the system to its original state. You can then install the software again as described in Step 5.

If you are installing Solaris Resource Manager 1.3 on Solaris 8, you will then be prompted to install the SUNWrcapr, SUNWrcapu, SUNWrcapx, and SUNWrcapm packages. These packages contain the resource capping daemon functionality documented in "Physical Memory Management Using the Resource Capping Daemon" in Solaris Resource Manager 1.3 System Administration Guide. To install the packages at this time, type y at the prompt. The script will automatically install the required patches for Solaris 8 to enable resource capping functionality.

You will then be prompted to install the SUNWsrmm, SUNWab2r, SUNWab2s, SUNWab2u, and SUNWsrma packages. You should skip this step unless you are running Solaris 2.6 or Solaris 7 5/99. To install the packages at this time, type y at each prompt.

Note -
If you are running Solaris 2.6 or Solaris 5/99 and you choose to install the AnswerBook2 server, you will be warned that some of the files are already installed on the system and are being used by another package, and that attribute changes will be made. You should choose to install the updated AnswerBook2 server supplied with Solaris Resource Manager by typing y at the prompt.

The server is compatible with both Solaris 2.6 and Solaris 7 AnswerBook2 collections.

Note -
If you encountered any errors or problems during the installation process, refer to Chapter 4, Troubleshooting. Do not continue with system configuration if these packages were not successfully installed.

During the installation of the SUNWsrmr package, three special users were created: srmidle, srmlost, and srmother (for the "idle," "lost," and "other" lnodes, respectively).

User Name

UID

srmidle

41

srmlost

42

srmother

43

Verify that these UIDs are not in conflict with any existing UIDs on the system by typing:
# /usr/bin/egrep 41\|42\|43 /etc/passwd
If a conflict exists, you can change the UIDs by editing the password and shadow files, /etc/passwd and /etc/shadow.

Note -
These special users do not require home directories or login access. The names srmlost and srmidle are only recommended default names. If desired, you can use other names and override the defaults by adding assignments for LostLnode and IdleLnode in /etc/init.d/init.srm. The name srmother is assigned by the system and cannot be changed.

User Name	UID
`srmidle`	41
`srmlost`	42
`srmother`	43

Reboot the system. During the reboot sequence, make a note of any errors, particularly those related to device driver configuration.

# reboot

When the system is coming up for the first time with Solaris Resource Manager enabled, it will automatically perform some necessary initial configuration that may take a while. This includes creating a new Solaris Resource Manager database by scanning the password file for users registered on the system. You should see messages similar to these:

SunOS Release 5.8 Version Generic 64-bit [UNIX(R) System V Release 4.0]
Copyright (c) 1983-2002, Sun Microsystems, Inc.
Solaris Resource Manager v1.2.1 (allocated 990 lnodes)
configuring IPv4 interfaces: hme0.
Hostname: example
Configuring the /devices directory
Configuring the /dev directory
Configuring the /dev directory (compatibility devices)
The system is coming up.  Please wait.
Enabling Solaris Resource Manager.
SRM database '/var/srm/srmDB' not present -  creating empty database
SRM - creating user lnodes; may take a while
 uid      37
Solaris Resource Manager Enabled.
...
The system is ready.

Once the system has come up and you have logged in on the console, you should see messages similar to these:

Last login: Mon Mar 3 08:40:09 on console 
Sun Microsystems Inc. SunOS 5.8

Note -

If you encountered any errors or problems during the reboot process or when logging in, refer to Chapter 4, Troubleshooting.