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:
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.
For information and detailed steps using the command line, see the Sun Management Center 3.6 Installation and Configuration Guide.
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.
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.
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.
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”.
After installation is complete, you must run the Performance Reporting Manager setup script to configure the server and agent layers.
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 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.
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 |
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.
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.
When the script prompts you to uninstall Performance Reporting Manager, type y and press Enter.
You are prompted to change the setting.
Type n and press Enter.
You are prompted to preserve the data files.
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.