C H A P T E R  2

Installation and Setup

This chapter contains instructions for installing, setting up, uninstalling, starting, and stopping Sun Fire 6800/4810/4800/3800 add-on software. Refer to the Sun Management Center 3.5 Installation and Configuration Guide for information about installing, setting up, uninstalling, starting, and stopping base Sun Management Center software.



caution icon

Caution - Use the installation scripts and the setup scripts provided with the Sun Management Center 3.5 software. Do not manually add packages or manually change configuration files.



Your Sun Management Center 3.5 installation and setup scripts or GUI panels may not display exactly the same messages in exactly the same sequence as the examples shown in this chapter. However, these examples show the basic messages you will receive in approximately the sequence you will receive them. Your actual installation and setup scripts depend on the add-on components you choose to install and other choices you make.

See Using the CLI to Install, Set up, Uninstall, Start, and Stop Sun Management Center Software to perform these functions using the command line interface (CLI).


Sun Fire 6800/4810/4800/3800 System-Specific Packages

TABLE 2-1 lists the Sun Fire 6800/4810/4800/3800 system-specific packages with the host they should be installed on, and the base layer they belong to.

TABLE 2-1 Sun Management Center Packages for Sun Fire 6800/4810/4800/3800 Systems

Package

Description

Host

Layer

SUNWesadf

Sun Management Center agent support for dynamic reconfiguration on Sun Fire 15000, 6800/4810/4800/3800 systems

Sun Fire 6800-3800 platform machine

Agent

SUNWescdf

Sun Management Center console support for dynamic reconfiguration on Sun Fire 15000, 6800/4810/4800/3800 systems

Workstations of common network location

Console

SUNWessco

Sun Management Center Sun Fire support - server component

Sun Management Center server machine

Server

SUNWessda

Sun Management Center - Sun Fire 6800/4810/4800/3800 domain agent

Sun Fire 6800-3800 domains

Agent

SUNessdf

Sun Management Center server support for dynamic reconfiguration on Sun Fire 15000, 6800/4810/4800/3800 systems

Sun Fire 6800-3800 platform machine

Agent

SUNWesspa

Sun Management Center - Sun Fire platform agent

Sun Fire 6800-3800 platform machine

Agent

SUNWesspc

Sun Management Center console for Sun Fire platform administration

Sun Fire 6800-3800 platform machine

Agent

SUNWessps

Sun Management Center - Sun Fire platform support

Sun Fire 6800-3800 platform machine

Agent

SUNWesssd

Sun Management Center server for Sun Fire 6800/4810/4800/3800 domain

Sun Management Center server machine

Server

SUNWessdc

Sun Management Center Sun Fire 6800/4810/4800/3800 domain administration

Sun Fire 6800-3800 domains

Agent

SUNWedacs

Sun Management Center Sun Fire 6800-3800 Domain Admin module setup for server and agent

Sun Management Center server machine and Sun Fire 6800-3800 domains

Server

Agent

SUNWesscp

Sun Management Center Sun Fire Support - server component for Platform Admin module

Sun Management Center Server

Server

SUNWesccp

Sun Management Center Sun Fire Support - console component for Platform Admin module

Console

Console

SUNWesccd

Sun Management Center Sun Fire Support - console component for Dynamic Reconfiguration

Console

Console



What You Can Do

With Sun Management Center 3.5 software, you can install, set up, uninstall, and update in different ways, primarily using the Sun Management Center 3.5 Wizards or the command line interface (CLI). You might also need to perform certain procedures if you want to use certain features. TABLE 2-2 lists the various procedures with a cross-reference to the information in this chapter.

TABLE 2-2 Pre-Installation, Installation, Setup, Uninstallation, Upgrade, and Post-Installation Procedures

To Perform This Task

Described in

Enable SC failover and find logical IP address

Enabling the SC Failover Capability

Set Up SNMP on the system controller

Setting Up SNMP on the System Controller

Installing software using the Sun Management Center Installation 3.5 Wizard

Refer to the Sun Management Center 3.5 Installation and Configuration Guide

Setting Up the Sun Fire 6800/4810/4800/3800 Add-on Software Using the Setup Wizard

Setting Up the Sun Fire 6800/4810/4800/3800 Add-on Software Using the Setup Wizard

Using Advanced Wizard Setup Options

Update multiple hosts using Agent Update

Updating Multiple Hosts Using Agent Update

Creating and Setting Up a Platform Agent

Creating and Setting Up a Sun Fire 6800/4810/4800/3800 Platform Agent Instance

Starting Software Using the Start Wizard

Starting Sun Management Center Software Using the Start Wizard

Stopping Software Using the Stop Wizard

Stopping Sun Management Center Software Using the Stop Wizard

Uninstalling Software Using Uninstall Wizard

Uninstalling Sun Management Center Software Using the Uninstall Wizard

Assigning Users

Assigning Users to Groups

Undoing Setups and Deleting Platform Agents

Undoing Setups and Deleting Platform Agents

Setting Up Domains

Setting Up Domains

Install Sun Management Center 3.5 base software using the CLI

