A P P E N D I X  A

Using the CLI to Install, Set up, Uninstall, Start, and Stop Sun Management Center Software

This appendix describes how to install, set up, uninstall, start, and stop Sun Management Software from the command line interface (CLI). For more details, refer to the Sun Management Center 3.5 Software and Installation Configuration Guide.


Installing the Software

First ensure that Sun Management Center 3.5 software is installed on your system. Refer to the Sun Management Center 3.5 Installation and Configuration Guide for instructions about installing this software. A soft copy of the installation guide is on the Sun Management Center 3.5 CD, disk 3 of 3.

Also ensure that any required patches are installed on your system. Refer to the Sun Management Center 3.5 Release Notes for any required patches for this release.


procedure icon  To Install the Supplement Software Using the CLI

The supplement software and document are on three CDs, which include the full Sun Management Center 3.5 software package. The CDs are labelled:

1. Install the Sun Management Center 3.5 software package on the Sun Fire 6800/4810/4800/3800 domains.

a. To install only the Sun Fire supplement software, run the es-inst command in the sbin directory, in either the update CD or the directory where the Sun Management Center 3.5 software package was installed.

The es-inst script prompts you for a source directory.

b. Enter the source directory.

If you run the es-inst command from the installation directory and the CD is mounted on /cdrom/cdrom0, specify /cdrom/cdrom0/image as the source directory.

Refer to the Sun Management Center 3.5 Installation and Configuration Guide for information about the es-inst command and its options.



caution icon

Caution - If the general Sun Management Center 3.5 software package is already installed, and you are installing only the Sun Fire supplement software, enter n (for no) when you are prompted to begin the setup process. Entering y (for yes) may cause the loss of any customized setup information, such as security keys.





Note - If you are installing the full Sun Management Center 3.5 software package, you have the option of running the setup script at the end of the installation procedure. If you choose not to run the setup script at that time, you can run it later. The setup script (es-setup) is in path/sbin, where path is the directory where the Sun Management Center software is installed. This step sets up all Sun Management Center agents, including the platform agent.



Install the Sun Management Center 3.5 software package on any systems (agent machines) that you will use for platform administration on the Sun Fire 6800/4810/4800/3800 systems. Read the Caution and Note in Step 1 above.

The system displays the following message:

--------------------------------------------------------------------------
Sun Management Center Product Selection
--------------------------------------------------------------------------
--------------------------------------------------------------------------
The following Add-On Products are available for your selection:
--------------------------------------------------------------------------
Sun Fire domain Administration
Dynamic Reconfiguration for Sun Fire 3800/4800/4810/6800/15000 platforms
Sun Fire Platform Administration
 
Do you want to install the product: Sun Fire Domain Administration? [y|n|q]
Do you want to install the product: Dynamic Reconfiguration for Sun Fire 3800/4800/4810/6800/1500 platforms? [y|n|q]
Do you want to install the product: Sun Fire Platform Administration? [y|n|q]
---------------------------------------------------------------------------

2. Type y for those products you want to install.

If you type y for all the add-ons, the system displays this message:

--------------------------------------------------------------------------
The following Add-On Products will be installed:
Sun Fire domain Administration
Dynamic Reconfiguration for Sun Fire 3800/4800/4810/6800/15000 platforms
Sun Fire Platform Administration
 
Do you want to proceed? [y|n|q]
---------------------------------------------------------------------------

3. Type y to continue installing the add-on products.


Setting Up the Sun Fire 6800/4810/4800/3800 Platform Administration Module Using the CLI

The setup has three parts:

Setting Up SNMP on the System Controller

Setting up the Simple Network Management Protocol (SNMP) on the system controller involves configuring 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. Access the system controller by using the telnet(1) command as shown in CODE EXAMPLE A-1.

CODE EXAMPLE A-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 A-1.

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

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

CODE EXAMPLE A-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]: server_name
Public Community String [string]: your_string1
Private Community String [string]: your_string2

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

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. Access the system controller by typing the telnet command as shown in CODE EXAMPLE A-3.

CODE EXAMPLE A-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 A-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 A-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 environment, 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 A-3 shows a connection to domain A.

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

CODE EXAMPLE A-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.

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.

Setting Up the Agent and Server Layers

This section describes how to set up the agent and server layers.


procedure icon  To Set Up the Sun Fire 6800/4810/4800/3800 Platform Administration Module on an Agent Machine

