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

• Setting Up Performance Reporting Manager

• Removing the Performance Reporting Manager Software

Installing the Performance Reporting Manager Software

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

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

• Console layer

• Server layer

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

The interactive es-inst (enterprise system monitoring) 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 locations.

To Install Performance Reporting Manager During Sun Management Center Installation

Step

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

To Install Performance Reporting Manager Individually

Steps

1. As superuser (su -), run the installation script by typing:

   # /opt/SUNWsymon/sbin/es-inst

   where /opt is the directory in which Sun Management Center is installed. Substitute the name of the actual directory if it is different on your system.

2. 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/cdrom0/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.

3. 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 a setup prompt.

4. 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”.

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

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

Steps

1. Run the Sun Management Center 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 is installed. Substitute the name of the actual directory if it is different on your system.

2. 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 use the same directory three times, try to use three different directories located on three different file systems. 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.

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

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

Steps

1. As superuser (su -), type:

   # /opt/SUNWsymon/sbin/es-uninst

   where /opt is the directory in which Sun Management Center is installed. Substitute the name of the actual directory if it is different on your system.

   The script displays the Sun Management Center products installed and prompts you to uninstall each of them.

2. When the script prompts you to uninstall Performance Reporting Manager, type y and press Enter.

   You are prompted to change the setting.

3. Type n and press Enter.

   You are prompted to preserve the data files.

4. Enter your answer and press Enter.

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