Refer to the Sun Management Center 3.5 Installation and Configuration Guide

Installing Sun Fire 6800/4810/4800/3800 add-on packages using the CLI

To Install the Supplement Software Using the CLI

Setting up Sun Fire 6800/4810/4800/3800 add-on packages using the CLI

Setting Up the Software Using the CLI

Uninstalling one module, several modules, or all Sun Management Center software using the CLI

Uninstalling Software Using the CLI

Starting software using the CLI

Starting Sun Management Center Components

Stopping software using the CLI

Stopping Sun Management Center Components



Enabling the SC Failover Capability

If you want to use the SC Failover capability, you need to do the following before you install and set up the Sun Fire 6800/4810/4800/3800 add-on software:



Note - If you use the physical IP address of one SC during setup of the add-on software, when failover occurs, the add-on software is no longer communicating with the now main SC. To allow the add-on software to communicate with whichever SC is the main SC, you need to create a logical IP address that refers to both SCs.



You then need to use that logical IP address when you set up the Sun Fire 6800/4810/4800/3800 add-on software.


procedure icon  To Enable the SC Failover Capability and Set Up a Logical IP Address

1. Select an unused IP address that begins with the same subnet address as both SCs.

For example, if one SC has an physical IP address of 129.146.235.14 and the other SC has a physical IP address of 129.146.235.41, the logical IP address would be 129.146.235.xxx, where xxx is an unused IP address within that subnet. For the example in Step 2, 129.146.235.251 is used as the logical IP address.

2. From the SC, set up a logical IP address for the SC using the following command.

schostname:SC> setupplatform -p sc

The system displays the following:

SC
--
SC POST diag Level [off]:
Enable SC Failover? [no]:
Logical Hostname or IP Address [ ]:

3. Type yes to Enable SC Failover.

4. Type the logical IP address you selected in Step 1 (129.146.235.251 in our example).

5. Use this logical IP address to set up the platform agent during es-setup or es-guisetup.


Setting Up SNMP on the System Controller

Before you install and set up Sun Fire 6800/4810/4800/3800 add-on software, you need to configure SNMP on the platform and the domain. This section contains both procedures, and you need to do both.

  • Configuring SNMP on the platform
  • Configuring SNMP on the domain

procedure icon  To Configure SNMP on the Platform



Note - Do not set up multiple Platform Administration Agents to manage the same Sun Fire 6800/4810/4800/3800 system controller. Doing so causes the system to run slowly or even hang.



1. As superuser, access the system controller by using the telnet(1) command as shown in CODE EXAMPLE 2-1.

CODE EXAMPLE 2-1 Accessing the System Controller With telnet and Entering the Platform Shell
# telnet schostname
System Controller schostname:SC>
 
Type 0 for Platform Shell
 
Type 1 for domain A 
Type 2 for domain B
Type 3 for domain C
Type 4 for domain D
 
Input: 0
schostname:SC>

where schostname is the system controller host name.

2. At the system controller main menu, type 0 (or alternatively P or p) to enter the platform shell as shown in CODE EXAMPLE 2-1.

The platform shell prompt, schostname:SC, is displayed.

3. Type setupplatform -p snmp, and answer the questions as shown in CODE EXAMPLE 2-2.

CODE EXAMPLE 2-2 Configuring an SNMP Agent on a Platform
schostname:SC> setupplatform -p snmp
SNMP
----
Platform Description [description]: your_description
Platform Contact [contactname]: contact_name
Platform Location [location]: your_platform_location
Enable SNMP Agent? [no]: yes
Trap Hosts [hostname]: monitoring_machine
Public Community String [string]: your_string1
Private Community String [string]: your_string2



caution icon

Caution - For Trap Hosts, be sure to enter the host name of the machine where you will run the Platform Admin module and from which you will monitor your Sun Fire 6800/4810/4800/3800. For example, your monitoring_machine might be called CompA, and you want to monitor your main SC called tiger-sc0 among other machines. You would run the setupplatform command as shown in CODE EXAMPLE 2-2 on tiger-sc0, and enter CompA as the Trap Host.





Note - You need to enter both the platform trap host here and the domain trap host in Step 4 in To Configure SNMP on a Domain for the platform administration module to monitor the domain state changes.



4. Press and hold the CTRL key while pressing the ] key, to get to the telnet> prompt.

5. Type q to exit from telnet.


procedure icon  To Configure SNMP on a Domain

1. As superuser, access the system controller by typing the telnet command as shown in CODE EXAMPLE 2-3.

CODE EXAMPLE 2-3 Accessing the System Controller With telnet and Entering the Domain Shell
# telnet schostname
System Controller schostname:SC>
 
Type 0 for Platform Shell
 
Type 1 for domain A 
Type 2 for domain B
Type 3 for domain C
Type 4 for domain D
 
Input: 1
schostname:A>

where schostname is the system controller host name. In CODE EXAMPLE 2-3, domain A is shown as an example.

2. Enter a domain. Type 1, 2, 3, or 4 (or alternatively a, b, c, d, or A, B, C, D) to enter the proper domain shell as shown in CODE EXAMPLE 2-3.