If the agent machine has both server and agent layers, this procedure automatically sets up both layers.

1. Become superuser by using the su command.

2. Go to the PUn_path/addons/SunFirePltAdmin/sbin directory, where n is the number of the Platform Update, and PUn_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. Run the es-setup.sh script:

To set up this module for the default platform agent instance, type:

# ./es-setup.sh

The script asks for this information:

  • The IP Address of the Sun Fire 6800/4810/4800/3800 system controller.
  • The 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.
  • The port number of the Sun Management Center agents on all the domains.


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



The Sun Management Center 3.0 software ships with one platform agent named "platform."

When the module has been set up, you can start the appropriate agent. For more on how to start, see Starting Sun Management Center Components.


procedure icon  To Set Up the Sun Fire 6800/4810/4800/3800 Platform Administration Module Server Layer Only on the Server

This procedure sets up only the server layer. To set up the server, agent, and console layers on a server, see To Set Up the Sun Fire 6800/4810/4800/3800 Platform Administration Module on an Agent Machine.



Note - If you chose to set up only the server layer (without a console or agent layer), user groups are not automatically added to the /etc/group file unless you use the -S option, as shown in this procedure. For a list of user groups, see TABLE A-1.



1. Become superuser by using the su command.

2. Go to the PUn_path/addons/SunFirePltAdmin/sbin directory, where n is the number of the Platform Update, and PUn_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. Run the es-setup.sh script with the -S option:

# ./es-setup.sh -S

When the module has been set up, you can start the appropriate agent. The Sun Management Center 3.0 software ships with one platform agent named "platform. For more on how to start, see Starting Sun Management Center Components.


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.


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.

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.


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



When the module has been set up, you can start the appropriate agent. For more on how to start, see Starting Sun Management Center Components.


procedure icon  To Assign Users to Administrator and Operator Groups

If your user name is listed in the esusers file, you can log onto the Sun Fire 6800/4810/4800/3800 system, where you have read-only access for domain administration agents. In order to read and/or write platform or domain information under the platform agent, your 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 A-1 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.

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


Setting Up the Software Using the CLI


procedure icon  To Set Up the Domain Administration Module on the Sun Management Center Server

single-step bulletAs superuser, type:

# ./es-setup -p SunFireDomAdmin

The system displays:

--------------------------------------------------------------
This script will help you to setup Sun (TM) Management Center 3.5.
--------------------------------------------------------------
 
Setting up Addon[s]


procedure icon  To Set Up the Platform Administration Module on the Platform

1. As superuser, type:

# ./es-setup -p SunFirePltAdmin

The system displays:

---------------------------------------------------------------------------
This script will help you to setup Sun (TM) Management Center 3.5.
---------------------------------------------------------------------------
 
Setting up Addon[s]
 
For setting up Sun Fire (6800/4810/4800/3800) platform administration module
you need to provide SC IP address, community strings, port numbers for domain agent etc.
 
Do you want to setup Sun Fire (6800/4810/4800/3800) platform administration module [y|n|q]

2. Type y to set up the platform administration module; or type n to not set up the module now.

One of the following occurs:

  • If you type n, the setup script ends.
  • If you type y, the system displays:
  • Enter the IP address of System Controller
    

3. Type the IP address of the System Controller (for example, 10.8.28.209).

The system displays:

Enter the read community for platform

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

The system displays:

Enter the write community for platform

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

The system displays:

Enter the write community for domainX

where X is the domain letter (A-R).

6. Type the write community for each domain (for example, use A-private for domainA).

When you have finished entering the write community for each domain, the system displays (in our example):

Please wait, Pinging the host 10.8.23.209.
Host 10.8.38.209 is networked.
Please wait, getting domain info from system controller
Enter the Sun Management Center agent Port for domainX

where X is the domain letter (A-R).

7. Type the port number for each domain (for example, use 161 for each domain).

When you have finished entering the port number for each domain, the system displays:

Updating the configuration, Please Wait...
Done.
....
....
....
Do you want to start Sun Management Center agent and server components now? [y|n|q]


Uninstalling Software Using the CLI

You can uninstall:


procedure icon  To Uninstall All Sun Management Center Software Using the CLI

1. As superuser, type:

# ./es-uninst

The system displays the following message:

This script will help you to uninstall the Sun Management Center software.
 
Following Sun Management Center Products are installed:
---------------------------------------------------------------------------
 
