test

Solaris Resource Manager 1.3 Installation Guide

Chapter 1 Installing Solaris Resource Manager 1.3

This chapter provides step-by-step instructions for installing Solaris Resource Manager 1.3 on systems running Solaris 8 SPARC Platform Edition, Solaris 7 SPARC Platform Edition 5/99 or later update release, and Solaris 2.6 SPARC Platform Edition 5/98 with KU patch 105181-11 (or greater) installed.

Note -

Ensure that you have read, understood, and agreed to the terms and conditions set out in the Software License Agreement before installing Solaris Resource Manager.

Before You Begin

Before beginning the installation, note the following:

Supported Hardware

Solaris Resource Manager can be installed on UltraSPARCTM processor systems for all SPARC 4U and 4U-1 platforms produced by Sun Microsystems, Inc. This includes, but is not limited to:

Installing Solaris Resource Manager With Sun Cluster

You can use the Solaris Resource Manager and Sun Cluster products together, and they can be installed in any order. See the guidelines in Chapter 2, Installing Solaris Resource Manager 1.3 in Sun Cluster 3.0 Update Environments for installation information. Also see the Sun Cluster 3.0 12/01 Software Installation Guide, which is available on the docs.sun.com Web site.

Preparing for Installation

As a precautionary measure, do a full backup of your system before installing this product.

Required Patches

Patches can be obtained at http://sunsolve.sun.com or through your normal support channels.

If you plan to perform Dynamic Reconfiguration operations on a Sun Enterprise 3500, Sun Enterprise 4500, Sun Enterprise 5500, or Sun Enterprise 6500 system platform, you must be running at least the 3.2.22 revision of the CPU PROM. If your system is running with a lower version of the CPU PROM, download patch 103346-22 or greater and install it as described in the patch's README file. This patch should be installed on your system before you install Solaris Resource Manager 1.3.

To run Solaris Resource Manager on Solaris 8, you must have patch 108995-04 (or greater) installed on your system. If this patch is not installed, the installation script will automatically install it before it installs the resource capping daemon packages.

If you are running Solaris Resource Manager on Solaris 7, you should install patch 109256-01. This patch prevents the srmadm utility from accepting negative values, which are invalid, for the delta and maxusage tunable parameters. If these parameters are set to invalid values, a Solaris 7 system installed with Solaris Resource Manager can become unusable.

Prior to installing Solaris Resource Manager 1.3 on your Solaris 2.6 SPARC Platform Edition 5/98 system, install these patches:

Note that the Solaris 7 5/99 or later release incorporates KU patch 106541-04, which contains the kernel enhancements necessary to enable Solaris Resource Manager in the Solaris 7 environment. If the patch for the release you are running is revised in the future, you might want to install the updated version on your system.

Disk Space Requirements

Use this table to calculate the approximate disk space required to run Solaris Resource Manager on your system, and verify that the required disk space is available.

Table 1-1 Disk Space Requirements

Volume: / (root)

Size (KB)

System extensions in: /platform/sun4?/kernel

216 

Configuration files in: /etc

62 

Total for / (root) volume

260 

Volume: /usr/lib

138 

Libraries in: /usr/lib

2152 

Volume: /usr

 

Class files in: /usr/lib/class/SHR

36 

Software in: /usr/srm

235 

Total for /usr volume

271 

Volume: /var

 

lnode database in: /var/srm/srmDB

Calculate: Number of users on your system multiplied by 2 KB per user; for example, 200 users would require 400 KB.

 

Changes That Will Be Made to System Files

The following system files are modified when you install Solaris Resource Manager.

Table 1-2 Added System Files

/dev/srmdrv [Created during reboot following installation.]

/etc/init.d/init.srm

/etc/rc0.d/K52srm

/etc/rc1.d/K52srm

/etc/rc2.d/S10srm

/etc/srm/limconf

/etc/srm/nolnode

/etc/system.noshrload