The domain shell prompt, schostname:X, is displayed, where X is the domain that you have selected.

3. If the domain is active and the domain keyswitch is set to on, diag, or secure (you are running the Solaris Operating System, you are in OpenBoot PROM mode, or you are running POST), perform the following steps:

a. Press and hold the CTRL key while pressing the ] key, to get to the telnet> prompt.

b. At the telnet> prompt type send break.

CODE EXAMPLE 2-3 shows a connection to domain A.

4. Type setupdomain -p snmp, and answer the questions as shown in CODE EXAMPLE 2-4.

CODE EXAMPLE 2-4 Configuring an SNMP Agent on a Domain
schostname:A> setupdomain -p snmp
SNMP
----
Domain Description [description]: your_description
Domain Contact [contactname]: contact_name
Trap Hosts [hostname]: server_name
Public Community String [string1]: your_string1
Private Community String [string2]: your_string2

For Trap Hosts, enter the host name of the Sun Management Center server from which you will perform platform administration.



Note - You need to enter both the platform trap host in Step 3 in To Configure SNMP on the Platform and the domain trap host here for the platform administration module to monitor the domain state changes.



For Public and Private Community Strings, enter a different string for each domain and platform.

5. Type disconnect to exit the connection to the domain shell.

6. Repeat Step 2 through Step 5 for each additional domain, if any.

7. Press and hold the CTRL key while pressing the ] key, to get to the telnet> prompt.

8. Type q to exit from telnet.


Installing the Sun Fire 6800/4810/4800/3800 Add-on Software Using the Install Wizard

This section provides a summary of installing Sun Management Center 3.5 base software and Sun Fire 6800/4810/4800/3800 add-on software using the Install Wizard. Chapter 6, Installation and Setup, of the Sun Management Center 3.5 Installation and Configuration Guide, describes in detail how to install all the software.

  • You can install the console, server, and agent layers either separately or in combination.
  • You can install the Sun Fire 6800-3800 Platform Agent on any machine where you have Sun Management Center 3.5 software running.
  • You can install the Sun Fire 6800-3800 Domain Agent only on Sun Fire 6800-3800 domains.

Summary of Sun Management Center 3.5 Software Installation

1. As superuser, run the es-guiinst script as described in Chapter 6, "Installation and Setup," of the Sun Management Center 3.5 Installation and Configuration Guide.

2. After the base software is installed, the Select Add-on Product screen provides a selectable list of add-on products that you can install. Select those add-ons that apply to Sun Fire 6800/4810/4800/3800 systems, and click Next.

3. The Sun Management Center Setup Wizard starts automatically after all the software is installed.


Setting Up the Sun Fire 6800/4810/4800/3800 Add-on Software Using the Setup Wizard

This section describes how to set up the platform agent and the domain agent on Sun Fire 6800/4810/4800/3800 systems using the Sun Management Center Setup Wizard. For more details about the entire software setup process, refer to Chapter 6, "Installation and Setup," of the Sun Management Center 3.5 Installation and Configuration Guide.



Note - When the Back button at the bottom of a panel is enabled (not grayed out), you can click on it to take you back to the previous operation. When the back button is grayed out (not enabled), you cannot go back to the previous operation.





Note - Be sure you click Store Response Data during the Sun Management Center 3.5 base software setup process if you want to use the setup-responses-file to duplicate the setup on the current machine on other machines. That way all of your responses will be stored in /var/opt/SUNWsymon/install/setup-responses-file. For more information, refer to "Setting Up Base Products and Add-ons on the Solaris Platform" in the Sun Management Center 3.5 Installation and Configuration Guide.




procedure icon  To Set Up the Platform Agent Using the Setup Wizard

Set up the Sun Fire 6800-3800 Platform Agent on any machine where you have installed it.

1. Type es-guisetup on a machine where the platform agent is installed to start the Sun Management Center Setup Wizard.

Once the Sun Management Center base software setup is complete, the Wizard displays the following message:

Select Add-on Products
 
The following add-on products are newly installed on this system and will be set up.
 
  - Sun Fire Platform Administration

2. Click Next to continue.

Do one of the following:

  • If you are not setting up the platform agent on a server machine, go to Step 4.
  • If you are setting up the platform agent on a server machine, the Sun Fire 6800-3800 Platform Agent Setup panel displays the following message.

 FIGURE 2-1 Server Host Only Query Panel

Screen capture of the Sun Management Center Setup Wizard, displaying the "server host only" query.

3. Do one of the following:

  • Click the radio button to the left of No to continue and set up all hosts. Go to Step 4.
  • Click the radio button to the left of Yes to only set up the server host.

The Sun Fire 6800-3800 Platform Agent Setup panel displays the following message. Go to Step 20l

Setting up server host...
 
Status:
Setting up server host...
...
Setup of server host complete.

4. Click Next to continue.

The Sun Fire 6800-3800 Platform Agent Setup panel displays the following message:

