C H A P T E R  1

SMS 1.2 on the Sun Fire 15K Server Systems

This chapter contains reinstallation and upgrade instructions for System Management Services 1.2 software under the Solaris 9 operating environment. These instructions apply to the Sun Fire 15K server systems.

The SMS reinstall and upgrade setup focuses on setting up group IDs used for credential checking, and setting up and running control scripts that start SMS when the Solaris operating environment boots.

This chapter includes:


Introduction

SMS 1.2 first became available on Solaris 8 02/02. That version (SMS 1.2_s8) will not run on Solaris 9 05/02. This version of SMS 1.2 (SMS 1.2_s9) will not run on Solaris 8 02/02.

The SMS packages use approximately 18GBytes each of disk space on two disks on the server. The following table lists the total size of the SMS software by partition.

TABLE 1-1 SMS Software Approximate Partition Sizes

Partition

Size

0 /(root)

8 Gbytes

1 /swap

2 Gbyte

4 OLDS/LVM database (metadb)

10 Mbytes

5 OLDS/LVM database (metadb)

10 Mbytes

7 /export/install

8 Gbytes


SMS requires two drive partitions with at least 10 Mbytes be dedicated to each metadevice state database copy.

The following sections contain overviews of the reinstallation and upgrade process, which require you to use sections from different publications and files. You should ensure that you have the following publications and printouts before you start the reinstallation or upgrade.



Note Note - You must run the same version of SMS on both SCs.





Note Note - Any patches to the Solaris operating system should be applied before re-installing SMS software.



For the examples in this guide:

Prompt

Definition

sc0 :#

Superuser on SC, initially the main SC

sc1 :#

Superuser on SC1, initially the spare SC

domain_id :#

Superuser on the domain

sc_name : sms-user:>

User prompt on the SC.

sms-user is the user-name of an administrator, operator, configurator or service personnel logged in to the SC.

domain_id : sms-user:>

User prompts on the domain

sms-user is the user-name of the administrator, operator, configurator or service personnel logged in to the domain.



Preparing to Reinstall

Your Sun Fire 15K system is preinstalled with SMS 1.2 for Solaris 9 (SMS 1.2_s9) software when you receive it. The reinstallation instructions in this section assume that your system is already running the Solaris 9 05/02 operating environment.

Performing a Reinstallation

To reinstall SMS software you will need to perform the following procedures:

To begin reinstallation proceed to Downloading SMS Software .


Preparing to Upgrade

The following table contains a high level overview of the possible SMS software combinations on a single SC and their upgrade paths:

Current Version

New Version

OS Installation Type

Path

Solaris 8/SMS 1.1

Solaris 9/SMS 1.2_s9 (for Solaris 9)

Fresh Install- Type 1

Backup your SMS 1.1 configuration

Install Solaris 9

Install SMS 1.2_s9

Restore your SMS 1.1 configuration

Solaris 8/SMS 1.1

Solaris 9/SMS 1.2_s9

Upgrade -Type 2

Backup your SMS 1.1 configuration

Install SMS 1.2_s9

Switch versions

Restore your SMS 1.1 configuration

Upgrade Solaris 9

Solaris 8/ SMS 1.2_s8 (for Solaris 8)

Solaris 9/SMS 1.2_s9

Fresh Install- Type 1

Backup your SMS 1.2_s8 configuration

Install Solaris 9

Install SMS 1.2_s9

Restore your SMS 1.2_s8 configuration

Solaris 8/ SMS 1.2_s8

Solaris 9/SMS 1.2_s9

Upgrade - Type 1

Backup your SMS 1.2_s8 configuration

Upgrade Solaris 9

Install SMS 1.2_s9

Restore your SMS 1.2_s8 configuration




Note Note - smsversion does not support a return to SMS 1.1 or SMS 1.2_s8 in this release of SMS 1.2 for Solaris 9. To return to SMS 1.1 or SMS 1.2_s8 you must return to the applicable Solaris 8 operating environment.



Performing a Type 1 Installation

To fresh install the Solaris 9 operating environment with SMS 1.2_s9 software from Solaris 8 with SMS 1.1 or 1.2_s8 software; or to upgrade from Solaris 8 with SMS 1.2 software, you will be performing the following procedures:

To begin Type 1 upgrade proceed to Downloading SMS Software .

Performing a Type 2 Installation

To upgrade from the Solaris 8 and SMS 1.1 software to the Solaris 9 operating environment and SMS 1.2 software, perform the following procedures:

To begin Type 2 upgrade proceed to Downloading SMS Software .

Downloading SMS Software

You can retrieve SMS software from either the web or on the Sun Computer Systems Supplement CD.


procedure icon  To Download Software From the Web

1. Using your web browser, go to http://www.sun.com/servers/sw/

2. Click the System Management Services (SMS) link.

3. Click the Click here to download link.

The file that is then downloaded is named sms_1_2_sparc.zip .

4. Log in to the SC as superuser.

5. Change directory to the location where you downloaded the software:

sc1:# cd /download_directory

6. Extract the downloaded file by typing:

sc1:# unzip sms_1_2_sparc.zip

The SMS 1.2 packages are located in / download_directory /sms_1_2_sparc/System_Management_Services_1.2/Product .

7. Proceed to Backing Up Your SMS Environment .


procedure icon  To Download Software From a CD-ROM

1. Insert the Software Supplement for the Solaris 9 05/02 Operating Environment CD-ROM into the CD-ROM drive.

Allow time for the Volume Manager to mount the CD-ROM.

The SMS 1.2 packages are located in /cdrom/cdrom0/System_Management_Services_1.2/Product .

2. Log in to the system controller as superuser.

3. Change to the Product installation directory:

sc1: # cd /cdrom/cdrom0/System_Management_Services_1.2/Product

4. Proceed to Backing Up Your SMS Environment .

Backing Up Your SMS Environment

If this SC has a working SMS environment, you should do the following before attempting to reinstall the SMS software:


procedure icon  To Backup Your SMS Environment

On the main SC:

1. Make certain your configuration is stable.

Being stable means no commands are running and no hardware is changed during the reinstallation or upgrade process.

2. Log in to the main SC as a user with platadmn privileges.

3. Deactivate failover:

sc0:# /opt/SUNWSMS/bin/setfailover off 

On the spare SC:

1. Log in to the spare as superuser.

2. Stop SMS on the spare SC (SC1):

sc1:# /etc/init.d/sms stop 

3. Backup the system on the spare SC.

Run smsbackup before proceeding or have the latest copy of the smsbackup file ( sms_backup.X.X.cpio ) accessible to the disk.

sc1:# /opt/SUNWSMS/bin/smsbackup directory_name 

where:

directory_name is the name of the directory in which the backup file is created. The directory_name requires the absolute path name for the file. This file can reside in any directory on the system, connected network or tape device to which you have read/write privileges. If no directory_name is specified, a backup file is created in /var/tmp .

The directory_name specified must be mounted on as a UFS file system. Specifying a TMPFS file system, such as /tmp , will cause smsbackup to fail. If you are not certain that your directory_name is mounted as a UFS file system, type:

sc1:# /usr/bin/df -F ufs directory_name

A UFS file system will return directory information. Any other type of file system will return a warning.

Type 1 Installation or Upgrade of the Solaris Operating Environment on the Spare SC


Note Note - Do this now only if you are performing a Type 1 installation. Otherwise proceed to Installing SMS Packages.




procedure icon  To Install or Upgrade the Solaris Operating Environment

1. Install or upgrade the Solaris 9 operating environment according to the Solaris installation instructions. Refer to the Solaris 9 (SPARC Platform Edition) Installation Guide for detailed installation instructions.

The instructions in the following sections assume that your system is running the Entire Distribution software group (or higher) of the Solaris 9 05/02 operating environment. SMS 1.2_s9 does not run under software releases earlier than Solaris 9 05/02 or software groups less than Entire Distribution . Any relevant patches should be applied according to each patch's instructions.

2. Once your operating environment has been successfully installed proceed to Installing SMS Packages .

Installing SMS Packages

To install SMS software packages, follow the steps in the procedure To Install SMS Packages Using Web Start or To Manually Install the SMS Software Packages .


procedure icon  To Install SMS Packages Using Web Start

You can use Web Start to perform a reinstall from the web or CD-ROM.

1. Log in to the spare SC as superuser.

2. Set the DISPLAY environment variable to your current host.

For sh (1) or ksh (1), type:

sc1: #  DISPLAY=hostname:0
sc1: #  export DISPLAY

