======================================================================
Halcyon PrimeAlert (R) ScriptRunner
Version 1.1.0
README.install
======================================================================
Overview
======================================================================
This README.install file describes how to install and setup the
PrimeAlert ScriptRunner modules.
It consists of the following sections:
- Definitions
- Extracting the Distribution
- Installation Instructions
. Server Packages
. Agent Packages
- Uninstallation Instructions
. Server Packages
. Agent Packages
- Install & Uninstall Logs
- Module Loading
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: A host where a Sun Management Center or PrimeAlert
agent is installed and running. If the host is a
Solaris host, it contains the package SUNWesagt;
for a Linux host, HALpialag, and for an HP-UX host,
HALpiahpa. It can also be a Windows host.
Sparse root zones available on Solaris 10+ systems
do not require SUNWesagt but the SunMC agents should
be configured before enabling zone support for this
product.
ESROOT: This parameter only applies for a Solaris
installation host. For SunMC 3.0 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"
Extracting the Distribution
======================================================================
The PrimeAlert ScriptRunner distribution file,
HALsmxscr_[version].tar.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
following directory:
/tmp_install
In this case, the procedure for extracting the distribution file is:
% su -
# cd /tmp_install
# gzip -d HALsmxscr_[version].tar.gz
# tar xvf HALsmxscr_[version].tar
Following the example above, the source directory [EXTRACT_DIR] would
be the following:
/tmp_install/HALsmxscr_[version]
Installation Instructions
======================================================================
This product may be installed using Halcyon's standard installation
method or with Sun Management Center's Agent Update feature. To
install the product with Agent Update, refer to the instructions in
the following file:
./AgentUpdate/README-AgentUpdate.html
or
http://www.halcyoninc.com/support/README-AgentUpdate.html
NOTE:
If you choose to use Agent Update, then all Halcyon products must be
installed using Agent Update. It is not possible to use Agent
Update in conjunction with any other installation procedure.
To install the product with Halcyon's standard installation method,
continue with the instructions outlined in this section.
There is one optional and three required steps to install this product:
1. Install the server host packages
2. Install the agent host packages (Solaris, Linux, HPUX)
3. Zone configuration (optional)
4. Install the agent host packages (Windows)
1. 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 ScriptRunner distribution file (see the above section
'Extracting the Distribution File') in a temporary location, and then
run the script HALScriptRunner-install.sh, e.g.:
% su -
# cd [SOURCE_DIR]
# ./HALScriptRunner-install.sh -s
2. Agent Layer Packages - Solaris, Linux, and HP-UX
----------------------------------------------------------------------
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, or that is receiving ScriptRunner for the first time.
For Solaris, login to a Sun Management Center agent host as root; for
Linux or HP-UX, login to a PrimeAlert Agent host as root. Extract the
PrimeAlert ScriptRunner distribution file (see the above section
'Extracting the Distribution File') in a temporary location, and then
run the script HALScriptRunner-install.sh, e.g.:
% su -
# cd [SOURCE_DIR]
# ./HALScriptRunner-install.sh -a
After the package is installed, restart the agent:
Solaris: % su -
# $ESROOT/sbin/es-stop -a
# $ESROOT/sbin/es-start -a
Linux/HP-UX: % su -
# /opt/PrimeAlert/bin/pa stop agent
# /opt/PrimeAlert/bin/pa start agent
NOTE:
On HP-UX systems it may be necessary to run the install script from
a local file system since the HP installation software requires root
access to the directories containing the packages.
3. Zone Configuration (Solaris)
----------------------------------------------------------------------
If you would like to use this product in a Solaris whole root zoned
environment, just install the module as if it is a global zone.
If you would like to use this product in a Solaris sparse root zoned
environment, perform the following steps in each sparse root zone
where the product is required after installing it in the global zone:
# zlogin [name of sparse root zone]
# $ESROOT/sbin/HALZoneConfig.sh
# $ESROOT/sbin/es-stop -a
# $ESROOT/sbin/es-start -a
4. Agent Layer Packages - Windows
----------------------------------------------------------------------
The procedure described in this sub-section should be performed on
any Windows agent host that is being upgraded to the
latest version of PrimeAlert ScriptRunner, or that is receiving
ScriptRunner for the first time.
1. Extract the PrimeAlert ScriptRunner distribution file (see the
above section 'Extracting the Distribution File') on a Solaris
host. In this case, the InstallShield installer for Windows has the
pathname:
[SOURCE_DIR]/packages/win32/HALScriptRunner_[version].exe
2. Copy the Windows InstallShield installer to a convenient location
([path]) on the Windows agent host.
3. If present, remove the currently installed agent packages
for PrimeAlert ScriptRunner (see the following section 'Removing
Agent and Console Layer Packages - Windows').
4. Run the InstallShield package HALScriptRunner_[version].exe, for
example:
Start->Run... [path]\HALScriptRunner_[version].exe
Follow the instructions presented on the screen.
Besides installing a number of program files, the installation
program puts a shortcut in the Start Menu's Programs folder,
sub-folder Halcyon. This shortcut provides easy and fast access
to help files for PrimeAlert ScriptRunner.
If PrimeAlert agent layer packages have been installed/updated, the local
PrimeAlert agent should be restarted after installation.
Uninstallation Instructions
======================================================================
This section explains how to uninstall the various PrimeAlert
ScriptRunner components:
1. Uninstall the server host packages
2. Uninstall the agent host packages - Solaris, and Linux
3. Uninstall the agent host packages - Windows
In general, the uninstall script can be used with no arguments to
uninstall any Halcyon PrimeAlert product:
# /var/opt/SUNWsymon/uninstall/HALUninstall.sh
1. Uninstall Server Packages - Solaris Only
----------------------------------------------------------------------
To uninstall the PrimeAlert High Availability module packages
on the Sun Management Center server host, complete the following
steps:
1. Login to the Sun Management Center server host as "root"
2. Run the uninstall script with the appropriate parameters
% su -
# cd /var/opt/SUNWsymon/uninstall
# ./HALUninstall.sh -module ScriptRunner server
2. Uninstall Agent Packages - Solaris, Linux, and HP-UX
----------------------------------------------------------------------
To uninstall the PrimeAlert High Availability module packages
on the Sun Management Center agent host, do the following:
1. Become the "root" user on the Sun Management Center agent host
2. Run the uninstall script with the appropriate parameters
% su -
# cd /var/opt/SUNWsymon/uninstall (Solaris)
or
cd /var/opt/PrimeAlert/uninstall (Linux/HP-UX)
# ./HALUninstall.sh -module ScriptRunner agent
NOTE - If PrimeAlert ScriptRunner is loaded as a module on the agent
where PrimeAlert ScriptRunner is being removed, then unload PrimeAlert
ScriptRunner from the agent prior to uninstalling ScriptRunner.
After the packages are removed, the agent process can be restarted,
although this step is not required:
Solaris: % su -
# $ESROOT/sbin/es-stop -a
# $ESROOT/sbin/es-start -a
Linux/HP-UX: % su -
# /opt/PrimeAlert/bin/pa stop agent
# /opt/PrimeAlert/bin/pa start agent
3. Uninstall Agent Packages - Windows
======================================================================
The procedure described in this sub-section should be performed on any
Windows host where PrimeAlert ScriptRunner is to be removed.
1. If PrimeAlert ScriptRunner is loaded as a module on the agent where
PrimeAlert ScriptRunner is being removed, then unload PrimeAlert
ScriptRunner from the agent.
2. Go to the Windows Start menu and select:
Start -> Settings -> Control Panel
A new Control Panel window will appear on your screen.
3. Double-click on the "Add/Remove Programs" icon in the Control Panel
window. A new window labeled "Add/Remove Programs (Properties)"
will appear.
4. Select "Halcyon PrimeAlert ScriptRunner" in the scrolling list of
the new window.
Windows NT 4 --
Click on the "Add/Remove..." button.
Windows 2000 --
Click on the "Change/Remove" button.
An UnInstallShield session will be launched; follow the
instructions presented on screen.
Install & Uninstall Logs
======================================================================
All Halcyon PrimeAlert install and uninstall log files can be found
in the following directories:
For a Solaris Host
------------------
/var/opt/SUNWsymon/install
/var/opt/SUNWsymon/uninstall
For a Linux/HP-UX Host
---------------------
/var/opt/PrimeAlert/install
/var/opt/PrimeAlert/uninstall
Installation Log
----------------
The name of the installation log file for this product is the following:
HALScriptRunner-install_[YYYYMMDD]-[HHMMSS].log
Uninstall Log
-------------
The following is the generic uninstall log file:
uninstall.log.[YYYYMMDD]-[HHMMSS]
Module Loading
======================================================================
Please refer to the "Module Loading" section in the help documentation
for details on how to load the module. Information on how to access
the help documentation is available in the "README" file under the
section "Help Documentation".
---//---