/kernel/drv/srmdrv [ This file is only used in the Solaris Resource Manager 1.0 and 1.1 releases.]

/kernel/drv/srmdrv.conf

/kernel/misc/srmlim

/kernel/sched/SHR

/kernel/sys/srmlimitsys

/usr/lib/srm/liblim.so

/usr/lib/srm/liblim.so.1

/usr/lib/srm/srmscru

/usr/srm/lib/limdaemon

/usr/srm/bin/liminfo

/usr/srm/bin/limreport

/usr/srm/bin/srmkill

/usr/srm/bin/srmstat

/usr/srm/bin/srmuser

/usr/srm/sbin/limadm

/usr/srm/sbin/srmadm

/usr/lib/class/SHR/SHRdispadmin

/usr/lib/class/SHR/SHRpriocntl

/usr/lib/security/pam_srm.so

/usr/lib/security/pam_srm.so.1

Table 1-3 Added System Files, Solaris Resource Manager 1.3 Only

/etc/init.d/rcapd

/etc/rc0.d/K10rcapd

/etc/rc1.d/K10rcapd

/etc/rc2.d/S99rcapd

/usr/srm/bin/rcapstat

/usr/srm/sbin/rcapadm

/usr/srm/sbin/rcapd

/usr/srm/sbin/sparcv7/rcapd

/usr/srm/sbin/sparcv9/rcapd

Table 1-4 Updated System Files

/etc/devlink.tab

/etc/pam.conf

/etc/passwd

/etc/shadow

/etc/system

The following table contains useful but unsupported scripts.

Table 1-5 Unsupported System Files

/usr/srm/unsupport/limid

/usr/srm/unsupport/passwd_lnodes

/usr/srm/unsupport/schedtree

Installing From CD-ROM

Load the Solaris Resource Manager 1.3 CD in the CD-ROM drive. The Solaris Volume Manager (see vold(1M)) will mount the CD-ROM automatically onto the file system.

Note -

If you are installing on a Sun Enterprise 10000, Sun Fire 15K, or Sun Fire 12K server, follow the instructions in the next section.

CD-Mounting on Sun Enterprise 10000, Sun Fire 15K, and Sun Fire 12K Servers

Sun Enterprise 10000, Sun Fire 15K, and Sun Fire 12K servers do not come with a CD-ROM drive directly attached. Instead, the System Service Processor (SSP) includes an internal CD-ROM drive. Thus, any installation instructions that involve software on a CD require two additional steps for these servers:

  1. Insert the Solaris Resource Manager 1.3 CD into the CD-ROM drive of the SSP.

  2. Become the superuser on the SSP and share the CD-ROM:


    ssp# share -F nfs -o ro,anon=0 /cdrom/cdrom0

Sun Enterprise 10000, Sun Fire 15K, and Sun Fire 12K systems are divided into domains, each acting as its own server and running its own instance of the Solaris environment. This means that you must install Solaris Resource Manager 1.3 on each domain where you want to have this functionality available. Whenever the instructions in this guide say "system," read it as "domain" for your Sun Enterprise 10000, Sun Fire 15K, or Sun Fire 12K server.

Note -

You do not need to install Solaris Resource Manager on all of the domains in the platform; you can install it only on the domains in which you need its services.

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:

  1. Log in to the system where you want to install Solaris Resource Manager, and become the superuser:


    $ su
Password:
#

  2. 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.

  3. 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

  4. 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

  5. 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.

  6. 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.

  7. 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.

  8. 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.

  9. 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.

  10. 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.

Where to Now?

When you have successfully installed Solaris Resource Manager and have confirmed that the system is up and running and you can log in, you may want to perform each of these tasks in the order shown.

  1. Use the Solaris Resource Manager 1.3 System Administration Guide to design, set up, and administer Solaris Resource Manager on your system.

  2. Test and monitor the performance of your system to attain the configuration that best suits your needs, and explore the power to manage system resources that this product provides.