where:

hostname is the host name of the machine used to graphically display Web Start.

For csh (1) type:

sc1: #  setenv DISPLAY hostname:0.0

where:

hostname is the host name of the machine used to graphically display Web Start.

3. Change directory to the location of the SMS 1.2 package:

4. Begin Web Start by typing:

sc1: # ./installer

The Welcome screen appears:

5. Click on Next.

The Select Type of Install dialog box appears:

6. Click on Next.

The Locale dialog box appears:

English is the default, there is no box to check. Click on next.

7. Select Custom Install.

With custom installation, only the products that you select are installed.

8. Click on Next.

The Product Selection dialog box appears:

Make sure all products but SMS are set to No Install. Choose Default Install for SMS.

9. Click on Next.

The Ready to Install dialog box appears:

10. Verify that you have sufficient disk space to cover the requirements displayed on the Ready to Install dialog box.


Note Note - Web Start automatically installs the online System Management Services (SMS) Reference Manual (man) pages in /opt/SUNWSMS/man/sman1m. To avoid conflicts, do not change this location.



11. Click the Install Now button.

The Installing screen appears:

Wait until the installation is complete and the Installation Summary dialog box is displayed.

12. Click on Next.

The Additional Information dialog box appears:

13. Click on Exit.

14. Proceed to To Restore Your SMS Configuration .


procedure icon  To Manually Install the SMS Software Packages

1. Log in to the spare SC as superuser.

2. Change directory to the location of the SMS 1.2 package:



Note Note - The pkgadd(1M) command automatically installs the online System Management Services (SMS) Reference Manual (man) pages in /opt/SUNWSMS/man/sman1m. To avoid conflicts, do not change this location.





caution icon

Caution 3. It is extremely important that you install the SUNSMSr package first and then the SUNWSMSop package second. All other packages can be installed in any convenient order after the first two.



Package Number

Package Name

Package Description

11

SUNWSMSr

System Management Services (Root)

7

SUNWSMSop

System Management Services Core Utilities

1

SUNWSMSdf

System Management Services Data Files

2

SUNWSMSjh

System Management Services On-Line Javahelp

3

SUNWSMSlp

System Management Services LPOST object files

4

SUNWSMSmn

System Management Services On-Line Manual Pages

5

SUNWSMSob

System Management Services OpenBoot PROM

6

SUNWSMSod

System Controller OpenBoot PROM

8

SUNWSMSpd

System Controller Power On Self Test

9

SUNWSMSpo

System Management Services POST Utilities

10

SUNWSMSpp

System Management Services picld (1M) Plug-in Module

12

SUNWSMSsu

System Management Services Service User Environment

13

SUNWscdvr.u

Sun Fire 15K System Controller drivers

14

SUNWufrx.u

User Flash PROM Device Driver (Root) (64-bit)

15

SUNWufu

User Flash PROM Device Driver Header Files


4. Add packages using the pkgadd (1M) command.

sc1: # pkgadd -d .

The system displays the list of available packages.

The following packages are available:
 1 SUNWSMSdf  System Management Services Data Files
        (sparc) 1.2.0,REV=2001
 2 SUNWSMSjh  System Management Services On-Line Javahelp
        (sparc) 1.2.0,REV=2001
 3 SUNWSMSlp  System Management Services LPOST object files
        (sparc) 25.0.0,REV=2.0.0
 4 SUNWSMSmn  System Management Services On-Line Manual Pages
        (sparc) 1.2.0,REV=2001
 5 SUNWSMSob  System Management Services OpenBoot PROM 
        (sparc) 1.2.0,REV=2001
 6 SUNWSMSod   System Controller OpenBoot PROM
        (sparc) 1.2.0,REV=2001
 7 SUNWSMSop  System Management Services Core Utilities
        (sparc) 1.2.0,REV=2001
 8 SUNWSMSpd  System Controller Power On Self Test
        (sparc) 1.2.0,REV=2001
 9 SUNWSMSpo  System Management Services POST Utilities
        (sparc) 1.2.0,REV=2001
10 SUNWSMSpp  System Management Services picld(1M) Plug-in Module
        (sparc) 1.2.0,REV=2001
11 SUNWSMSr   System Management Services, (Root)
        (sparc) 1.2.0,REV=2001
12 SUNWSMSsu  System Management Services Service User Environment
        (sparc) 1.2.0,REV=2001
13 SUNWscdvr.u  Sun Fire 15K System Controller drivers
        (sparc) 1.2.0,REV=2001
14 SUNWufrx.u  User Flash PROM Device Driver (64-bit), (Root)
        (sparc) 2.0,REV=2001
15 SUNWufu  User Flash PROM Device Driver Header Files
        (sparc) 2.0,REV=2001

5. Enter the list of package numbers that you want to install, separated by commas.

In this example, 11 and 7 are SUNSMSr and SUNWSMSop respectively and must be listed first and second.

