Sun Management Center 3.5 Update 1 Supplement for Halcyon PrimeAlert Agent for Linux

Chapter 1 Installing the Linux Agent

Halcyon PrimeAlert Agent for Linux (Linux Agent, for short) enables Sun Management Center 3.5 Update 1 to monitor hosts running the Linux operating system.

This chapter covers these topics:

Installation Requirements and Terms

To use the Linux Agent, you must have the server and console layers of the Sun Management Center 3.5 Update 1 core product already installed.

The following table summarizes the platform support for the various components.

Table 1–1 Supported Platforms for the Linux Agent


Operating System	Base Product	Agent Layer	Server Layer	Console Layer
Solaris^TM 8 (SPARC^TM) and later	Sun Management Center 3.5 Update 1		X
Solaris 2.6 (SPARC) and later	Sun Management Center 3.5 Update 1			X
Solaris 8 (x86) and later	Sun Management Center 3.5 Update 1			X
Windows 98, Windows NT 4.0 SP 4 or later, Windows 2000 Professional, and Windows XP	Sun Management Center 3.5 Update 1			X
Red Hat Linux Enterprise 2.1 - 3.0 (32–bit and 64–bit)	PrimeAlert Agent	X
Sun Java^TM Desktop System 1.0	PrimeAlert Agent	X
SUSE Linux Enterprise 8.0 (32–bit and 64–bit)	PrimeAlert Agent	X
SUSE Professional 9 (32–bit and 64–bit)	PrimeAlert Agent	X

In this supplement, the following terms are used:

Server Host – Host where the Sun Management Center server is installed and running. This host must be a Solaris host and contain the package SUNWessrv.
Agent Host – Host where the PrimeAlert Agent for Linux is installed and running.
Console Host – Host where the Sun Management Center console is installed and running. If this host is a Solaris host, it contains the package SUNWescon. The host can also be a host running Windows.

Installation Procedures

To install the Linux Agent, you need to do the following tasks (also shown in the figure):

Extract the distribution file
Install the server layer packages (Solaris)
Install the console layer packages (Solaris or Windows)
Install the agent layer packages (Linux)

Solaris: To Extract the Distribution File

The PrimeAlert Agent for Linux distribution file, HALLinuxAgent_5.2.x.tar.gz or HALLinuxAgent_5.2.x.tar.Z must be extracted before any packages can be installed. For this example, assume that the distribution file has been copied to the /tmp/install as the installation source directory, source-dir, and is extracted there.

Log on as a super user.
% su -

Change to the directory where you want to extract the files, for example:
# cd /tmp/install

Uncompress the file.

# uncompress HALLinuxAgent_5.2.x.tar.Z

# gzip -d HALLinuxAgent_5.2.x.tar.gz

Unarchive the file.
# tar xvf HALLinuxAgent_5.2.x.tar
In this example, the files are unarchived in the directory /tmp/install/HALLinuxAgent_5.2.x. This directory represents the installation source directory, source-dir, in the following procedures.

Solaris: To Install the Server Layer Packages

Do this procedure on the Sun Management Center server host only. If the Sun Management Center server is installed on the same machine as the Sun Management Center console, the installer prompts you to install both the Linux console and server packages. Note that server layer packages should be installed and upgraded before agent or console layer packages are installed and upgraded.

Log into the Sun Management Center server host as a super user.
% su -

Change to the directory where you extracted the distribution files.
# cd source-dir

Run the script HALLinuxAgent-install.sh.
# ./HALLinuxAgent-install.sh -s
The following packages are installed or upgraded by the installation script:
- HALsislag, PrimeAlert Agent for Linux (server component)
- HALmmsast, PrimeAlert AgentHealth (server component)
- HALmmslsa, PrimeAlert SystemMonitor (server component)
- HALmmsmib, PrimeAlert MIB-II System (server component)

Solaris: To Install the Console Layer Packages

Do this procedure for any console host from which you want to monitor the Linux Agent. If the Sun Management Center server is installed on the same machine as the Sun Management Center console, the installer prompts you to install both the Linux console and server packages. In this case, you can skip Steps 1 – 3 of the following procedure.

Log into a Sun Management Center console host as a super user.
% su -

If the console has a different host from the server, copy the distribution file and extract it in the appropriate directory.

See Solaris: To Extract the Distribution File.

Run the script HALLinuxAgent-install.sh.
# ./HALLinuxAgent-install.sh -c
If the installer detects that the Sun Management Center server is installed, it prompts you to install the Linux Agent server layer packages.

The following packages are installed or upgraded by the installation script:
- HALmmcast, PrimeAlert AgentHealth (console component)
- HALmmclsa, PrimeAlert SystemMonitor for Linux (console component)
- HALmmcmib, PrimeAlert MIB-II System (console component)

Restart the local Sun Management Center console by typing:
# /opt/SUNWsymon/bin/es-start -c

Windows: To Install the Console Layer Packages

Do this procedure for any Windows console host that is being used to monitor the Linux Agent.

