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

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