To set up the Sun Fire 6800-3800 platform administration module, you need to provide SC IP address, community strings, port numbers for domain agent etc.
 
Would you like to set up the Sun Fire 6800-3800 platform administration module?
O Yes
O No

5. Do one of the following:

  • Click the radio button to the left of No to not set up the Platform Administration module. Go to Step 23.
  • Click the radio button to the left of Yes to set up the Platform Administration module.

The Sun Fire 6800-3800 Platform Agent Setup panel displays the following:

 FIGURE 2-2 Platform Administration Platform Configuration Panel

Screen capture of the Sun Management Center Setup Wizard, displaying the platform configuration panel.

Note - You must enter a value for each prompt.



i. Type the host name or IP address of the System Controller (for example, 10.8.28.209).



caution icon

Caution - If you want to use the SC failover feature, you must put a logical IP address in this field. Both SCs can then use this logical IP address. Only one SC can use a physical IP address. If you do not put a logical IP address in this field and if a SC failover occurs, you receive a red alarm that the SC is not responding. For information about enabling SC failover and setting up a logical IP address, see To Enable the SC Failover Capability and Set Up a Logical IP Address.



ii. Type the read community string for the platform (for example, P-public).

iii. Type the write community string for the platform (for example, P-private).

6. Click Next to continue.

The Sun Fire 6800-3800 Platform Agent Setup panel displays the following message:

 FIGURE 2-3 Platform Administration Domain Community Configuration Panel

Screen capture of the Sun Management Center Setup Wizard, displaying the domain community configuration panel.

Note - You must enter a value for each domain.



a. Type the write community string for domain A, such as A-private

b. Type the write community string for domain B, such as B-private

c. Type the write community string for domain C, such as C-private

d. Type the write community string for domain D, such as D-private

7. Click Next to continue.

The Sun Fire 6800-3800 Platform Agent Setup panel displays the following message:

 FIGURE 2-4 Platform Administration Domain IP Configuration Panel

Screen capture of the Sun Management Center Setup Wizard, displaying the domain IP configuration panel.

a. Type the IP address or host name of domain A, or leave blank.

b. Type the IP address or host name of domain B, or leave blank.

c. Type the IP address or host name of domain C, or leave blank.

d. Type the IP address or host name of domain D, or leave blank.

8. Click Next to continue.

The Sun Fire 6800-3800 Platform Agent Setup panel displays the following message:

 FIGURE 2-5 Platform Administration Domain Port Configuration Panel

Screen capture of the Sun Management Center Setup Wizard, displaying the domain port configuration panel.

Note - You must enter a value for each domain.



a. Type the Sun Management Center agent port number on domain A.

b. Type the Sun Management Center agent port number on domain B.

c. Type the Sun Management Center agent port number on domain C.

d. Type the Sun Management Center agent port number on domain D.

9. Click Next to continue.

The Sun Fire 6800-3800 Platform Agent Setup panel displays the following message:

Updating configuration files with platform and domain information.
 
Status:
 
Updating configuration files...
Update of configuration files complete.

10. Click Next to continue.

The Sun Fire 6800-3800 Platform Agent Setup panel displays the following message:

Setting up server host and chassis model information.
 
Status:
 
Setting up server host...
....
Setup of server host complete.
Getting chassis model from system controller...
Retrieval of chassis model from system controller complete.

  • If there was no error in getting the chassis model, go to Step 11.
  • If there was an error in getting the chassis model from the system controller, the system displays an error message:
  • Error getting chassis model from system controller.
    

i. Click OK.

The Sun Fire 6800-3800 Platform Agent Setup panel displays the following message:

Either could not find the chassis model from the SC or the SC returned an unknown chassis model. These are the supported model types: 3800, 4800, 4810, and 6800. The chassis model needs to be one of these models.
 
Chassis model:

ii. Enter 3800, 4800, 4810, or 6800 for the chassis model.

11. Click Next to continue.

The Sun Fire 6800-3800 Platform Agent Setup panel displays the following message:

Checking configuration files...
 
Status:
 
Set the platform server: <hostname> or <IPaddress>
platform.snmpPort: 166
Default platform agent port: 166
Checking of configuration files complete.

12. Click Next to continue.

One of the following occurs:

  • You will not see the default port panel if the default port number has been set previously. Go to Step 14.
  • The Sun Fire 6800-3800 Platform Agent Setup panel displays the following message if the default port number was not set previously.

 FIGURE 2-6 Platform Administration Default Platform Port Panel

Screen capture of the Sun Management Center Setup Wizard, displaying the default platform port panel.

13. Do one of the following:

  • Click the radio button to the left of Yes to use the default Sun Management Center platform agent port.
  • Click the radio button to the left of No to not use the default Sun Management Center platform agent port.

14. Click Next to continue.

The Sun Fire 6800-3800 Platform Agent Setup panel displays the following message:

Set the platform agent port.
 
Platform agent port number: 166

One of the following occurs:

  • If you clicked Yes to use the default port, the default agent port number is displayed for Platform agent port number.
  • If you clicked No to not use the default port, the Platform agent port number is blank for you to enter.
    • Enter the platform agent port number you want to use.