Select package(s) you wish to process (or `all' to process all packages). (default: all) [?,??,q]: 11,7,1-6,8-10,12-15

6. Answer y (yes) to all package installation queries.

7. Verify that all the packages were completely installed.

sc1: # pkginfo -c SMS

sc1: # pkginfo -i SUNWufrx SUNWufu

8. (Optional) List the names of any packages that are partially installed.

sc1: # pkginfo -p

If any packages are listed, remove and reinstall them. If this does not correct the problem, contact your Sun service representative.

9. You have completed the manual installation of software packages.

10. Proceed to To Restore Your SMS Configuration .

Restoring Your SMS Configuration on the Spare SC


procedure icon  To Restore Your SMS Configuration

1. Restore your SMS configuration.

For Reinstallation or Type 1 installation:

Run smsrestore to restore the smsbackup file, then proceed to To Configure the Management Network (MAN) Using smsconfig(1M) .

sc1:# /opt/SUNWSMS/bin/smsrestore filename

where:

filename is the absolute path to the backup file that was created by smsbackup (1M). The filename must contain the full path name for the file. This file can reside anywhere on the system, connected network or tape device. If no filename is specified, you will receive an error.



Note Note - Once smsrestore completes you will see the following message: "Please set the desired SMS failover state." Ignore this message.



For Type 2 installation:

Run smsversion then smsrestore .

sc1:#/opt/SUNWSMS/bin/smsversion  
smsversion: Active SMS version <1.1> 
smsversion: SMS version 1.1 installed smsversion: 
SMS version 1.2 installed 
Please select from one of the following installed SMS versions. 
1) 1.1 
2) 1.2 
3) Exit 
Select version: 2
You have selected SMS Version 1.2
Is this correct? [y,n] y
smsversion: Upgrading SMS from <1.1> to <1.2>.
To move to a different version of SMS an archive of
critical files will be created. What is the name of
the directory or tape device where the archive will be stored? [/var/tmp][return]
smsversion: Backup configuration file created: /var/tmp/sms_backup.1.1.cpio
smsversion: Switching to target version <1.2>.
smsversion: New Version <1.2> Active
smsversion: Active SMS version <1.2>
To use the previous SMS configuration settings type: 
smsrestore /var/tmp/sms_backup.1.1.cpio
NOTE: When switching to another SMS version, the user must choose
 (via use of smsrestore) to restore the configuration settings
 from the previously active version.

sc1:# /opt/SUNWSMS/bin/smsrestore filename 

where:

filename is the absolute path to the backup file that was created by smsbackup (1M). The filename must contain the full path name for the file. This file can reside anywhere on the system, connected network or tape device. If no filename is specified, you will receive an error.



Note Note - Once smsrestore completes you will see the following message: "Please set the desired SMS failover state." Ignore this message.



2. Proceed to To Configure the Management Network (MAN) Using smsconfig(1M) .

Configuring the MAN Network on the Spare SC


procedure icon  To Configure the Management Network (MAN) Using smsconfig(1M)

To correctly configure the management network, you need to do the following:

1. Be sure you have read and filled out the information in the Sun Fire trademark 15K System Site Planning Guide .


Note Note - A domain can be excluded from the I1 network configuration by using the word NONE as the net_id. This applies only to the I1 network.



2. Read the smsconfig (1M) man page.

3. Log into the spare SC as superuser.

4. To display, review, or change the Management Network settings, type:

sc1: # /opt/SUNWSMS/bin/smsconfig -m

5. Answer the questions based on the information gathered for your site in the Sun Fire trademark 15K System Site Planning Guide .

The following example shows IPv4 and accepts the default settings provided with the Solaris 9 05/02 Supplemental CD. An IPv6 network example differs slightly. There will be no prompts for netmasks and /etc/ipnodes will be modified in addition to /etc/hosts .



Note Note - The IP addresses shown in the following example are examples only. Refer to your Sun Firetrademark 15K System Site Planning Guide for valid IP addresses for your network. IP addresses on the external network for failover, hme0 and eri1 on each SC must be unique. The floating IP address is the same on both SCs.



For more information on smsconfig -m refer to the "MAN Configuration" section of the System Management Services (SMS) 1.2 Administrator Guide and the smsconfig man page.

sc1: # smsconfig -m
The platform name identifies the entire host machine to the SMS
 software. The platform name occupies a different name space than
 domain names (hostnames of bootable systems). 
What is the name of the platform this SMS will service [sun15]? sun15
Configuring the External Network for Community C1
Do you want to define this Community? [y,n] y
Enter NICs associated with community C1 [hme0 eri1]: [Return]
Enter Logical/Floating IP hostname for community C1 [sun15-sc-C1]:[Return]
Enter IPMP IP address for sun15-sc-C1:10.1.1.50
Enter Netmask for community C1: 255.255.255.0
Enter IPMP hostname for community C1 failover address [sun15-sc0-C1-failover]:[Return]
Enter IPMP IP address for sun15-sc0-C1-failover:10.1.1.51
Enter IPMP hostname for hme0 [sun15-sc0-hme0]:[Return]
Enter IPMP IP address for hme0: 10.1.1.52
Enter IPMP hostname for eri1 [sun15-sc0-eri1]:[Return]
Enter IPMP IP address for sun15-sc0-eri1: 10.1.1.53
Hostname                IP Address (platform=sun15)
--------                ----------
sun15-sc-C1             10.1.1.50
sun15-sc0-C1-failover   10.1.1.51
sun15-sc0-hme0          10.1.1.52
sun15-sc0-eri1          10.1.1.53
Do you want to accept these network settings? [y,n] y
Configuring the External Network for Community C2
Do you want to define this Community? [y,n] n
Configuring I1 Management Network - `I1' is the Domain to SC MAN.
MAN I1 Network Identification
Enter the IP network number (base address) for the I1 network: 10.2.1.0
Enter the netmask for the I1 MAN network [255.255.255.224]:[Return]
Hostname        IP Address (platform=sun15)
--------        ----------
netmask-i1      255.255.255.224
sun15-sc-i1   10.2.1.1
sun15-a       10.2.1.2
sun15-b       10.2.1.3
sun15-c       10.2.1.4
sun15-d       10.2.1.5
sun15-e       10.2.1.6
sun15-f       10.2.1.7
sun15-g       10.2.1.8
sun15-h       10.2.1.9
sun15-i       10.2.1.10
sun15-j       10.2.1.11
sun15-k       10.2.1.12
sun15-l       10.2.1.13
sun15-m       10.2.1.14
sun15-n       10.2.1.15
sun15-o       10.2.1.16
sun15-p       10.2.1.17
sun15-q       10.2.1.18
sun15-r       10.2.1.19
Do you want to accept these network settings? [y,n] y
Configuring I2 Management Network - 'I2' is for SC to SC MAN.
MAN I2 Network Identification
Enter the IP network number (base address) for the I2 network: 10.3.1.0
Enter the netmask for the I2 MAN network [255.255.255.252]:[Return] 
Hostname           IP Address   (platform=sun15)
--------           ----------   
netmask-i2         255.255.255.252      
sun15-sc0-i2       10.3.1.1   
sun15-sc1-i2       10.3.1.2     
Do you want to accept these settings? [y,n] y
Creating /.rhosts to facilitate file propagation...done 
MAN Network configuration modified!
Changes will take effect on next reboot.
The following changes are about to be applied to the "/etc/hosts" hosts file.
----------------------
ADD: 10.2.1.2   sun15-a #smsconfig-entry#
ADD: 10.2.1.3   sun15-b #smsconfig-entry#
ADD: 10.2.1.4   sun15-c #smsconfig-entry#
ADD: 10.2.1.5   sun15-d #smsconfig-entry#
ADD: 10.2.1.6   sun15-e #smsconfig-entry#
ADD: 10.2.1.7   sun15-f #smsconfig-entry#
ADD: 10.2.1.8   sun15-g #smsconfig-entry#
ADD: 10.2.1.9   sun15-h #smsconfig-entry#
ADD: 10.2.1.10  sun15-i #smsconfig-entry#
ADD: 10.2.1.11  sun15-j #smsconfig-entry#
ADD: 10.2.1.12  sun15-k #smsconfig-entry#
ADD: 10.2.1.13  sun15-l #smsconfig-entry#
ADD: 10.2.1.14  sun15-m #smsconfig-entry#
ADD: 10.2.1.15  sun15-n #smsconfig-entry#
ADD: 10.2.1.16  sun15-o #smsconfig-entry#
ADD: 10.2.1.17  sun15-p #smsconfig-entry#
ADD: 10.2.1.18  sun15-q #smsconfig-entry#
ADD: 10.2.1.19  sun15-r #smsconfig-entry#
ADD: 10.2.1.1   sun15-sc-i1 #smsconfig-entry#
ADD: 10.1.1.50  sun15-sc-C1 #smsconfig-entry#
ADD: 10.1.1.51  sun15-sc0-C1-failover #smsconfig-entry#
ADD: 10.1.1.52  sun15-sc0-hme0 #smsconfig-entry#
ADD: 10.1.1.53  sun15-sc0-eri1 #smsconfig-entry#
ADD: 10.3.1.1   sun15-sc0-i2 #smsconfig-entry#
ADD: 10.3.1.2   sun15-sc1-i2 #smsconfig-entry#
----------------------
Update the hosts file, "/etc/hosts", with these changes? [y,n] y
Hosts file "/etc/hosts" has been updated.
The following information is about to be applied to the "/etc/netmasks" file.
----------------------
ADD network: 10.1.1.50, mask: 255.255.255.0
ADD network: 10.2.1.0, mask: 255.255.255.224
ADD network: 10.3.1.0, mask: 255.255.255.224
----------------------
Update the netmasks file, "/etc/netmasks", with these changes? [y,n] y
Netmasks files "etc/netmasks" has been updated.
sc1:#



Note Note - Any changes made to the network configuration on one SC using smsconfig -m must be made to the other SC as well. Network configuration is not automatically propagated.



6. Configure the Name Services for SMS

7. Log in to the SC as superuser.

8. Edit the /etc/nsswitch.conf file.

    a. The first entry for password , group , hosts , netmasks and ethers should be files . List other naming services in use, such as nis or DNS , next.

    The following example shows the correct partial contents of an /etc/nsswitch.conf file on the spare SC. The look-up order for the database entries is first files then naming services.

    sc1: # vi /etc/nsswitch.conf
    ...
    passwd:      files nis
    group:       files nis
    ...
    hosts:       files nis
    ...
    netmasks:    files nis
    ...
    ethers:      files nis
    ...



    Note Note - smsconfig automatically updates the /etc/netmasks and the /etc/inet/hosts file with all the private host names and logical addresses for the SC.



9. Update your Solaris Naming software (NIS, NIS+, DNS, etc), as appropriate.

10. Apply any relevant patches, unless otherwise noted in the patch instructions.

See Patches . If no patches are needed you can proceed to Step 11 .

11. Configure SMS groups. See To Add Users to SMS Groups and Configure Directory Access .


Note Note - In order to correctly set the ACLs you must repopulate the user groups using smsconfig -a. Manually editing or copying over an old /etc/group can limit or deny access to users.



12. After adding users to your SMS Groups:

If you are performing a reinstallation or Type 1 installation, proceed to To Switch Control to the Spare SC .

If you are performing a Type 2 installation, proceed to To Upgrade the Solaris Operating Environment .

Type 2 Upgrade of the Solaris Operating Environment on the Spare SC


Note Note - Do this now only if you are performing a Type 2 installation. Otherwise proceed to Installing SMS Packages.




procedure icon  To Upgrade the Solaris Operating Environment

1. Install or upgrade the Solaris 9 operating environment according to the Solaris installation instructions. Refer to the Solaris 9 Installation Guide for detailed installation instructions.

The instructions in the following sections assume that your system is running the Entire Distribution software group (or higher) of the Solaris 9 05/02 operating environment. SMS 1.2_s9 does not run under software releases earlier than Solaris 9 05/02 or software groups less than Entire Distribution . Any relevant patches should be applied according to each patch's instructions.

2. Once your operating environment has been successfully installed proceed to To Switch Control to the Spare SC .

Switch Control to the Spare SC


procedure icon  To Switch Control to the Spare SC

1. Log in to the main SC (SC0) as superuser.

2. Stop SMS on the main SC:

sc0:# /etc/init.d/sms stop 

3. Log in to the spare SC (SC1) and drop to the OpenBoot PROM prompt.

sc1:# shutdown -y -g0 -i0
...[system message]
ok

4. Boot the spare SC.

ok boot

You must reboot the SC in order for the changes to take effect. Once you have rebooted the system, network configuration is complete and SMS will start and SC1 will become the main SC.

5. Next:

For reinstallation, proceed to To Reinstall or Upgrade the Former Main SC .

For Type 1 and Type 2 installations, Proceed to To Update the Flash PROMs .

Updating the Flash PROMs on the Spare SC and the System Boards


procedure icon  To Update the Flash PROMs

When you upgrade the SMS software you must update the SC flash PROMs on both SCs. You must also update the CPU flash PROMs on the system boards. Updating the flash PROMs should be done as soon as you have created system privileges. You must have platform privileges to run the flashupdate (1M) command.

Updating flash PROMs is not necessary for software reinstallation.



Note Note - In order to update your SC PROMs you must have access to the following drivers:

sc0:# ls -l /dev/uflash*lrwxrwxrwx 1 root other 62 Oct 16 20:30 /dev/uflash0 -> ../devices/pci@1f,0/pci@1,1/ebus@1/flashprom@10,400000:uflash0lrwxrwxrwx 1 root other 62 Oct 16 20:30 /dev/uflash0 -> ../devices/pci@1f,0/pci@1,1/ebus@1/flashprom@10,400000:uflash0





Note Note - If the drivers are not available you must run the following command as superuser on each SC:

sc0:# /usr/sbin/devfsadm -i uflash



1. Log in to the new main SC as a user with platadmn privileges.

2. Upgrade the SC Flash PROMs.

Update the SC PROMs using flashupdate .

sc1:sms-user:> flashupdate -f /opt/SUNWSMS/firmware/SCOBPimg.di scx/fp0
sc1:sms-user:> flashupdate -f /opt/SUNWSMS/firmware/SSCPOST.di scx/fp1

where:

x is the number of the current main SC (0|1).

For more information on flashupdate (1M) refer to the System Management Services (SMS) 1.2 Reference Manual or the flashupdate man page.

3. Upgrade the CPU Flash PROMs.

Update all CPU Flash PROMs using flashupdate .

sc0:sms-user:> flashupdate -f /opt/SUNWSMS/hostobjs/sgcpu.flash location

For more information on flashupdate (1M) refer to the System Management Services (SMS) 1.2 Reference Manual or the flashupdate man page.

4. Drop to the OpenBoot PROM prompt.

sc0:sms-user:> su - 
password: [superuser passwd]
sc0:# shutdown -y -g0 -i0
...[system message]
ok

5. Reboot the SC. Type:

ok boot

6. Proceed to To Reinstall or Upgrade the Former Main SC .

Reinstalling or Upgrading the Former Main SC


procedure icon  To Reinstall or Upgrade the Former Main SC

1. Log in to the former main as superuser.

2. Backup the system on the former main SC (SC0).

Run smsbackup before proceeding or have the latest copy of the smsbackup file ( sms_backup.X.X.cpio ) accessible to the disk.

sc0:# /opt/SUNWSMS/bin/smsbackup directory_name 

where:

directory_name is the name of the directory in which the backup file is created. The directory_name requires the absolute path name for the file. This file can reside in any directory on the system, connected network or tape device to which you have read/write privileges. If no directory_name is specified, a backup file is created in /var/tmp .

The directory_name specified must be mounted on as a UFS file system. Specifying a TMPFS file system, such as /tmp , will cause smsbackup to fail. If you are not certain that your directory_name is mounted as a UFS file system, type:

sc0:# /usr/bin/df -F ufs directory_name

A UFS file system will return directory information. Any other type of file system will return a warning.

3. Next:

For Type 1 installations, proceed to Type 1 Installation or Upgrade of the Solaris Operating Environment on the Spare SC .

For reinstallation or Type 2 installation, proceed to Installing SMS 1.2 Software on the Former Main SC .

Type 1 Installation or Upgrade of the Solaris Operating Environment on the Former Main SC


Note Note - Do this now only if you are performing a Type 1 installation. Otherwise proceed to Installing SMS 1.2 Software on the Former Main SC.




procedure icon  To Install or Upgrade the Solaris Operating Environment

1. Install or upgrade the Solaris 9 operating environment according to the Solaris installation instructions. Refer to the Solaris 9 Installation Guide for detailed installation instructions.

The instructions in the following sections assume that your system is running the Entire Distribution software group (or higher) of the Solaris 9 05/02 operating environment. SMS 1.2_s9 does not run under software releases earlier than Solaris 9 05/02 or software groups less than Entire Distribution . Any relevant patches should be applied according to each patch's instructions.

2. Once your operating environment has been successfully installed proceed to To Install SMS 1.2 Software .

Installing SMS 1.2 Software on the Former Main SC


procedure icon  To Install SMS 1.2 Software

1. Install the SMS software packages on the former main SC (SC0) using Web Start or CD-ROM.

To install the SMS software packages on the former main SC, see To Install SMS Packages Using Web Start or To Manually Install the SMS Software Packages and substitute the main SC wherever you see the spare SC.

To mount the CD-ROM on the spare SC, see To Share SMS Packages on the Spare SC to the Main SC .

When you have successfully exited Web Start or completed the manual installation of all the packages proceed to To Restore Your SMS Configuration .

Restoring Your SMS Configuration on the Former Main SC


procedure icon  To Restore Your SMS Configuration

1. Restore your SMS configuration on the former main SC.

For reinstallation and Type 1 installations:

Run smsrestore .

sc0:#/opt/SUNWSMS/bin/smsrestore filename 

where:

filename is the absolute path to the backup file that was created by smsbackup (1M). The filename must contain the full path name for the file. This file can reside anywhere on the system, connected network or tape device. If no filename is specified, you will receive an error.



Note Note - Once smsrestore completes you will see the following message: "Please set the desired SMS failover state." Ignore this message.



For Type 2 installations:

Run smsversion then smsrestore .

sc0:#/opt/SUNWSMS/bin/smsversion 
smsversion: Active SMS version <1.1> 
smsversion: SMS version 1.1 installed smsversion: 
SMS version 1.2 installed 
Please select from one of the following installed SMS versions. 
1) 1.1 
2) 1.2 
3) Exit 
Select version: 2
You have selected SMS Version 1.2
Is this correct? [y,n] y
smsversion: Upgrading SMS from <1.1> to <1.2>.
To move to a different version of SMS an archive of
critical files will be created. What is the name of
the directory or tape device where the archive will be stored? [/var/tmp][return]
smsversion: Backup configuration file created: /var/tmp/sms_backup.1.1.cpio
smsversion: Switching to target version <1.2>.
smsversion: New Version <1.2> Active
smsversion: Active SMS version <1.2>
To use the previous SMS configuration settings type: 
smsrestore /var/tmp/sms_backup.1.1.cpio
NOTE: When switching to another SMS version, the user must choose
 (via use of smsrestore) to restore the configuration settings
 from the previously active version.

