Halcyon PrimeAlert (R) Agent for AIX
Version 1.0.0
For use with Sun Management Center
README.install
-----------------------------------------------------------------------
Nomenclature
============
- Halcyon has developed 'PrimeAlert Agents' for a number of platforms
(Windows NT 4 and 2000, HP-UX, Linux, and AIX) that allow non-Solaris
hosts to be monitored by Sun Management Center.
Supported Platforms
===================
See README file for details.
Installation Instructions
=========================
Definitions
-----------
Server Host: A host where the Sun Management Center server is
installed and running. This host must be a Solaris
host, and it contains the package SUNWessrv.
Agent Host: The host where the PrimeAlert Agent for AIX is
installed and running.
Console Host: A host where the Sun Management Center console is
installed and running. If this host is a Solaris
host, it contains the package SUNWescon; it may
also be a host running Windows.
[version]: The current version of this product.
Requirements
------------
1) This agent has been tested on the platforms outlined in the
'Supported Platforms' section of the README file. There is no
guarantee that it will work on other versions of the operating
system.
2) The following filesets must be installed in order to use the
PrimeAlert for SystemMonitor module:
bos.perf.libperfstat
bos.perf.perfstat
Extracting the Distribution File
--------------------------------
The PrimeAlert Agent for AIX distribution file,
HALAIXAgent_[version].tar.(Z|gz), must be extracted on a UNIX host before
any packages can be installed. For example, assume that the
distribution file has been copied to the /tmp/install directory, and
will be extracted there. In this case, the procedure for extracting the
distribution file is:
% su -
# cd /tmp/install
# gzip -d HALAIXAgent_[version].tar.gz
# tar xvf HALAIXAgent_[version].tar
In this case, the directory /tmp/install/HALAIXAgent_[version] represents
the installation source directory, <SOURCE_DIR>, which is referenced
below.
Server Layer Packages - Solaris Only
------------------------------------
The procedure described in this sub-section should be performed on the
Sun Management Center server layer host only.
Note that server layer packages should be installed/upgraded before
agent layer packages are installed/upgraded.
Login to the Sun Management Center server host as root. Extract the
PrimeAlert Agent for AIX distribution file (see the above section
'Extracting the Distribution File') in a temporary location, and then
run the script HALAIXAgent-install.sh, e.g.:
% su -
# cd <SOURCE_DIR>
# ./HALAIXAgent-install.sh -s
Agent Layer Packages - AIX Only
---------------------------------
The procedure described in this sub-section should be performed on any
AIX host that is being upgraded to the latest version of the
PrimeAlert Agent for AIX, or that is receiving the PrimeAlert Agent
for AIX for the first time.
Login to a AIX host as root. Extract the PrimeAlert Agent for AIX
distribution file (see the above section 'Extracting the Distribution
File') in a temporary location, and then run the script
HALAIXAgent-install.sh, e.g.:
% su -
# cd <SOURCE_DIR>
# ./HALAIXAgent-install.sh -a
If you are doing an initial install, you are requested to enter the
following parameters:
- PrimeAlert Agent Port: This is the port used by the server to
communicate with the PrimeAlert Agent. The default value is 161.
Press <ENTER> if you want to keep the default, or specify a
different port.
- SunMC Trap Server: This is the name of the host that runs the SunMC
Trap Server component. This can only be a Solaris host. Therefore,
no default value is provided. Typically, the trap server runs on
the server layer host.
- SunMC Trap Port: This is the port used by the PrimeAlert Agent for
AIX to communicate with the SunMC Trap Server. The default value
is 162. Press <ENTER> if you want to keep the default, or specify a
different port.
- SunMC Event Server: This is the name of the host that runs the
SunMC Event Server component. This can only be a Solaris host. The
default value is the hostname you provided for the SunMC Trap
Server, since the server components usually reside on the same
host. Press <ENTER> if you want to keep the default, or specify a
different hostname.
- SunMC Event Port: This is the port used by the PrimeAlert Agent for
AIX to communicate with the SunMC Event Server. The default value
is 163. Press <ENTER> if you want to keep the default, or specify a
different port.
- Seed: This is the seed you used when you installed the SunMC server
components. In order for the PrimeAlert Agent for AIX to function
correctly, you have to specify the same seed. The default value is
"maplesyrup". Press <ENTER> if you want to keep the default, or
specify a different seed.
After the previous information has been provided, the install script
modifies the file /var/opt/PrimeAlert/cfg/domain-config.x. This file
is used as the main configuration file for your PrimeAlert Agent.
The install script also seeds the PrimeAlert Agent for AIX with the
seed you provided above.
Finally, the install script displays some information on additional
shell scripts that can be used to start, stop, or inquire about the
status of the PrimeAlert Agent for AIX.
At this stage, the installation of the PrimeAlert Agent component 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 simply be started. The agent is
controlled by the pa script. Use the following commands to control
the agent:
- pa start agent: Starts the PrimeAlert Agent.
- pa stop agent: Stops the PrimeAlert Agent.
- pa restart agent: Restarts the PrimeAlert Agent (stop and start).
- pa status agent: Prints the status of the PrimeAlert Agent
(is the agent running or not).
The shell script can be found in /opt/PrimeAlert/bin.
Installation Problems
---------------------
If the console and/or server cannot communicate with the agent, verify
that the agent has been seeded. This can be done by checking for the
existence of the file /var/opt/PrimeAlert/cfg/agent-engine-d.dat on the
AIX agent host. To perform a manual seeding on the AIX agent host,
do the following as root in a Unix shell:
# /opt/PrimeAlert/bin/pa usm-seed -s <seed> agent
where <seed> is the seed value that was used during the installation of
the Sun Management Center server layer. After the PrimeAlert Agent for
AIX has been re-seeded, it must be restarted. Note that no other
processes need to be restarted on any other hosts.
Installation Log File - UNIX Only
---------------------------------
To view the installation log on a Solaris/AIX host, see the
file:
Solaris -
/var/opt/SUNWsymon/install/HALAIXAgent-install_<YYYYMMDD>-<HHMMSS>.log
AIX -
/var/opt/PrimeAlert/install/HALAIXAgent-install_<YYYYMMDD>-<HHMMSS>.log
Uninstallation Instructions
===========================
NOTE: Before removing the PrimeAlert Agent for AIX, first remove all
modules that are installed on the AIX platform.
Removing Server Layer Packages
------------------------------
The procedure described in this sub-section should be performed on the
Sun Management Center server layer host only.
Login to the Sun Management Center server host as root, and then run
the following commands:
% su -
# cd /var/opt/SUNWsymon/uninstall
# ./HALUninstall.sh -module AIXAgent server
Removing Agent Layer Packages
-----------------------------
The procedure described in this sub-section can be performed on any
AIX host where PrimeAlert Agent for AIX is no longer required.
First, stop the PrimeAlert Agent for AIX process on the AIX host
by issuing the following commands as root:
% su -
# cd /opt/PrimeAlert/bin
# ./pa stop agent
Then, issue the following commands to uninstall the agent:
# cd /var/opt/PrimeAlert/uninstall
# ./HALUninstall.sh -module AIXAgent agent
Uninstallation Log File - UNIX Only
-----------------------------------
To view the uninstallation log on a Solaris/AIX host, see the
file:
Solaris -
/var/opt/SUNWsymon/uninstall/log/uninstall.log.<YYYYMMDD>-<HHMMSS>
AIX -
/var/opt/PrimeAlert/uninstall/log/uninstall.log.<YYYYMMDD>-<HHMMSS>
---//---