15. Click Next to continue.

One of the following occurs.

  • If you do not receive a warning message, go to Step 22.
  • If the default port is in use, the Sun Fire 6800-3800 Platform Agent Setup panel displays a warning message.
  • Warning, platform agent port 166 is currently in use. Pick a different port, or ensure that this port is available when you next start Sun Management Center.
    
    Would you still like to use this port?
    
                         Yes   No
    

16. Do one of the following:

  • Click No to not use the default port. Go to Step 14.
  • Click Yes to still use the default port.

17. Click Next to continue.

One of the following occurs:

  • If there was no port conflict, the Sun Fire 6800-3800 Platform Agent Setup panel displays the following message:
  • Confirmation of the platform agent port.
    
     
    
    Platform agent port: 166
    

  • If there was a port conflict, the Sun Fire 6800-3800 Platform Agent Setup panel displays the following message:
  • Confirmation of the platform agent port.
    
     
    
    Platform agent port: 166
    
     
    
    Remember to resolve the port conflict prior to starting Sun Management Center.
    

18. Click Next to continue.

One of the following occurs:

  • If the platform agent port number was not changed, you do not receive the security keys message; go to Step 22.
  • If the platform agent port number was changed, the Sun Fire 6800-3800 Platform Agent Setup panel displays the following message:

 FIGURE 2-7 Platform Administration Generate Security Keys Panel

Screen capture of the Sun Management Center Setup Wizard, displaying the "generate security keys" panel.

19. Do one of the following:

  • Click the radio button to the left of Yes to regenerate the security keys now, and go to Step 22.
  • Click the radio button to the left of No to not regenerate the security keys now.

The same Sun Fire 6800-3800 Platform Agent Setup panel appears as in FIGURE 2-7.

20. Do one of the following:

  • Click the radio button to the left of Yes to regenerate the security keys now, and go to Step 21.
  • Click the radio button to the left of No to not regenerate the security keys now, and go to Step 22.

21. Click Next to continue.

The Sun Fire 6800-3800 Platform Setup panel displays this message:

This part of setup generates security keys used for communications between processes. A seed must be provided to initialize the keys. Make sure you use the same seed for all the machines you install. You may like to keep record of this seed for future use.
 
Seed:
 
Seed:                   (Re-enter seed to confirm.)



Note - Ensure you store the seed password securely. It will be needed if you perform any modifications to your Sun Management Center installation.



a. Enter a unique password for the seed if this is a first-time installation. If not, enter the seed used in previous versions of Sun Management Center.

b. Reenter the seed to confirm.

22. Click Next to continue.

The Sun Fire 6800-3800 Platform Setup panel displays this message:

Updating configuration files with module and discover table information...
 
Status:
 
Added module....
Added module....
Updated Discovery Table....
Update of configuration files complete.

23. Click Next to continue.

The Sun Fire 6800-3800 Platform Setup panel displays this message:

Sun Fire 6800-3800 Platform Admin setup is complete.

24. Click Next to continue.

The Sun Fire 6800-3800 Platform Setup panel displays this message:

The following products have been set up:
 
  - Sun Fire Platform Administration
 
Click Next to invoke the Start Wizard now to the various Sun Management Center components.


procedure icon  To Set Up the Domain Agent Using the Wizard GUI

Set up the Sun Fire 6800-3800 Domain Agent on any Sun Fire 6800-3800 Domain where you have installed it.

1. Type es-guisetup on a Sun Fire 6800-3800 Domain where the domain agent is installed to start the Sun Management Center Setup Wizard.

Once the Sun Management Center base software setup is complete, the Wizard displays the following message:

Click Next to set up the following products:
Sun Fire Domain Administration

2. Click Next to start the Domain Agent setup.

The Sun Fire 6800-3800 Domain Agent Setup panel displays the following message:

Updating configuration files...
 
Status:
 
Updating configuration files...
Update of configuration files complete.

3. Click Next to continue.

The Sun Fire 6800-3800 Domain Agent Setup panel displays the following message:

Sun Fire 6800-3800 Domain Agent setup is complete.


Using Advanced Wizard Setup Options

The base Sun Management Center Setup Wizard provides these advanced setup options when the current Sun Management Center installation is already configured:



Note - Use the Reconfigure All option instead of the Remove Setup Configuration option at this time.



  • Reconfigure All--Removes all current setup configurations and immediately reruns the Setup Wizard.
  • Configure Add-on Products--Sets up the add-on products only.
  • Recreate the Sun Management Center Database (server only)--Recreates the database. You are given the option to clear all data, or save and use the data in the recreated database.
  • Remove Setup Configuration--Returns your Sun Management Center installation to the post-install and pre-setup state. All configuration and database information is removed. This is useful when you need to perform other tasks prior to rerunning the Setup Wizard.

Refer to the Sun Management Center 3.5 Installation and Configuration Guide for more information about using these options.


Updating Multiple Hosts Using Agent Update