sc0:#/opt/SUNWSMS/bin/smsrestore filename 

where:

filename is the absolute path to the backup file that was created by smsbackup (1M). The filename must contain the full path name for the file. This file can reside anywhere on the system, connected network or tape device. If no filename is specified, you will receive an error.



Note Note - Once smsrestore completes you will see the following message: "Please set the desired SMS failover state." Ignore this message.



2. Proceed to To Configure the Management Network (MAN) Using smsconfig(1M) .

Configuring the MAN Network on the Former Main SC


procedure icon  To Configure the Management Network (MAN) Using smsconfig(1M)

To correctly configure the management network, you need to do the following:

1. Be sure you have read and filled out the information in the Sun Fire trademark 15K System Site Planning Guide .


Note Note - A domain can be excluded from the I1 network configuration by using the word NONE as the net_id. This applies only to the I1 network.



2. Read the smsconfig (1M) man page.

3. Log into the former main SC as superuser.

4. To display, review, or change the Management Network settings, type:

sc0: # /opt/SUNWSMS/bin/smsconfig -m

5. Answer the questions based on the information gathered for your site in the Sun Fire trademark 15K System Site Planning Guide .

The following example shows IPv4 and accepts the default settings provided with the Solaris 9 05/02 Supplemental CD. An IPv6 network example differs slightly. There will be no prompts for netmasks and /etc/ipnodes will be modified in addition to /etc/hosts .