If present, remove the currently installed console package for the PrimeAlert Agent for Linux. See Windows: To Remove the Console Layer Packages.

Copy the Windows InstallShield installer to a convenient location (path) on the Windows console host. From the Solaris host where you unarchived the tar file, the Windows InstallShield installer has the path source-dir/packages/win32/HALLinuxAgent_5.2.x.exe.

For example, if you use FTP on the Windows console host to retrieve the file from the Solaris host, the commands might look like this:

C:\Documents and Settings\sunmc>ftp tahoe
Connected to tahoe.mycorp.com.
220 tahoe FTP server ready.
User (tahoe.mycorp.com:(none)): jching
331 Password required for jching.
Password:
230 User jching logged in.
ftp> cd source-dir/HALLinuxAgent_5.2.x/packages/win32
250 CWD command successful.
ftp> bin
200 Type set to I.
ftp> ls
200 PORT command successful.
150 Opening ASCII mode data connection for file list.
HALLinuxAgent_5.2.x.exe
226 Transfer complete.
ftp: 25 bytes received in 0.00Seconds 25000.00Kbytes/sec.
ftp> get HALLinuxAgent_5.2.x.exe
200 PORT command successful.
150 Opening BINARY mode data connection for
HALLinuxAgent_5.2.x.exe 
(1088645 bytes).
226 Transfer complete.

Run the InstallShield package.

For example, from the command line, type:
C:\Documents and Settings\path\HALLinuxAgent_5.2.x.exe
Or choose Start > Run path\HALLinuxAgent_5.2.x.exe.

Follow the on-screen instructions.

Besides installing a number of program files, the installation program puts a number of shortcuts in the Start Menu's Programs folder, in the subfolder Halcyon. These shortcuts provide easy and fast access to help files for the three modules included with the Linux Agent.

Restart the local Sun Management Center console by double-clicking the Sun Management Center shortcut icon or by choosing Start > Programs > Sun Management Center > Console.

Linux: To Install the Agent Layer Packages

Do this procedure on any Linux host that is being upgraded to the latest version of the PrimeAlert Agent for Linux or that receives the Linux Agent files.

Log into the Linux host as a super user.
% su -

Copy the distribution file and extract it in the appropriate directory on the Linux host.

See Solaris: To Extract the Distribution File.

Run the script HALLinuxAgent-install.sh.

# cd  source-dir
# ./HALLinuxAgent-install.sh -a

Type y and press Return.

A message appears explaining the information that the script requests.

Agent Setup
===========
.
.
.
The following parameters are needed in order to
set up the agent:

- PrimeAlert Agent Hostname/IP: is the hostname or IP address of
this host which correspond to the NIC and IP address through which
communication with the SunMC Server occurs. The Sun MC server must be able
to resolve the IP from hostname and vice versa. Failure to properly specify
this entry may result in unauthenticated communication between the
server and the agent. The default value is the output of the command
'hostname'.

- PrimeAlert Agent Port: This is the port used by the SunMC server
to communicate with the PrimeAlert Agent. The default value is 161.

- Trap Server Host: This is the name of the host that runs the SunMC
  Trap Server component.

- Trap Server Port: This is the port used by the PrimeAlert Agent to
  communicate with the Trap Server. The default value is 162.

- Event Server Host: This is the name of the host that runs the
SunMC Event Server component. The default value is the hostname you
provided for the Trap Server.

- Event Server Port: This is the port used by the PrimeAlert Agent
to communicate with the Event Server. The default value is 163.

- Seed: This is the seed you used when you installed the SunMC
server components. In order for the PrimeAlert Agent to function
correctly, you have to specify the same seed.

.
.
.

Type y to continue with the script and press Return.

You are prompted for the agent hostname/IP.
Configuring the PrimeAlert Agent for SunMC ... Please enter the following information: Agent Hostname/IP [caspian]:
Note –
If the Linux Agent has been installed before, the software uses the previous settings and skips the setup steps. If you want to change the configuration, you can reconfigure the Linux Agent by running the install script with the -setupAgent option from the installation source directory or by editing the domain.config.x file. For more information, see Reconfiguring the Linux Agent.

Press Return to accept the default or type a different agent hostname/IP and press Return.

You are prompted for the agent port.

Press Return to accept the default port, if free, or type a different agent port and press Return.

You are prompted for the trap server host. The trap server host is the same as the Sun Management Center server host.

Type the trap server host name and press Return.

You are prompted for the trap server port.

Note –
To avoid lost communication and to bind the Linux Agent, make sure you type the proper values for the trap server port and event server port. Unless the trap server port and event server port have been changed on the Sun Management Center server, you should accept the default values for the trap server port and event server port.

Press Return to accept the default port, if free, or type a different trap server port and press Return.

You are prompted for the event server host. The event server host is the same as the Sun Management Center server host.

Press Return to accept the default or type a different event server host name and press Return.

You are prompted for the event server port.

Press Return to accept the default port, if free, or type a different event server port and press Return.

You are prompted for the seed.