This section describes how to update multiple hosts at once using Agent Update. The Agent Update process itself must be run on the Sun Management Center server machine. You also need to ensure that Sun Management Center 3.5 agents are running on all the target hosts.

Before You Start the Agent Update Process

To use Agent Update to fully install and set up the Sun Fire 6800/4810/4800/3800 Platform Administration module, you must create an Agent Update configuration file for the module on the target hosts, before you run the Agent Update Process on the Sun Management Center server machine.



Note - Be sure you click Store Response Data during the Sun Management Center 3.5 base software setup process if you want to use the setup-responses-file to duplicate the setup on the current machine on other machines. That way all of your responses will be stored in /var/opt/SUNWsymon/install/setup-responses-file. For more information, refer to "Setting Up Base Products and Add-ons on the Solaris Platform" in the Sun Management Center 3.5 Installation and Configuration Guide.




procedure icon  To Create the Agent Update Configuration File on the Target Hosts

1. Ensure the Sun Fire 6800/4810/4800/3800 Platform Administration module is installed on the target hosts.

2. Ensure that the Sun Fire 6800/4810/4800/3800 Platform Administration module is set up on the target hosts using either the es-setup or the es-guisetup script.

After this has been done, subsequent Platform Administration setup operations using Agent Update will work automatically, using the host-specific information provided initially.

Using the Agent Update Process

Using the Agent Update process, you will create an Image File of the add-on components to be distributed to the target machines, and then add a New Job to Manage Jobs Task list to be run when you specify.

Supported Update Configurations

Using Agent Update you can update the following configurations:


procedure icon  To Update From Sun Management Center 3.5 Add-on Software

This procedure applies only to updating from Sun Management Center 3.5 add-on software.

1. Create an Image File of the desired Sun Fire 6800-3800 add-on components to be distributed to the desired agent machines using one of the base Sun Management Center scripts es-gui-imagetool or es-imagetool.

Refer to Chapter 8, "Post-Installation Tasks," in the Sun Management Center 3.5 Installation and Configuration Guide for detailed instructions about using either the GUI or the CLI Image Tool.

2. From your main Sun Management Center console window, select the Manage Jobs... option from the Tools menu.

The system displays the Manage Jobs panel (see FIGURE 2-8), which allows you to distribute the Image File.

 

FIGURE 2-8 Manage Jobs Panel

Screen capture of the Manage Jobs panel.

3. In the Manage Jobs panel, select the New Task... button.

The system displays the New Task panel (see FIGURE 2-9), which allows you to specify the Agent Update Image File to distribute.

 FIGURE 2-9 New Task Panel

Screen capture of the New Task panel.

4. In the New Task panel (FIGURE 2-9), do the following:

a. Select Agent Update for the Task Type.

b. Select the Image File you created in Step 1.

c. Enter the Task Name.

d. Click the Add Task button.

e. Click the Close button.

5. In the Manage Jobs panel (FIGURE 2-8), do the following:

a. Enter a Job Name.

b. Select the Task you created in Step 4.

c. Do one of the following to schedule when you want the Task to run:

    • If you want the Task to run immediately, click the radio button to the left of Run Immediately.
    • If you want to set a schedule for when the Task is to run, click the radio button to the left of Schedule Job, and set the schedule.


Note - Before you select objects (agent machines) where you want the Image File, you can create a group object containing all your agent machines. That way you do not have to select one agent machine at a time. Refer to Chapter 3, "To Create a Group," in the Sun Management Center 3.5 User's Guide for more information about creating object groups.



d. Do one of the following to select the objects (agent machines) to which you want to distribute the Image File:

    • Click the radio button to the left of All Objects in Domain to select all objects, and specify any filter you want to use to further select objects.
    • Click the radio button to the left of Selected Objects in Main Window to select one object at a time.

e. Preview the objects (agent machines) you have selected and redo your selections if necessary.

f. Click the Add Job button.

The job starts and distributes the Image File to the objects (agent machines) you selected. When the job is running, it appears in the Job list of the Manage Jobs panel. The panel shows the status of the job when running and when complete.



Note - When updating multiple hosts, any failure of a host results in a Failed status even though the majority of the hosts might have been updated successfully. Click on View Log to the right of the Jobs list on the Manage Jobs panel to see an individual list of the updates that succeeded and the updates that failed. If the Agent Update process did succeed, the Sun Management Center agents should restart automatically. You can open a host Details window on the Sun Management center console to each of the targeted hosts, and verify that the expected modules are present and working.




procedure icon  To Update From No Add-on Software or Sun Management Center 3.0 Platform Update 4 Add-on Software

This procedure applies to either:

  • Updating from no add-on software to Sun Management Center 3.5 add-on software
  • Updating from Sun Management Center 3.0 Platform Update 4 add-on software to Sun Management Center 3.5 add-on software

1. Log in as root on the Sun Management Center server machine.

2. Create an agent-update image using either of the image tools.

  • To create an agent-update image using es-gui-imagetool, follow the instructions in "To Create an Agent-Update Image Using es-gui-imagetool" in the Sun Management Center 3.5 Installation and Configuration Guide.
  • To create an agent-update image using es-imagetool, follow the instructions in "To Create an Agent-Update Image Using es-imagetool" in the Sun Management Center 3.5 Installation and Configuration Guide.