Note Note - The IP addresses shown in the following example are examples only. Refer to your Sun Firetrademark 15K System Site Planning Guide for valid IP addresses for your network. IP addresses on the external network for failover, hme0 and eri1 on each SC must be unique. The floating IP address is the same on both SCs.



For more information on smsconfig -m refer to "MAN Configuration section of the System Management Services (SMS) 1.2 Administrator Guide and the smsconfig man page.

sc1: # smsconfig -m
The platform name identifies the entire host machine to the SMS
 software. The platform name occupies a different name space than
 domain names (hostnames of bootable systems). 
What is the name of the platform this SMS will service [sun15]? sun15
Configuring the External Network for Community C1
Do you want to define this Community? [y,n] y
Enter NICs associated with community C1 [hme0 eri1]: [Return]
Enter Logical/Floating IP hostname for community C1 [sun15-sc-C1]:[Return]
Enter IPMP IP address for sun15-sc-C1:10.1.1.50
Enter Netmask for community C1: 255.255.255.0
Enter IPMP hostname for community C1 failover address [sun15-sc0-C1-failover]:[Return]
Enter IPMP IP address for sun15-sc0-C1-failover:10.1.1.51
Enter IPMP hostname for hme0 [sun15-sc0-hme0]:[Return]
Enter IPMP IP address for hme0: 10.1.1.52
Enter IPMP hostname for eri1 [sun15-sc0-eri1]:[Return]
Enter IPMP IP address for sun15-sc0-eri1: 10.1.1.53
Hostname                IP Address (platform=sun15)
--------                ----------
sun15-sc-C1             10.1.1.50
sun15-sc0-C1-failover   10.1.1.51
sun15-sc0-hme0          10.1.1.52
sun15-sc0-eri1          10.1.1.53
Do you want to accept these network settings? [y,n] y
Configuring the External Network for Community C2
Do you want to define this Community? [y,n] n
Configuring I1 Management Network - `I1' is the Domain to SC MAN.
MAN I1 Network Identification
Enter the IP network number (base address) for the I1 network: 10.2.1.0
Enter the netmask for the I1 MAN network [255.255.255.224]:[Return]
Hostname        IP Address (platform=sun15)
--------        ----------
netmask-i1      255.255.255.224
sun15-sc-i1   10.2.1.1
sun15-a       10.2.1.2
sun15-b       10.2.1.3
sun15-c       10.2.1.4
sun15-d       10.2.1.5
sun15-e       10.2.1.6
sun15-f       10.2.1.7
sun15-g       10.2.1.8
sun15-h       10.2.1.9
sun15-i       10.2.1.10
sun15-j       10.2.1.11
sun15-k       10.2.1.12
sun15-l       10.2.1.13
sun15-m       10.2.1.14
sun15-n       10.2.1.15
sun15-o       10.2.1.16
sun15-p       10.2.1.17
sun15-q       10.2.1.18
sun15-r       10.2.1.19
Do you want to accept these network settings? [y,n] y
Configuring I2 Management Network - 'I2' is for SC to SC MAN.
MAN I2 Network Identification
Enter the IP network number (base address) for the I2 network: 10.3.1.0
Enter the netmask for the I2 MAN network [255.255.255.252]:[Return] 
Hostname           IP Address   (platform=sun15)
--------           ----------   
netmask-i2         255.255.255.252      
sun15-sc0-i2       10.3.1.1   
sun15-sc1-i2       10.3.1.2     
Do you want to accept these settings? [y,n] y
Creating /.rhosts to facilitate file propagation...done 
MAN Network configuration modified!
Changes will take effect on next reboot.
The following changes are about to be applied to the "/etc/hosts" hosts file.
----------------------
ADD: 10.2.1.2   sun15-a #smsconfig-entry#
ADD: 10.2.1.3   sun15-b #smsconfig-entry#
ADD: 10.2.1.4   sun15-c #smsconfig-entry#
ADD: 10.2.1.5   sun15-d #smsconfig-entry#
ADD: 10.2.1.6   sun15-e #smsconfig-entry#
ADD: 10.2.1.7   sun15-f #smsconfig-entry#
ADD: 10.2.1.8   sun15-g #smsconfig-entry#
ADD: 10.2.1.9   sun15-h #smsconfig-entry#
ADD: 10.2.1.10  sun15-i #smsconfig-entry#
ADD: 10.2.1.11  sun15-j #smsconfig-entry#
ADD: 10.2.1.12  sun15-k #smsconfig-entry#
ADD: 10.2.1.13  sun15-l #smsconfig-entry#
ADD: 10.2.1.14  sun15-m #smsconfig-entry#
ADD: 10.2.1.15  sun15-n #smsconfig-entry#
ADD: 10.2.1.16  sun15-o #smsconfig-entry#
ADD: 10.2.1.17  sun15-p #smsconfig-entry#
ADD: 10.2.1.18  sun15-q #smsconfig-entry#
ADD: 10.2.1.19  sun15-r #smsconfig-entry#
ADD: 10.2.1.1   sun15-sc-i1 #smsconfig-entry#
ADD: 10.1.1.50  sun15-sc-C1 #smsconfig-entry#
ADD: 10.1.1.51  sun15-sc0-C1-failover #smsconfig-entry#
ADD: 10.1.1.52  sun15-sc0-hme0 #smsconfig-entry#
ADD: 10.1.1.53  sun15-sc0-eri1 #smsconfig-entry#
ADD: 10.3.1.1   sun15-sc0-i2 #smsconfig-entry#
ADD: 10.3.1.2   sun15-sc1-i2 #smsconfig-entry#
----------------------
Update the hosts file, "/etc/hosts", with these changes? [y,n] y
Hosts file "/etc/hosts" has been updated.
The following information is about to be applied to the "/etc/netmasks" file.
----------------------
ADD network: 10.1.1.50, mask: 255.255.255.0
ADD network: 10.2.1.0, mask: 255.255.255.224
ADD network: 10.3.1.0, mask: 255.255.255.224
----------------------
Update the netmasks file, "/etc/netmasks", with these changes? [y,n] y
Netmasks files "etc/netmasks" has been updated.
sc1:#

6. Configure the Name Services for SMS

7. Log in to the SC as superuser.

8. Edit the /etc/nsswitch.conf file.

    a. The first entry for password , group , hosts , netmasks and ethers should be files . List other naming services in use, such as nis or DNS , next.

    The following example shows the correct partial contents of an /etc/nsswitch.conf file on the spare SC. The look-up order for the database entries is first files then naming services.

    sc0: # vi /etc/nsswitch.conf
    ...
    passwd:      files nis
    group:       files nis
    ...
    hosts:       files nis
    ...
    netmasks:    files nis
    ...
    ethers:      files nis
    ...



    Note Note - smsconfig automatically updates the /etc/netmasks and the /etc/inet/hosts file with all the private host names and logical addresses for the SC.



9. Update your Solaris Naming software (NIS, NIS+, DNS, etc), as appropriate.

10. Apply any relevant patches, unless otherwise noted in the patch instructions.

See Patches . If no patches are needed you can proceed to Step 11 .

11. Configure SMS groups. See To Add Users to SMS Groups and Configure Directory Access .


Note Note - In order to correctly set the ACLs you must repopulate the user groups using smsconfig -a. Manually editing or copying over an old /etc/group can limit or deny access to users.



12. After adding users to your SMS Groups:

For reinstallation and Type 1 installations, proceed to To Reboot the Former Main SC .

For Type 2 installations, proceed to To Upgrade the Solaris Operating Environment .

Type 2 Upgrade of the Solaris Operating Environment on the Former Main SC


Note Note - Do this now only if you are performing a Type 2 installation. Otherwise proceed to Installing SMS Packages.




procedure icon  To Upgrade the Solaris Operating Environment

1. Upgrade the Solaris 9 operating environment according to the Solaris installation instructions. Refer to the Solaris 9 Installation Guide for detailed installation instructions.

The instructions in the following sections assume that your system is running the Entire Distribution software group (or higher) of the Solaris 9 05/02 operating environment. SMS 1.2_s9 does not run under software releases earlier than Solaris 9 05/02 or software groups less than Entire Distribution . Any relevant patches should be applied according to each patch's instructions.

2. Proceed to Reboot the Former Main SC .

Reboot the Former Main SC


procedure icon  To Reboot the Former Main SC

1. Log in to the main SC (SC0) as superuser.

2. Log in to the former main SC (SC0) and drop to the OpenBoot PROM prompt.

sc0:# shutdown -y -g0 -i0
...[system message]
ok

3. Boot the former main SC.

ok boot

You must reboot the SC in order for the changes to take effect. Once you have rebooted the system, network configuration is complete.

4. Next:

For reinstallation, proceed to To Enable Failover .

For Type 1 and Type 2 installations, Proceed to To Update the Flash PROMs .

Updating the Flash PROMs on the Former Main SC


procedure icon  To Update the Flash PROMs

When you upgrade the SMS software you must update the SC flash PROMs on both SCs. This is not necessary for software reinstallation.



Note Note - You do not need to update the CPU flash PROMs. This was done earlier and is not repeated.



Updating the SC flash PROMs should be done as soon as you have created system privileges. You must have platform privileges to run the flashupdate (1M) command.



Note Note - In order to update your SC PROMs you must have access to the following drivers:

sc0:# ls -l /dev/uflash*lrwxrwxrwx 1 root other 62 Oct 16 20:30 /dev/uflash0 -> ../devices/pci@1f,0/pci@1,1/ebus@1/flashprom@10,400000:uflash0lrwxrwxrwx 1 root other 62 Oct 16 20:30 /dev/uflash0 -> ../devices/pci@1f,0/pci@1,1/ebus@1/flashprom@10,400000:uflash0





Note Note - If the drivers are not available you must run the following command as superuser on each SC:

sc0:# /usr/sbin/devfsadm -i uflash



1. Log in to the main SC as a user with platadmn privileges.

2. Upgrade the SC Flash PROMs.

Update the SC PROMs using flashupdate .

sc0:sms-user:> flashupdate -f /opt/SUNWSMS/firmware/SCOBPimg.di scx/fp0
sc0:sms-user:> flashupdate -f /opt/SUNWSMS/firmware/SSCPOST.di scx/fp1

where:

x is the number of the current main SC (0|1).

For more information on flashupdate (1M) refer to the System Management Services (SMS) 1.2 Reference Manual or the flashupdate man page.

3. Drop to the OpenBoot PROM prompt.

sc0:sms-user:> su - 
password: [superuser passwd]
sc0:# shutdown -y -g0 -i0
...[system message]
ok

4. Reboot the main SC (SC0). Type:

ok boot

5. Proceed to To Enable Failover .

Enabling Failover on the Main SC (SC1)


procedure icon  To Enable Failover

1. Login in the new main SC (SC1) as a user with platadmn privileges.

2. Turn on failover.

sc1: # /opt/SUNWSMS/bin/setfailover on

Your reinstallation or upgrade is now complete! You are now ready to proceed to Creating a Domain .


Adding Users to SMS

The SMS security model uses group membership to provide users with the authority to perform various system management tasks. The level and type of system management available depends on a user's group membership. For more information, refer to Chapter 2, "SMS Security" in the System Management Services (SMS) 1.2 Administrator Guide .



Note Note - Adding users using smsconfig must be performed on both the main and spare SCs once software installation and network configuration are completed.



The SMS user group IDs are created during initial installation. The following table lists the user groups that are set up for you:

User Group ID

User Group Description

platadmn

Platform Administrator Group

platsvc

Platform Service Group

platoper

Platform Operator Group

dmnaadmn

Domain A Administrator Group

dmnbadmn

Domain B Administrator Group

dmncadmn

Domain C Administrator Group

dmndadmn

Domain D Administrator Group

dmneadmn

Domain E Administrator Group

dmnfadmn

Domain F Administrator Group

dmngadmn

Domain G Administrator Group

dmnhadmn

Domain H Administrator Group

dmniadmn

Domain I Administrator Group

dmnjadmn

Domain J Administrator Group

dmnkadmn

Domain K Administrator Group

dmnladmn

Domain L Administrator Group

dmnmadmn

Domain M Administrator Group

dmnnadmn

Domain N Administrator Group

dmnoadmn

Domain O Administrator Group

dmnpadmn

Domain P Administrator Group

dmnqadmn

Domain Q Administrator Group

dmnradmn

Domain R Administrator Group

dmnarcfg

Domain A Configuration Group

dmnbrcfg

Domain B Configuration Group

dmncrcfg

Domain C Configuration Group

dmndrcfg

Domain D Configuration Group

dmnercfg

Domain E Configuration Group

dmnfrcfg

Domain F Configuration Group

dmngrcfg

Domain G Configuration Group

dmnhrcfg

Domain H Configuration Group

dmnircfg

Domain I Configuration Group

dmnjrcfg

Domain J Configuration Group

dmnkrcfg

Domain K Configuration Group

dmnlrcfg

Domain L Configuration Group

dmnmrcfg

Domain M Configuration Group

dmnnrcfg

Domain N Configuration Group

dmnorcfg

Domain O Configuration Group

dmnprcfg

Domain P Configuration Group

dmnqrcfg

Domain Q Configuration Group

dmnrrcfg

Domain R Configuration Group



procedure icon  To Add Users to SMS Groups and Configure Directory Access

SMS provides the ability to add users to SMS groups and refine user access to directories on the Sun Fire 15K. This functionality protects domain integrity and system security.

1. Login as superuser.

2. To correctly configure SMS groups and administrative privileges, you must use the following command for each user you wish to add.

sc0: # /opt/SUNWSMS/bin/smsconfig -a -u username -G groupname domain_id|platform

where:

username is the name of a user account on the system.

groupname is one of the following valid group designations: admn , rcfg , oper or svc .

domain_id is the ID for a domain. Valid domain_id s are A through R and are case insensitive.

For example, to add a user to the dmnaadmn group with access to domain a directories, type:

sc0: # /opt/SUNWSMS/bin/smsconfig -a -u fdjones -G admn a 
fdjones has been added to the dmnaadmn group
All privileges to domain a have been applied.



Note Note - Do not manually add or remove users from SMS groups in the /etc/group file. This can limit or deny access to users.



3. To list SMS groups and administrative privileges, use the following command.

sc0: # /opt/SUNWSMS/bin/smsconfig -l domain_id|platform

For example, to display all users with platform privileges, type:

sc0: # /opt/SUNWSMS/bin/smsconfig -l platform
fdjones
jtd

4. To correctly configure SMS groups and administrative privileges, you must use the following command for each user you wish to remove.

sc0: # /opt/SUNWSMS/bin/smsconfig -r -u username -G groupname  domain_id|platform

For example, to remove fdjones from the dmnbadmn group, type:

sc0: # /opt/SUNWSMS/bin/smsconfig -r -u fdjones -G admn B 
fdjones has been removed from the dmnbadmn group.
All access to domain B is now denied.

where:

username is the name of a valid user account on the system.

groupname is one of the following group designations: admn , rcfg , oper or svc .

domain_id is the ID for a domain. Valid domain_id s are A through R and are case insensitive.



Note Note - Do not manually add or remove users from SMS groups in the /etc/group file. This can limit or deny access to users.



5. You have successfully configured your SMS user groups.


Creating a Domain

This section describes the following procedures for creating a new domain:



Note Note - You must have a valid idprom.image file for the domain in the /var/opt/SUNWSMS/data/domain_id directory in order to create a domain. Contact your Sun service representative if this file is missing.




procedure icon  To Build a New Domain on the System Controller

For the examples in this guide:

Prompt

Definition

sc0 :#

Superuser on the main SC

domain_id : #

Superuser on the domain

sc_name : sms-user:>

User prompt on the SC.

sms-user is the user-name of an administrator, operator, configurator or service personnel logged in to the SC.

domain_id : sms-user:>

User prompts on the domain

sms-user is the user-name of the administrator, operator, configurator or service personnel logged in to the domain.


The privileges allotted to the user are determined by the platform or domain groups to which the user belongs. In these examples, the sms-user is assumed to have both platform and domain administrator privileges, unless otherwise noted.

1. Log in as a user with platadmn privileges, and create a domain by adding boards.

sc0:sms-user:> addboard -d domain_id -c assign board_id [board_id] 

where:

domain_id is the ID of the domain ( A through R ) that you are creating

board_id corresponds to board location. The following board_id forms are accepted:

SB(0...17)

IO(0...17)

For example, the following command adds CPU boards in slots 4, 12, and 15 to domain A.

sc0:sms-user:> addboard -d A -c assign SB4 SB12 SB15

The next example adds I/O boards in slots 3, 12, and 17 to domain A.

sc0:sms-user:> addboard -d A -c assign IO3 IO12 IO17

2. Use the deleteboard (1M) command if you need to remove boards from an inactive domain

sc0:sms-user:> deleteboard -c unassign location [location]   

where:

location is the board location. The following location forms are accepted:

SB(0...17)

IO(0...17)

For example, the following command removes the CPU board in slot 12 of slot 0 from domain A.

sc0:sms-user:> deleteboard -c unassign SB12

The next example removes an I/O board in slot 3 of slot 1 from domain A.

sc0:sms-user:> deleteboard -c unassign IO3

3. Add a tag for the domain.

sc0:sms-user:> addtag -d domain_id domain_tag

where:

domain_id is the ID of the domain ( A through R ) you are creating.

domain_tag is the name of the new tag you are adding for the domain, such as domainA .

For example, the following command adds the tag for domain A to the platform configuration database (PCD).

sc0:sms-user:> addtag -d A domainA

4. Use the deletetag (1M) command if you want to remove a tag.

sc0:sms-user:> deletetag -d domain_id

where:

domain_id is the ID of the domain from which you want to remove a tag ( A through R ).

For example, the following command deletes the tag for domain A from the platform configuration database (PCD).

sc0:sms-user:> deletetag -d A


procedure icon  To Activate the Domain



Note Note - To install the Solaris operating environment and SMS on a new system controller, you must have a valid idprom.image file in /var/opt/SUNWSMS/data/domain_id/idprom.image, where domain_id is A through R. If you do not have this file already, contact your Sun service representative.



SMS contains a virtual key switch for each domain, which controls the states of the domain. The showkeyswitch (1M) command displays the position of the virtual key switch, and the setkeyswitch (1M) command changes the position of the virtual key switch. The valid positions of the virtual key switch are on , standby , off , diag , and secure . For more information refer to the System Management Services (SMS) 1.2 Reference Manual .

1. Display the domain status.

sc0:sms-user:> showkeyswitch -d domain_id

where:

domain_id is the ID of the domain ( A through R ) for which you want to check status.

For example, the following command shows the status of domain A .

sc0:sms-user:> showkeyswitch -d A

2. Activate the domain as a user with Domain Administrator ( dmnaadmn ) privileges.

sc0:sms-user:> setkeyswitch -d domain_id  position

where:

domain_id is the ID of the domain ( A through R ) you want to activate

position is whether you want the virtual keyswitch in the on (activate), off (deactivate), standby , diag , or secure position.

For example, the following command activates domain A .

sc0:sms-user:> setkeyswitch -d A on

3. If you need to deactivate a domain, set the position of the virtual keyswitch to off .

sc0:sms-user:> setkeyswitch -d A off

For example, the following command deactivates domain A .


procedure icon  To Bring Up a Console for the Domain

The conditions required for network console are as follows:

1. Bring up an active console window for the domain

sc0:sms-user:> console -d domain_id

where:

domain_id is the ID of the domain ( A through R ) for which you want to bring up a console.

For example, the following command brings up a console for domain A .

sc0:sms-user:> console -d A

In the domain console window, vi (1) runs properly and the escape sequences ( tilde commands) work as intended only if the environment variable TERM has the same setting as that of the console window.

For example:

domain_id:sms-user:> setenv TERM xterm 

For more information on domain console refer to the System Management Services (SMS) 1.2 Administrator Guide and the console man page.


Setting Up and Installing the Solaris Operating Environment for the Domain

This section describes the following procedures for setting up and installing the Solaris operating environment for the domain:



Note Note - If you had the Solaris operating environment pre-installed on your system or you have run the sys-unconfig command on the domain please see Unconfigured Domains before proceeding.




procedure icon  To Set up the Network Install Server on the System Controller

You must create an install server to install the Solaris operating environment software for a domain over the network.

1. You should be familiar with setting up network install servers before beginning this procedure.

For information on configuring network install servers, refer to the Solaris 9 Installation Guide .

Refer to the Solaris 9 Installation Guide for information on setting up the spare SC as an install client.

For partition and Solaris operating system distribution information see Introduction .


procedure icon  To Set Up the Domain as an Install Client

After you have created an install server on sc0, you are ready to install the Solaris operating environment software for the domain over the network. The system needs to identify the name of the domain, and you add this information by using the add_install_client (1M) command. Refer to the Solaris 9 05/02 Reference Manual for more information about the add_install_client (1M) command.

1. Obtain the MAN network Ethernet address at the OpenBoot PROM prompt by typing:

ok  banner

2. As superuser on SC0, set up the host domain as an install client.

sc0: # /install_dir_path/Solaris_9/Tools/add_install_client -e domain_man_etheraddr -s scI1_hostname:/install_dir_path   -c scI1_hostname:/install_dir_path  domain_hostname sun4u 

where:

install_dir_path specifies the directory where the CD images were copied.

domain_man_etheraddr is the Ethernet address for the domain.

scI1_hostname is the hostname given to the SC I1 network during the
smsconfig -m
procedure.

domain_hostname is the name given to the domain I1 network interface assigned during the smsconfig -m procedure.

See " To Configure the Management Network (MAN) Using smsconfig(1M) ." The domain host name was originally defined on the worksheet in the Sun Fire trademark 15K System Site Planning Guide .


procedure icon  To Install the Solaris Operating Environment on the Domain

1. Display the functioning network interfaces.

ok watch-net-all

If watch-net-all reports a failure on the device associated with man-net , you will need to contact your Sun representative.

2. Network boot the domain from the SC using the Management Network. Type:

ok  boot man-net 

3. Install the Solaris operating environment for the domain.

Refer to your Sun Fire trademark 15K System Site Planning Guide for site specific and system dependent information when prompted during installation.



Note Note - To use dynamic reconfiguration (DR) you must install at least the Entire Distribution software group (or higher) of the Solaris 9 05/02 operating environment on the domain.



4. Change the domain nodename.

When using the SC as an install server for a domain, change the domain's nodename after the installation is complete. This reduces the amount of network traffic generated between the domain and SC over the MAN network. Change the nodename of the domain to the hostname of one of its external network interfaces (for example, qfe0).

To change the domain's nodename do the following:

  1. Log in to the domain as superuser.

  2. Type:

    domain_id:# uname -S new_nodename 
    domain_id:# echo new_nodename > /etc/nodename  

  3. Log out.

5. Remove the domain from the network install server list.

After installing the domain software, to remove the domain from the install server list:

  1. Log in to the SC as superuser.

  2. Type:

    sc0:#/install_dir_path/Solaris_9/Tools/rm_install_client domain_hostname 

  3. In preparation for Step 4 of the next procedure, note the physical disk location. For example, type:

    sc0:#ls -la /dev/dsk/c0t17d0s0
    lrwxrwxrwx   1 root     root          77 Nov 20 17:38 /dev/dsk/c0t17d0s0 -> 
    ../../devices/pci@3c,600000/pci@1/SUNW,qlc@4/fp@0,0/ssd@w21000020370dac0c,0:a 

  4. Log out.


procedure icon  To Set Up OpenBoot PROM Environment Variables for the Domain

1. At the domain console's ok prompt, remove any duplicate entries in the devalias list.

ok nvunalias duplicate_alias

where:

duplicate_alias is the alias of the duplicate entry.



Note Note - This sequence must be repeated once per duplication. nvunalias removes only one device alias at a time; the last one in the list of device aliases.



2. Display the OpenBoot PROM device tree to use in creating the device aliases.

ok show-devs

3. Display the functioning network interfaces.

ok watch-net-all

4. Set the bootdisk_alias so that it refers to the device on which you are installing the Solaris operating environment

ok nvalias bootdisk_alias device_string

.

where:

bootdisk_alias is the alias for the device on which you are installing the Solaris operating environment

device_string is the string for the device on which you are installing the Solaris operating environment as displayed in Step 3.

For example:

nvalias disk /pci@3c,600000/pci@1/SUNW,qlc@4/fp@0,0/disk@w21000020370dac0c,0:a 



Note Note - Enter the nvalias command on a single line. In the above example, the ssd in the physical disk location changed to disk in the boot string.



5. Use the setenv command to set the default boot device to the correct alias.

ok setenv boot-device bootdisk_alias

where:

bootdisk_alias is the user-defined alias you established in Step 5. The boot device must correspond to the a bootable disk on which you are installing the operating environment. This variable will be used in case of a panic and auto-boot. It is very important to set this variable correctly.

6. Now that you have set up an alias for your boot device, boot the disk by typing:

ok boot

Unconfigured Domains

If you had the Solaris operating environment pre-installed on a domain or have run the sys-unconfig (1M) command on a domain, you must configure the MAN network information on that domain manually.



Note Note - Do not add the domain as an install client on the SC prior to booting the domain, as described in To Set Up the Domain as an Install Client.




procedure icon  To Configure Domain Networks

1. Log in to the domain as superuser.

2. Type:

domain_id:#ndd -get /dev/dman man_get_hostinfo

The following is an example of the output displayed.

manc_magic = 0x4d414e43
manc_version = 01
manc_csum = 0x0
manc_ip_type = AF_INET
manc_dom_ipaddr = 10.1.1.3
manc_dom_ip_netmask = 255.255.255.224
manc_dom_ip_netnum = 10.1.1.0
manc_sc_ipaddr = 10.1.1.1
manc_dom_eaddr = 0:0:be:a8:48:26
manc_sc_eaddr = 8:0:20:f9:e4:54
manc_iob_bitmap = 0x400 io boards = 10.1, 
manc_golden_iob = 10

3. Add or edit a network-i1 entry to /etc/netmasks , using the following format:

manc_dom_ip_netnum manc_dom_ip_netmask

For example:

10.1.1.0 255.255.255.224

4. Create an /etc/hostname.dman0 file with the following content:

manc_dom_ipaddr netmask + broadcast + private up

For example:

10.1.1.3 netmask + broadcast + private up 

5. Ensure that the 'manc_sc_ipaddr' IP address matches what's in /etc/syslog.conf:

domain_id:# cat /etc/syslog.conf

...
*.notice                @10.1.1.1

If not, edit the /etc/syslog.conf file. Save and exit.

6. Type:

domain_id:# ifconfig dman0 plumb
domain_id:# ifconfig dman0 manc_dom_ipaddr netmask + broadcast + private up

where

manc_dom_ipaddr is the domain IP address listed in /etc/netmasks .

7. The domain is now configured.

Patches

If you need to apply a patch to SMS 1.2, disable failover before installing the patch.

SMS patches are available at: http://sunsolve.sun.com

Follow these guidelines and notify the affected administrators:

Complete any domain, board, or configuration changes before you begin patch installation.

Please read all patch instructions carefully before attempting this procedure. Instructions in the patch procedure could preempt these instructions.

This example assumes the main SC is sc0 and the spare SC is sc1 .


procedure icon  To Disable Failover

1. Log in to the main SC as superuser.

2. Backup your system configuration on the main:

sc0:# /opt/SUNWSMS/bin/smsbackup directory

3. Log in to the main SC with platform administrator privileges.

4. Synchronize the main SC to the spare and backup to the spare. Type:

sc0:sms-user:> /opt/SUNWSMS/bin/setdatasync backup

Wait until all files have been propagated.

5. Verify that all files have been propagated. Type:

sc0:sms-user:> /opt/SUNWSMS/bin/showdatasync -Q
FILE
sc0:sms-user:>

When no files are listed in the queue, propagation is complete.

6. Failover to the spare:

sc0:sms-user:> /opt/SUNWSMS/bin/setfailover force

7. Patch sc0 (main) according to patch instructions.

8. Log in to the spare SC with platform administrator privileges.

9. Reactivate failover:

sc1:sms-user:> /opt/SUNWSMS/bin/setfailover on

10. Fail back to sc0:

sc1:sms-user:> /opt/SUNWSMS/bin/setfailover force

11. Patch sc1 (spare) according to patch instructions.

12. Reactivate failover:

sc0:sms-user:> /opt/SUNWSMS/bin/setfailover on

13. You have finished the patch process for main and spare.


Installing Additional Software Packages

The additional software packages are in separate media. Install the software packages one at a time, from the appropriate media. There is no particular order in which the packages need to be installed. Following are additional packages that you may want to install:


procedure icon  To Install Additional Software Packages

1. Log in to the SC as superuser.

2. Insert the appropriate installation CD into the CD-ROM drive on the SC.

3. Use the share (1M) command to share the CD across the network.

  1. Verify that the nfsd server is running. Type:

    sc0:#ps -ef | grep nfsd

Add a CDROM entry to the /etc/dfs/dfstab file:

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

To propagate the CDROM image to NFS, type:

sc0:#/etc/init.d/nfs.server start

4. Log in to the domain as superuser.

5. Create and mount the /cdrom directory for the domain.

domain_id: # mkdir /cdrom
domain_id: # mount SC-I1: /cdrom/cdrom0 /cdrom

where:

SC-I1: is the hostname specified for the SC I1 network in Step 5 of To Configure the Management Network (MAN) Using smsconfig(1M) .

6. Add the additional software package.

domain_id: # cd /cdrom/install_disk_name
domain_id: # pkgadd -d . software_package_name

where:

install_disk_name is the name of the installation disk from which you are installing.

software_package_name is the name of the software package you are adding.

The pkgadd (1M) command might display several messages and ask several installation questions for each package, some relating to space, others asking whether it is OK to continue. After answering these questions, and when asked whether to proceed, answer yes.

7. Unmount the CD.

domain_id: # cd /
domain_id: # umount /cdrom

8. Log out of the domain and log in to the SC as superuser.

9. Eject the installation CD from the CD-ROM drive on the SC.

sc0: # cd /
sc0: # eject cdrom


Network Time Protocol (NTP)


procedure icon  To Configure the NTP Packages

1. After you install any additional software packages, configure the ntp.conf file for each domain, to synchronize clocks between the SC and its domain.

For details on configuring the domain ntp.conf file, which resides at /etc/inet/ntp.conf , refer to the "Configuring NTP" section of the System Management Services (SMS) 1.2 Administrator Guide .

For more information about NTP commands, refer to the xntp (1M) man page in the man Pages(1M): System Administration Commands section of the Solaris 9 05/02 Reference Manual Collection.


Stopping and Starting SMS

For diagnostic or service reasons you may be asked to stop and restart SMS. The following procedure describes how to do that manually.


procedure icon  To Manually Stop and Restart SMS

1. Log in to the SC as a user with platform administrator privileges.

You must have platform administrator privileges to run setfailover.

2. Turn off failover.

sc0: # /opt/SUNWSMS/bin/setfailover off

3. Log out as a platform administrator.

4. Log in to the SC as a user with superuser privileges.

You must have superuser privileges to perform the following tasks.

5. Use the /etc/init.d/sms script to stop SMS.

sc0: # /etc/init.d/sms stop

6. Use the /etc/init.d/sms script to restart SMS.

sc0: # /etc/init.d/sms start



Note Note - This procedure assumes that smsconfig -m has already been run. If smsconfig -m has not been run, you will receive the following error and SMS will exit.

sc0: # /etc/init.d/sms startsms: smsconfig(1M) has not been run. Unable to start sms services.



7. Log out as superuser.

8. Log in to the SC as a user with platform administrator privileges.

9. Turn on failover.

sc0: # /opt/SUNWSMS/bin/setfailover on

10. Type:

sc0:sms-user:> /opt/SUNWSMS/bin/showenvironment

11. Wait until showenvironment finishes displaying all board status.

At this point you can log out and begin using SMS programs.


Mounting the CD-ROM over NFS


procedure icon  To Share SMS Packages on the Spare SC to the Main SC

1. Log in to the main SC as superuser.

2. Insert the Software Supplement for the Solaris 9 05/02 Operating Environment CD-ROM into the CD-ROM drive.

3. Use the share (1M) command to share the CD across the network.

  1. Verify that the nfsd server is running. Type:

    sc0:#ps -ef | grep nfsd

Add a CDROM entry to the /etc/dfs/dfstab file:

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

To propagate the CDROM image to NFS, type:

sc0:#/etc/init.d/nfs.server start

4. Log in to the spare SC as superuser.

5. Create and mount the /cdrom directory for the spare SC.

sc1:# mkdir /cdrom
sc1:# mount SC-I1: /cdrom/cdrom0 /cdrom

where:

SC-I1: is the hostname specified for the SC I1 network in Step 5 of To Configure the Management Network (MAN) Using smsconfig(1M) .

6. Change to the Product installation directory:

sc1: # cd /cdrom/cdrom0/System_Management_Services_1.2/Product