PRODUCT                                              DEPENDENT PRODUCTS
---------------------------------------------------------------------------
 
Production Environment                               All Addons
Sun Fire Domain Administration                       None
Dynamic Reconfiguration for Sun Fire 15K-3800 pl     None
Sun Fire Platform Administration                     None
 
Do you want to uninstall Production Environment? [y|n|q]

2. Type y to uninstall Production Environment, which uninstalls all Sun Management Center software.

The system displays this message:

This will uninstall ALL Sun Management Center Products. !!!
 
Do you want to change selection? [y|n|q]

3. Do one of the following

a. Type y to change your selection.

The system displays your selection; go to the beginning of Step 2.

b. Type n to not change your selection.

The system displays the following message:

Do you want to preserve database? [y|n|q]



Note - If you answer y for yes, the system preserves any data in the database, including open and closed alarms, loaded modules and their configurations, discoveries, managed objects, and rule thresholds.



4. Type y to keep any existing topology and event data; or type n to discard the data.

The system displays the following message:

Proceed with uninstall? [y|n|q]

5. Type y to proceed with the uninstall; or type n to not proceed with the uninstall.

If you type y to proceed, the system displays the list of packages to be uninstalled, the packages as they are uninstalled, the status of the uninstallation, and the location of the log file.


procedure icon  To Uninstall Individual Add-on Modules

1. As superuser, type:

# ./es-uninst

The system displays the following message:

This script will help you to uninstall the Sun Management Center software.
 
Following Sun Management Center Products are installed:
---------------------------------------------------------------------------
 
PRODUCT                                              DEPENDENT PRODUCTS
---------------------------------------------------------------------------
 
Production Environment                               All Addons
Sun Fire Domain Administration                       None
Dynamic Reconfiguration for Sun Fire 15K-3800 pl     None
Sun Fire Platform Administration                     None
 
Do you want to uninstall Production Environment? [y|n|q]

2. Type n to not uninstall the Production Environment; in other words, type n to uninstall individual modules.

The system displays the following message

Do you want to uninstall Sun Fire Domain Administration? [y|n|q]
Do you want to uninstall Dynamic Reconfiguration for Sun Fire 15K-3800 platforms? [y|n|q]
Do you want to uninstall Sun Fire Platform Administration? [y|n|q]

3. Type y beside each module you do want to uninstall and n beside each module you do not want to uninstall.

The system displays the modules that will be uninstalled and the following message:

Do you want to change selection? [y|n|q]

4. Do one of the following:

a. Type y to change the selections.

The system displays your selections; go to the beginning of Step 3.

b. Type n to not change your selections.

The system displays the following message:

Proceed with uninstall? [y|n|q]

5. Type y to proceed with the uninstall; or type n to not proceed with the uninstall.

If you type y to proceed, the system displays the list of packages to be uninstalled, the packages as they are uninstalled, the status of the uninstallation, and the location of the log file.


Starting Sun Management Center Components

The es-start script has three options:

  • The -A option starts all Sun Management Center components, except the console.
  • The -l option starts the default platform agent.
  • The -y option starts only the specified agent.

procedure icon  To Start the Default Platform Agent

1. Become superuser by using the su command.

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

3. Start the default platform agent by typing:

# ./es-start -l


procedure icon  To Start a Platform Agent Instance

1. Become superuser by using the su command.

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

3. Start a specific platform agent instance by typing:

# ./es-start -y instanceName

For example, if P1 is the name of the platform agent instance, type:

# ./es-start -y P1


procedure icon  To Start All Sun Management Center Components

1. Become superuser by using the su command.

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

3. Start all Sun Management Center components, except the console, by typing:

# ./es-start -A


Stopping Sun Management Center Components

The es-stop script has three options:

  • The -A option stops all Sun Management Center components, except the console.
  • The -l option stops the default platform agent.
  • The -y option stops only the specified agent.

procedure icon  To Stop the Default Platform Agent

1. Become superuser by using the su command.

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

3. Stop the default platform agent by typing:

# ./es-stop -l


procedure icon  To Stop a Platform Agent Instance

1. Become superuser by using the su command.

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

3. Stop a specific platform agent instance by typing:

# ./es-stop -y instanceName

For example, if P1 is the name of the platform agent instance, type:

# ./es-stop -y P1


procedure icon  To Stop All Sun Management Center Components

1. Become superuser by using the su command.

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

3. Stop all Sun Management Center components, except the console, by typing:

# ./es-stop -A