3. Download the file /opt/SUNWsymon/base/bin/agent-update.bin to each target machine's root directory.

If you installed Sun Management Center in a different directory than /opt, download /installdir/SUNWsymon/base/bin/agent-update.bin, where installdir is the install directory you specified.

4. Log in as root on the target machine.

5. Go to the directory where you downloaded agent-update.bin.

6. Type ./agent-update.bin -s server -r http-port -p image-name, where

  • server is the server that you logged into in Step 1.
  • http-port is the Sun Management Center Web server port.
  • image-name is the name of the agent-only image you created in Step 2.

7. Provide the security seed and the SNMPv1 community string.

The agent-update process prompts you for the security seed and the SNMPv1 community string.

  • The security seed must be the same seed that you provided when you sent up the Sun Management Center server and agent.
  • The SNMPv1 community string must be the same community string you provided when you set up the Sun Management Center server and agent.

The update process applies the update to the machine without prompting for further information.

When the update process completes, check the update status by viewing the log file /var/opt/SUNWsymon/log/agent-update.log on the server host.



Note - You need to re-run ./es-setup -F to set up the platform agent.




Creating and Setting Up a Sun Fire 6800/4810/4800/3800 Platform Agent Instance

The default platform administration module can monitor one Sun Fire 6800/4810/4800/3800 system. To monitor more than one Sun Fire 6800/4810/4800/3800 system, you must create one platform agent instance for each additional Sun Fire 6800/4810/4800/3800 system.


procedure icon  To Create a Platform Agent Instance

1. Become superuser by using the su command.

2. Go to the directory where Sun Management Center software is installed.

For example, if Sun Management Center software is installed in /opt/SUNWsymon, go to the directory /opt/SUNWsymon/sbin.

3. Run the es-platform script:

# ./es-platform -a instanceName

where instanceName is the name of a new platform agent instance.

This script asks for the port number for the new platform agent and the security seed. If you used a seed other than the default when setting up the Sun Management server, provide the same seed for this agent.

4. To set up this instance, go the Step 3 in the following procedure To Set Up a Sun Fire 6800/4810/4800/3800 Platform Administration Module for a New Platform Agent Instance


procedure icon  To Create Multiple Platform Agent Instances

1. Become superuser by using the su command.

2. Go to the directory where Sun Management Center software is installed.

For example, if Sun Management Center software is installed in /opt/SUNWsymon, go to the directory /opt/SUNWsymon/sbin.

3. Run the es-platform script:

# ./es-platform -a instanceName

where instanceName is the name of a new platform agent instance.

This script asks for the port number for the new platform agent.

a. Enter a new, not previously used port number.



Note - Be sure you use this port number when you set up this instance and when you create this platform instance object on the Sun Management Center console.



The script asks for the security seed.

b. If you used a seed other than the default when setting up the Sun Management server, provide the same seed for this agent.

4. Stop the Sun Management Center agent process.

# ./es-stop -A

5. To set up this instance, go the Step 3 in the following procedure To Set Up a Sun Fire 6800/4810/4800/3800 Platform Administration Module for a New Platform Agent Instance.


procedure icon  To Set Up a Sun Fire 6800/4810/4800/3800 Platform Administration Module for a New Platform Agent Instance

1. Become superuser by using the su command.

2. Go to the directory where Sun Management Center software is installed.

For example, if Sun Management Center software is installed in /opt/SUNWsymon, go to the directory /opt/SUNWsymon/addons/SunFirePltAdmin/sbin.



Note - Before you perform Step 3, be sure you have stopped the Sun Management Center agent layer. To stop the agent layer, run the command /opt/SUNWsymon/sbin/es-stop -a.



3. Type:

# ./es-setup.sh -I instanceName 

where instanceName is the name of a new platform agent instance.

The es-setup.sh script asks for this information:

  • IP Address of the Sun Fire 6800/4810/4800/3800 system controller.
  • Write community strings for the system controller and all the domains. If the script cannot get the domain address from the system controller, then it asks for the IP address of all the domains.
  • Port number of the Sun Management Center agents on all the domains.

This script can be run again to change the information provided in the previous setup.

4. To start the platform instance, go to the following procedure To Start the Platform Instance.


procedure icon  To Start the Platform Instance

When the platform instance is set up, you can start it.

single-step bulletTo start the platform instance, type:

# ./es-start -y instanceName 


procedure icon  To Stop the Platform Instance

single-step bulletIf you have a need to stop the platform instance, type:

# ./es-stop -y instanceName 

For information about how to undo setups and delete platform agents, see Undoing Setups and Deleting Platform Agents.


Starting Sun Management Center Software Using the Start Wizard

Use the es-guistart script to use the Start Wizard to start Sun Management Center software. Refer to Chapter 7, "Starting and Stopping Sun Management Center Software," in the Sun Management Center 3.5 Installation and Configuration Guide for detailed options and instructions.


