Halcyon PrimeAlert (R) ScriptRunner Script Pack
Version 1.0.2
For use with Sun Management Center
README.install
-----------------------------------------------------------------------
Nomenclature
============
- 'Sun Management Center' was formerly called 'Sun Enterprise SyMON'.
This product only supports Sun Management Center 2.1 or higher.
Supported Platforms
===================
The following table summarizes the platform support for the various
components contained within this distribution:
Operating Base Agent Server Console
System Product Layer Layer Layer
----------------- ----------------- ----- ------ -------
Solaris 2.5.1-2.8 SunMC 2.1.x/3.0 x
Installation Instructions
=========================
Definitions
-----------
ESROOT: This parameter only applies for a Solaris
installation host. For SunMC 2.1 or higher, this
directory is determined by the user while
installing SunMC; the default value is
/opt/SUNWsymon. To determine the value of ESROOT
on a SunMC agent host, run the command:
# echo "`pkgparam SUNWesagt BASEDIR`/SUNWsymon"
Agent Host: A host where a Sun Management Center agent is
installed and running. This host must be a Solaris
host, and it contains the package SUNWesagt.
Extracting the Distribution File
--------------------------------
The PrimeAlert ScriptRunner Script Pack distribution file,
HALsuxscr_1.0.2.tar.(Z|gz), must be extracted on a Solaris host before
any packages can be installed. For example, assume that the
distribution file has been copied to the /tmp directory, and will be
extracted there. In this case, the procedure for extracting the
distribution file is:
% su -
# cd /tmp
# uncompress HALsuxscr_1.0.2.tar.Z
or gzip -d HALsuxscr_1.0.2.tar.gz
# tar xvf HALsuxscr_1.0.2.tar
In this case, the directory /tmp/HALsuxscr_1.0.2 represents the
installation source directory, <SOURCE_DIR>, which is referenced below.
Agent Layer Packages - Solaris Only
-----------------------------------
The procedure described in this sub-section should be performed on any
agent host that is being upgraded to the latest version of PrimeAlert
ScriptRunner Script Pack, or that is receiving the Script Pack for the
first time. Normally, the agent layer of PrimeAlert ScriptRunner is
already installed on the host.
Login to a Sun Management Center agent host as root. Extract the
PrimeAlert ScriptRunner Script Pack distribution file (see the above
section 'Extracting the Distribution File') in a temporary location,
and then run the script HALUtilityScripts-install.sh, e.g.:
% su -
# cd <SOURCE_DIR>
# ./HALUtilityScripts-install.sh
The following package is installed or upgraded by the installation
script:
- HALsuascr
Version 5.26.0 of expect is also included in this package. It will be
installed in /var/opt/SUNWsymon/lib.
Look at the README file for more information on the scripts included
and how to use them with PrimeAlert ScriptRunner.
Installation Log File
---------------------
To view the installation log, see the file:
/var/opt/SUNWsymon/install/HALUtilityScripts-install_<YYYYMMDD>-<HHMMSS>.log
Uninstallation Instructions
===========================
Removing Agent Layer Packages
-----------------------------
The procedure described in this sub-section can be performed on any
Sun Management Center agent layer host where the PrimeAlert
ScriptRunner Script Pack is no longer required.
First, unload any instances of PrimeAlert ScriptRunner currently loaded
on the agent host that are using scripts that belong to the Script
Pack.
Then, login to the Sun Management Center agent host as root, and run
the following commands:
% su -
# cd /var/opt/SUNWsymon/uninstall
# ./HALUninstall.sh -module UtilityScripts agent
The following package is removed by this process:
- HALsuascr
Uninstallation Log File
-----------------------
To view the uninstallation log, see the file:
/var/opt/SUNWsymon/uninstall/log/uninstall.log.<YYYYMMDD>-<HHMMSS>
---//---