Type the seed and press Return. This must match the seed you used for your Sun Management Center server layer installation.

You are prompted to confirm the seed.

Type the seed and press Return.

Progress and confirmation messages appear.

The following packages are installed or upgraded by the installation script:
- HALpialag – The PrimeAlert Agent for Linux monitors the health and statistics of the system
- HALpmalsa – PrimeAlert SystemMonitor provides information about the operating system
- HALpmaast – PrimeAlert AgentHealth monitors statistics about the operating system
- HALpmamib – PrimeAlert MIB-II System provides information about the Management Information Base (MIB)
- HALpmakit – PrimeAlert Agent Toolkit
The installation of the Linux Agent is complete. No host reboot is required.

If you have upgraded the agent or any of its bundled modules, the agent must be restarted. For an initial install, the agent must be started.

Start the Linux Agent by typing:
# /opt/PrimeAlert/bin/pa start agent

Installation Log Files

For information on possible installation problems, see Installation Troubleshooting.

To view the installation log on a Solaris host, see:

/var/opt/SUNWsymon/install/HALLinuxAgent-install_YYYYMMDD-HHMMSS.log

To view the installation log on a Linux host, see:

/var/opt/PrimeAlert/install/HALLinuxAgent-install_YYYYMMDD-HHMMSS.log

Uninstallation Procedures

Note –

If you uninstall the Sun Management Center core product on the server host by using the es-uninst with the -X option, the installation script uninstalls all the installed packages for the Linux Agent. You do not need to uninstall the Linux Agent packages manually.

Solaris: To Remove Server Layer Packages

The procedure described in this section should be performed on the Sun Management Center server layer host only.

Log into the Sun Management Center server host as a super user.
% su -

Run the following commands:
# cd /var/opt/SUNWsymon/uninstall # ./HALUninstall.sh -module LinuxAgent server
All or some of the following packages are removed:
- HALsislag
- HALmmsast
- HALmmslsa
- HALmmsmib

Solaris: To Remove the Console Layer Packages

The procedure described in this section should be performed on any console host where packages for the PrimeAlert Agent for Linux are to be removed.

Log into a Sun Management Center console host as a super user.
% su -

Change to the following directory.
# cd /var/opt/SUNWsymon/uninstall

Run the uninstall script:
# ./HALUninstall.sh -module LinuxAgent console
All or some of the following packages are removed.
- HALmmcast
- HALmmclsa
- HALmmcmib

You do not need to restart the local Sun Management Center console after package uninstallation.

Windows: To Remove the Console Layer Packages

Do this procedure on any Windows host where the Linux Agent is to be removed.

Go to the Windows Start menu and select Start > Settings > Control Panel.

A new Control Panel window appears.

Double-click the Add/Remove Programs icon in the Control Panel window.

A new window labeled Add/Remove Programs (Properties) appears.

Select Halcyon PrimeAlert Agent for Linux.

Start the uninstall process.
- Windows NT 4.0 – Click the Add/Remove button.
- Windows 2000 – Click the Change/Remove button.
An UnInstallShield session is launched.

Follow the on-screen instructions.

Linux: To Remove Agent Layer Packages

Do this procedure on any Linux host where the Linux Agent is no longer required.

Log into the Linux host as a super user.
% su -

Stop the Linux Agent process on the Linux host by typing the following commands:
# cd /opt/PrimeAlert/bin # ./pa stop agent

Change to the uninstall directory.
# cd /var/opt/PrimeAlert/uninstall

Run the following command.
# ./HALUninstall.sh -module LinuxAgent agent
The following packages are removed by this process:
- HALpialag
- HALpmaast
- HALpmalsa
- HALpmamib

Uninstallation Log Files

To view the uninstallation log on the Solaris host, see:

/var/opt/SUNWsymon/uninstall/log/uninstall.log.YYYYMMDD-HHMMSS

To view the uninstallation log on the Linux host, see:

/var/opt/PrimeAlert/uninstall/log/uninstall.log.YYYYMMDD-HHMMSS

Linux Agent Packages

The following table lists the packages in the Linux Agent.

Table 1–2 Linux Agent Packages


Package	Description
`HALmmcast`	PrimeAlert AgentHealth (console component) system
`HALmmclsa`	PrimeAlert SystemMonitor for Linux (console component) system
`HALmmcmib`	PrimeAlert MIB-II System (console component) system
`HALmmsast`	PrimeAlert AgentHealth (server component) system
`HALmmslsa`	PrimeAlert SystemMonitor for Linux (server component) system
`HALmmsmib`	PrimeAlert MIB-II System (server component) system
`HALsislag`	PrimeAlert Agent for Linux (server component)
`HALpialag`	PrimeAlert Agent for Linux monitors the health and statistics of the system
`HALpmamib`	PrimeAlert MIB-II System provides information about the MIB
`HALpmaast`	PrimeAlert AgentHealth monitors statistics about the system
`HALpmalsa`	PrimeAlert SystemMonitor provides information about the operating system
`HALpmakit`	PrimeAlert Agent Toolkit