Stopping Sun Management Center Software Using the Stop Wizard

Use the es-guistop script to use the Stop Wizard to stop Sun Management Center software. Refer to Chapter 7, "Starting and Stopping Sun Management Center Software," in the Sun Management Center 3.5 Installation and Configuration Guide for detailed options and instructions.


Uninstalling Sun Management Center Software Using the Uninstall Wizard

Use the es-guiuninst script to use the Uninstall Wizard to uninstall Sun Management Center software. Refer to Chapter 5, "Uninstalling Previous Versions of Sun Management Center Software," in the Sun Management Center 3.5 Installation and Configuration Guide for detailed options and instructions.


Assigning Users to Groups

This section describes how to assign users to administrator and operator groups to give the users the type of access they will need to perform operations that are assigned to them.


procedure icon  To Assign Users to Administrator and Operator Groups

If a user name is listed in the esusers file, that user can log onto that Sun Fire 6800/4810/4800/3800 system, where the user has read-only access for domain administration agents. In order to read and write platform or domain information under the platform agent, the user name must also be listed in the group file on the server.

The setup procedure creates up to 10 groups on the Sun Fire 6800/4810/4800/3800 server machine. These groups are:

TABLE 2-3 User Groups

Group Name

User Category

Type of Access

spltadm

Administrator

Platform

sdaadm

Administrator

Domain A

sdbadm

Administrator

Domain B

sdcadm

Administrator

Domain C

sddadm

Administrator

Domain D

spltop

Operator

Platform

sdaop

Operator

Domain A

sdbop

Operator

Domain B

sdcop

Operator

Domain C

sddop

Operator

Domain D


1. Become superuser by using the su command.

2. Add each user to the appropriate group in the file /etc/group.

a. Add Sun Fire 6800/4810/4800/3800 platform administrators to spltadm, to allow them to administer the platform through the platform view of a platform agent.

b. Add Sun Fire 6800/4810/4800/3800 domain administrators to the appropriate domain administrator group.

For example, adding the name of a domain administrator to sdaadm allows that domain administrator to administer domain A through the platform agent.

3. Add each user to the file /var/opt/SUNWsymon/cfg/esusers.


Undoing Setups and Deleting Platform Agents

If you no longer need to monitor a Sun Fire 6800/4810/4800/3800 system, you can save system resources by undoing the setup for the corresponding platform agent or instance, and then deleting it.


procedure icon  To Undo the Setup of the Sun Fire 6800/4810/4800/3800 Default Platform Administration Module

1. Become superuser by using the su command.

2. Go to the path/addons/SunFirePltAdmin/sbin directory, where path is the directory where Sun Management Center software is installed.

For example, if Sun Management Center software is installed in /opt/SUNWsymon, go to the directory /opt/SUNWsymon/addons/SunFirePltAdmin/sbin.

3. Undo the setup for the default platform agent by typing:

# ./es-setup.sh -u


procedure icon  To Undo the Setup of a Sun Fire 6800/4810/4800/3800 Platform Administration Instance

1. Become superuser by using the su command.

2. Go to the path/addons/SunFirePltAdmin/sbin directory, where path is the directory where the Sun Management Center software is installed.

For example, if Sun Management Center software is installed in /opt/SUNWsymon, go to the directory /opt/SUNWsymon/addons/SunFirePltAdmin/sbin.

3. Undo the setup for a specific platform agent instance by typing:

# ./es-setup.sh -u -I instanceName 



Note - Undoing this setup stops the Sun Management Center agent.



4. Restart the agent.


procedure icon  To Delete a Platform Agent

1. Become superuser by using the su command.

2. Go to the directory path/sbin, where path is the directory where Sun Management Center software is installed.

For example, if Sun Management Center software is installed in /opt/SUNWsymon, go to the directory /opt/SUNWsymon/sbin.

3. Delete the platform agent instance by typing:

# ./es-platform -d instanceName


Setting Up Domains

The instructions in this document deal with two types of domains:

  • Sun Management Center administrative domain -- A collection of one or more host systems. For example, an administrative domain can include all the servers and workstations in a computer lab.
  • Hardware domain -- A subset of components in a Sun Fire 6800/4810/4800/3800 platform. For example, a platform with multiple CPU boards and multiple I/O boards can be divided into multiple domains, each with one or more CPU boards and one or more network connections. Each hardware domain runs a separate copy of the Solaris Operating System.

procedure icon  To Create a Hardware Domain

The Sun Fire 6800/4810/4800/3800 systems comes from the factory configured with one hardware domain, domain A. The system administrator has the option of creating additional hardware domains. A Sun Fire 6800 system can have up to four hardware domains. Sun Fire 4810, 4800, and 3800 systems can have up to two hardware domains.

single-step bulletTo create additional hardware domains on Sun Fire 6800/4810/4800/3800 systems, refer to the Sun Fire 6800/4810/4800/3800 Systems Platform Administration Manual.


procedure icon  To Create Administrative Domains

single-step bulletTo create and populate an administrative domain, refer to the Sun Management Center 3.5 User's Guide.