Sun Management Center 3.5 Performance Reporting Manager User's Guide

Appendix B Installing Using the Command Line

This appendix contains procedures for installing, setting up, and removing the Performance Reporting Manager software using the command line. Command-line installation is an alternative to using the installation wizard.

For information about using the installation wizard, see Chapter 2, Performance Reporting Manager Installation and Setup.

This appendix discusses the following topics:

Installing the Performance Reporting Manager Software

Installation of Performance Reporting Manager using the command line follows the standard Sun Management Center 3.5 add-on software installation procedures. For more information about installation of add-on software using the command line, see Sun Management Center 3.5 Installation and Configuration Guide.

Performance Reporting Manager must be installed on the following layers of Sun Management Center 3.5:

Console layer
Server layer
Agent layer, on all hosts for which you want to generate reports

The interactive es-inst installation script installs the correct Performance Reporting Manager software packages on the console, server, and agent layers. For all layers, the packages, module configuration files, and libraries are installed in standard Sun Management Center 3.5 locations.

To Install Performance Reporting Manager During Sun Management Center 3.5 Installation

For information and detailed steps using the command line, see Sun Management Center 3.5 Installation and Configuration Guide.

To Install Performance Reporting Manager Individually

As superuser (su -), run the installation script by typing:
# /opt/SUNWsymon/sbin/es-inst
where /opt is the directory in which Sun Management Center 3.5 is installed. Substitute the name of the actual directory if it is different on your system.

Provide the source directory of the Performance Reporting Manager files when prompted.
Please enter the source directory:
- If installing from the software CD-ROM, type:
  /cdrom/sunmanagementcenter_3_5/image
- If installing from a directory to which the software has been copied, type:
  disk1/image
  when disk1 is the name of the location where the software was copied.

To install the Performance Reporting Manager, answer “Yes” when prompted.

The es-inst script installs Performance Reporting Manager.

The es-inst script then automatically displays setup prompt.

Determine whether you want to set up Performance Reporting Manager now or at a later time.
- To set up the software at a later time, answer n for “No”. When you are ready to run the setup process, see To Set Up Performance Reporting Manager Individually.
- To set up the software now, answer y for “Yes”. The Sun Management Center 3.5 software is not setup again.

Setting Up Performance Reporting Manager

After installation is complete, you must run the Performance Reporting Manager setup script to configure the server and agent layers.

To Set Up Performance Reporting Manager Individually

Note –

This procedure assumes that you chose not to set up Performance Reporting Manager at the end of the installation process.

Run the Sun Management Center 3.5 setup script as superuser (su -). Choose one of the following options:
- To run setup on all components that are not yet set up, type:
  # /opt/SUNWsymon/sbin/es-setup
- To run setup on the Performance Reporting Manager add-on software only, type:
  # /opt/SUNWsymon/sbin/es-setup -p PRM
where /opt is the directory in which Sun Management Center 3.5 is installed. Substitute the name of the actual directory if it is different on your system.

When asked, choose the configuration size. Provide three data file locations.

During the server setup, you are given three different configuration choices based on the number of agent machines and data properties you will monitor. You are prompted three times for data file locations. While you can enter the same directory three times, try to use three different directories located on three different filesystems. This separation reduces disk I/O contention and results in better product performance.

The space required depends upon the size of the configuration you choose during setup. The data file locations require disk space as listed in the following table.

Table B–1 Data Directory Sizes For Server Layer


Configuration Size	First Directory Size	Second Directory Size	Third Directory Size
Small	2048 MB	1536 MB	1536 MB
Medium	5120 MB	4096 MB	3072 MB
Large	8192 MB	7168 MB	7168 MB

If you need to run the Performance Reporting Manager setup script again at any time, use this procedure to start the script.

Removing the Performance Reporting Manager Software

The es-uninst removal script removes the Performance Reporting Manager add-on software. This script removes the Performance Reporting Manager packages, and all the data and configuration changes made during setup.

To Remove Performance Reporting Manager Using `es-uninst`

As superuser (su -), type:
# /opt/SUNWsymon/sbin/es-uninst
where /opt is the directory in which Sun Management Center 3.5 is installed. Substitute the name of the actual directory if it is different on your system.

Select Performance Reporting Manager from the list of add-on software, and click Next.

Indicate whether to preserve the data files, and click Next.

The Performance Reporting Manager packages and configuration files are removed. If you chose not to preserve the data files, they are removed as well.