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 Center software from the CLI. For more details, refer to the Sun Management Center Software and Installation Configuration Guide. If you prefer to installing using the installation GUI, see Chapter 2.


Installing and Setting Up the Software Using the CLI

First ensure that the latest update for Sun Management Center 3.5 base software is installed on your systems. Refer to the Sun Management Center Installation and Configuration Guide for instructions about installing this software.

Also ensure that any required patches are installed on your systems.

Refer to the Sun Management Center 3.5 Version 6 Release Notes for Sun Fire Entry-Level Midrange Systems for details about software requirements for the server, domain, and console layers.


procedure icon  To Install the Add-On Software Using the CLI

1. As superuser, change the directory to the path/sbin directory, where path/sbin is the location where the base Sun Management Center software has been installed.

2. To install the add-on software, run the es-inst command in the sbin directory.

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

3. Type the source directory of the image of the Sun Management Center 3.5 Version 6 add-on software.

Refer to the Sun Management Center Installation and Configuration Guide for more 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 onlythe Sun Fire supplement software, enter n(for no) when you are prompted to begin the setup process. Typing y(for yes) might 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.



4. Install the add-on software on the server and on any Sun Fire entry-level midrange agent systems that you will monitor.

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 applicable for installation:
Sun Fire Entry-Level Midrange System
 
Select the products you want to install: 
Sun Fire Entry-Level Midrange System (y|n|q) y
---------------------------------------------------------------------------

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

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


--------------------------------------------------------------------------
The following Add-On Products will be installed:
Sun Fire Entry-Level Midrange System
 
Do you want to proceed? [y|n|q] y
---------------------------------------------------------------------------

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


procedure icon  To Set Up the Add-On Software

single-step bulletAs superuser, type:


# ./es-setup -p lw8

When you are setting the software up on the server, the system displays a message similar to this one:


----------------------------------------------------------------
This script will help you to setup Sun (TM) Management Center 3.5.
----------------------------------------------------------------
  
Setting up Addon[s]...
----------------------------------------------------------------
Starting Sun Management Center Sun Fire Entry-Level Midrange System Setup
						
----------------------------------------------------------------
 
Do you want to start Sun Management Center agent and server components now (y|n|				
q) y  
 
Java server started successfully.
Grouping service started successfully.
Agent started successfully.
Topology service started successfully.
Trap-handler service started successfully.
Configuration service started successfully.
Event-handler service started successfully.
Metadata Service started successfully.
 
 
Web server started successfully.
 
Setup of Sun Management Center is complete.
Setup logfile is : /var/opt/SUNWsymon/install/setup_ssdn2363.050427170031.14144

When you are setting the software up on an agent, the system displays a message similar to this one:


----------------------------------------------------------------------------
This script will help you to setup Sun (TM) Management Center 3.5 Update 1.
----------------------------------------------------------------------------
Sep 10 09:49:04 qalw8-2 platform[12429]: [ID 305329 daemon.alert] syslog   Sep 10 09:49:04 platform      {received software termination signal}
Sep 10 09:49:04 qalw8-2 platform[12429]: [ID 770054 daemon.alert] syslog   Sep 10 09:49:04 platform      *** terminating execution ***
Stopping platform component
Stopping agent component
Sep 10 09:49:05 qalw8-2 agent[11616]: [ID 313994 daemon.alert] syslog Sep 10 09:49:05 agent         {received software termination signal}
Sep 10 09:49:05 qalw8-2 agent[11616]: [ID 638892 daemon.alert] syslog Sep 10 09:49:05 agent         *** terminating execution ***
 
 
 
Setting up Addon[s]...
----------------------------------------------------------
Starting Sun Management Center Sun Fire Entry-Level Midrange System Setup
----------------------------------------------------------
---> Platform Found: Sun Fire E2900
---> Sun Fire Entry-Level Midrange System add-on Agent package found! <--- 
Entry for Config-Readerlw8 successfully added
 
Do you want to start Sun Management Center agent now (y|n|q) y
Starting Sun Management Center Agent...
 
Agent started successfully.
 
Setup of Sun Management Center is complete.
Setup logfile is : /var/opt/SUNWsymon/install/setup_qalw8-2.040910094859.18052
# 


Uninstalling the Software Using the CLI

You can uninstall:


procedure icon  To Uninstall All Sun Management Center Software

1. As superuser, type:


# ./es-uninst

The system displays this 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 Entry-Level Midrange System                             None
 
Do you want to uninstall Production Environment? [y|n|q]

2. Type y to uninstall the 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:

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

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. Do one of the following:

The system displays the following message:


Proceed with uninstall? [y|n|q]

5. Do one of the following:

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 Add-On Software for Sun Fire Entry-Level Midrange Systems

1. As superuser, type:


# ./es-uninst

The system displays this 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 Entry-Level Midrange System                             None
 
Do you want to uninstall Production Environment? [y|n|q]

2. Type n not to uninstall the Production Environment.

The system displays this message


Do you want to uninstall Sun Fire Entry-Level Midrange System? [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:

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

The system displays the following message:


Proceed with uninstall? [y|n|q]

5. Do one of the following:

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 and Stopping Sun Management Center Software Using the CLI


procedure icon  To Start All Sun Management Center Components

The es-start command requires different command arguments, depending on which component you are starting. Refer to the Sun Management Center Installation and Configuration Guide for a list of the options for es-start. The -h option for es-start also lists all the options. The following procedure describes one common es-start option.

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

2. As superuser, type the following to start all Sun Management Center components, except the console:


# ./es-start -A


procedure icon  To Stop All Sun Management Center Components

The es-stop command requires different command arguments, depending on which component you are stopping. Refer to the Sun Management Center Installation and Configuration Guide for a list of the options for es-stop. The -h option for es-stop also lists all the options. The following procedure describes one common es-stop option.

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

2. As superuser, type the following to stop all Sun Management Center components, except the console:


# ./es-stop -A