Upgrading From Solaris Resource Manager 1.0

If you are currently running Solaris Resource Manager 1.0 on Solaris 2.6 SPARC Platform Edition and want to upgrade to Solaris Resource Manager 1.3 on Solaris 8 SPARC Platform Edition or Solaris 7 SPARC Platform Edition, follow the instructions in this section.

The lnode database for Solaris Resource Manager 1.0 is not compatible with the current Solaris Resource Manager lnode database. To upgrade, you must convert the database using the following script, which should be created with the name savelnodes. 

#!/bin/sh
/usr/srm/bin/limreport 'flag.real' - lname preserve | \
sed 's/,/:/g' | sed 's/services.flag.xterm=.*://g' | sed 's/umask=[0-9]*://g'
To upgrade a Solaris 2.6 system running Solaris Resource Manager 1.0:

  1. Execute the savelnodes script:

    # savelnodes > /export/home/savelnodes.out

  2. Remove the lnode database: 

    # rm /var/srm/srmDB

  3. Remove Solaris Resource Manager 1.0 from your system.

    See Chapter 3, Removing Solaris Resource Manager.

  4. Upgrade Solaris 2.6 to Solaris 8.

    For instructions, see the Solaris 8 Installation Collection.

  5. Install Solaris Resource Manager 1.3.

    Go to the beginning of this chapter.

  6. Execute the limadm command to restore the lnodes:


    # /usr/srm/sbin/limadm set -f /export/home/savelnodes.out

Installing Only the Solaris Resource Manager 1.3 Documentation From the Product CD

The product documentation has been enhanced in the Solaris Resource Manager 1.3 release. The documentation is applicable to all Solaris Resource Manager releases, so even if you are not upgrading your Solaris Resource Manager 1.0, 1.1, or 1.2 software at this time, you should still use the latest documentation.

To update your documentation as described in this section, log in to the system where Solaris Resource Manager is installed and become the superuser.

If you are using the online man pages supplied with Solaris Resource Manager 1.0 or 1.1, you should install the Solaris Resource Manager 1.3 SUNWsrmm package.

To replace the online man pages:

  1. Remove the Solaris Resource Manager 1.0 or 1.1 man pages by typing: 


    # pkgrm SUNWsrmm

  2. Mount the Solaris Resource Manager 1.3 CD as described in Installing From CD-ROM or CD-Mounting on Sun Enterprise 10000, Sun Fire 15K, and Sun Fire 12K Servers if necessary.

  3. Change directories to /SolarisResourceManager_1.3/Solaris_8/sparc/Product/locale/C and type:


    # pkgadd -d . SUNWsrmm

  4. Add /usr/srm/man to the MANPATH variable in the user's environment as described in "Using Online Man Pages" in the Solaris Resource Manager 1.3 Release Notes.

To install the new Solaris Resource Manager 1.3 Collection:

  1. Remove the existing Solaris Resource Manager 1.0 Collection, Solaris Resource Manager 1.1 Collection, or Solaris Resource Manager 1.2 Collection, by typing:


    # pkgrm SUNWsrma

  2. Mount the CD as described in Installing From CD-ROM or CD-Mounting on Sun Enterprise 10000, Sun Fire 15K, and Sun Fire 12K Servers if necessary. Change directories to /SolarisResourceManager_1.3/Solaris_2.6+/sparc/Product/locale/C

  3. Type:


    # pkgadd -d . SUNWsrma

To copy the PDF versions of the Solaris Resource Manager documents onto your system:

  1. Mount the CD as described in Installing From CD-ROM or CD-Mounting on Sun Enterprise 10000, Sun Fire 15K, and Sun Fire 12K Servers if necessary. Change directories to: /SolarisResourceManager_1.3/Solaris_2.6+/sparc/Commmon/Docs/locale/C.

  2. Copy the files onto your system.