Halcyon PrimeAlert (R) for Sun Cluster 2.2
Version 1.0.0
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 SunMC 2.1.x/3.0 x
Solaris 2.6-2.8 SunMC 2.1.x/3.0 x x x
Windows NT 4.0/2000 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"
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 agent is
installed and running. This host must be a Solaris
host, and it contains the package SUNWesagt.
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.
Extracting the Distribution File
--------------------------------
The PrimeAlert for Sun Cluster 2.2 distribution file,
HALsmxsc2_1.0.0.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/install directory, and
will be extracted there. In this case, the procedure for extracting the
distribution file is:
% su -
# cd /tmp/install
# uncompress HALsmxsc2_1.0.0.tar.Z
or gzip -d HALsmxsc2_1.0.0.tar.gz
# tar xvf HALsmxsc2_1.0.0.tar
In this case, the directory /tmp/install/HALsmxsc2_1.0.0 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 host only.
Note that server layer packages should be installed/upgraded before
agent or console layer packages are installed/upgraded.
Login to the Sun Management Center server host as root. Extract the
PrimeAlert for Sun Cluster 2.2 distribution file (see the above section
'Extracting the Distribution File') in a temporary location, and then
run the script HALSunCluster22-install.sh, e.g.:
% su -
# cd <SOURCE_DIR>
# ./HALSunCluster22-install.sh -s
The following packages are installed or upgraded by the installation
script:
- HALmmssc2
- HALmmslog
- HALmmsprc
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
for Sun Cluster 2.2, or that is receiving PrimeAlert for Sun Cluster
2.2 for the first time.
Login to a Sun Management Center agent host as root. Extract the
PrimeAlert for Sun Cluster 2.2 distribution file (see the above section
'Extracting the Distribution File') in a temporary location, and then
run the script HALSunCluster22-install.sh, e.g.:
% su -
# cd <SOURCE_DIR>
# ./HALSunCluster22-install.sh -a
The following packages are installed or upgraded by the installation
script:
- HALsmasc2
- HALsmalog
- HALsmaprc
After the packages are installed, restart the local SunMC agent:
% su -
# $ESROOT/sbin/es-stop -a
# $ESROOT/sbin/es-start -a
Console Layer Packages - Solaris
--------------------------------
The procedure described in this sub-section should be performed on any
console host that is being upgraded to the latest version of PrimeAlert
for Sun Cluster 2.2, or that is receiving PrimeAlert for Sun Cluster
2.2 for the first time.
Login to a Sun Management Center console host as root. Extract the
PrimeAlert for Sun Cluster 2.2 distribution file (see the above section
'Extracting the Distribution File') in a temporary location, and then
run the script HALSunCluster22-install.sh, e.g.:
% su -
# cd <SOURCE_DIR>
# ./HALSunCluster22-install.sh -c
The following packages are installed or upgraded by the installation
script:
- HALmmcsc2
- HALmmclog
- HALmmcprc
The local SunMC console should be restarted after installation.
Console Layer Packages - Windows
--------------------------------
The procedure described in this sub-section should be performed on any
Windows console host that is being upgraded to the latest version of
PrimeAlert for Sun Cluster 2.2, or that is receiving PrimeAlert for Sun
Cluster 2.2 for the first time.
1. Extract the PrimeAlert for Sun Cluster 2.2 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/HALSunCluster22_1.0.0.exe
2. Copy the Windows InstallShield installer to a convenient location
(<path>) on the Windows console host.
3. If present, remove the currently installed console package for
PrimeAlert for Sun Cluster 2.2 (see the following section 'Removing
Console Layer Packages - Windows').
4. Run the InstallShield package HALSunCluster22_1.0.0.exe, for
example:
Start->Run... <path>\HALSunCluster22_1.0.0.exe
Follow the instructions presented on 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 for Sun Cluster 2.2.
The local SunMC console should be restarted after installation.
Installation Log File
---------------------
To view the installation log on a Solaris host, see the file:
/var/opt/SUNWsymon/install/HALSunCluster22-install_<YYYYMMDD>-<HHMMSS>.log
Uninstallation Instructions
===========================
Removing Server Layer Packages
------------------------------
The procedure described in this sub-section should be performed on the
Sun Management Center server 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 SunCluster22 server
All or some of the following packages will be removed:
- HALmmsprc
- HALmmslog
- HALmmssc2
Removing Agent Layer Packages
-----------------------------
The procedure described in this sub-section can be performed on any
Sun Management Center agent host where PrimeAlert for Sun Cluster 2.2
is no longer required.
First, unload any instances of PrimeAlert for Sun Cluster 2.2 currently
loaded on the agent host where PrimeAlert for Sun Cluster 2.2 is to be
uninstalled.
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 SunCluster22 agent
All or some of the following packages will be removed:
- HALsmaprc
- HALsmalog
- HALsmasc2
After the packages are removed, the agent process can be restarted,
although this step is not required:
% su -
# $ESROOT/sbin/es-stop -a
# $ESROOT/sbin/es-start -a
Removing Console Layer Packages - Solaris
-----------------------------------------
The procedure described in this sub-section should be performed on any
console host where packages for the PrimeAlert for Sun Cluster 2.2
are to be removed.
Login to a Sun Management Center console host as root, and then run
the following commands:
% su -
# cd /var/opt/SUNWsymon/uninstall
# ./HALUninstall.sh -module SunCluster22 console
All or some of the following packages will be removed:
- HALmmcprc
- HALmmclog
- HALmmcsc2
It is not necessary to restart the local SunMC console after package
uninstallation.
Removing Console Layer Packages - Windows
-----------------------------------------
The procedure described in this sub-section should be performed on any
Windows host where PrimeAlert for Sun Cluster 2.2 is to be removed.
1. Go to the Windows Start menu and select:
Start -> Settings -> Control Panel
A new Control Panel window will appear on your screen.
2. Double-click on the "Add/Remove Programs" icon in the Control Panel
window. A new window labeled "Add/Remove Programs (Properties)" will
appear.
3. Select "Halcyon PrimeAlert for Sun Cluster 2.2" 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.
Uninstallation Log File
-----------------------
To view the uninstallation log on a Solaris host, see the file:
/var/opt/SUNWsymon/uninstall/log/uninstall.log.<YYYYMMDD>-<HHMMSS>
---//---