Halcyon PrimeAlert (R) for Network Appliance
Version 1.0.0
For use with Sun Management Center
README.install
-----------------------------------------------------------------------
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
----------------------- ----------------- ----- ------ -------
Sparc Solaris 2.8-2.10 Sun MC 3.5-4.0 x x x
x86 Solaris 2.9-2.10 Sun MC 3.5-4.0 x
x86 Solaris 2.10 Sun MC 4.0 x x
Windows NT 4.0/2000 Sun MC 3.5-4.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 Network Appliance distribution file,
HALsmxnet_1.0.0b.tar.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
# gzip -d HALsmxnet_1.0.0b.tar.gz
# tar xvf HALsmxnet_1.0.0b.tar
In this case, the directory /tmp/install/HALsmxnet_1.0.0b 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: 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 Network Appliance distribution file (see the above section
'Extracting the Distribution File') in a temporary location, and then
run the script HALNetApp-install.sh, e.g.:
% su -
# cd <SOURCE_DIR>
# ./HALNetApp-install.sh -s
Agent Layer Packages - Solaris
------------------------------
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 Network Appliance, or that is receiving PrimeAlert for Network
Appliance for the first time.
Login to a Sun Management Center agent host as root. Extract the
PrimeAlert for Network Appliance distribution file (see the above
section 'Extracting the Distribution File') in a temporary location,
and then run the script HALNetApp-install.sh, e.g.:
% su -
# cd <SOURCE_DIR>
# ./HALNetApp-install.sh -a
The SunMC agent should be restarted after installation/upgrade.
% 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 Network Appliance, or that is receiving PrimeAlert for Network Appliance for
the first time.
Login to a Sun Management Center console host as root. Extract the
PrimeAlert for Network Appliance distribution file (see the above section
'Extracting the Distribution File') in a temporary location, and then
run the script HALNetApp-install.sh, e.g.:
% su -
# cd <SOURCE_DIR>
# ./HALNetApp-install.sh -c
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 Network Appliance, or that is receiving PrimeAlert for Network
Appliance for the first time.
1. Extract the PrimeAlert for Network Appliance 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/HALNetApp_1.0.0.exe
2. Copy the Windows InstallShield installer to a convenient location
() on the Windows console host.
3. If present, remove the currently installed console package for
PrimeAlert for Network Appliance (see the following section 'Removing
Console Layer Packages - Windows').
4. Run the InstallShield package HALNetApp_1.0.0.exe, for
example:
Start->Run... \HALNetApp_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 Network Appliance.
The local SunMC console should be restarted after installation.
Installation Log File - UNIX Only
---------------------------------
To view the installation log, see the file:
/var/opt/SUNWsymon/install/HALNetApp-install_-.log
Loading PrimeAlert for Network Appliance
========================================
Please see the README file for the instruction on how to load the module.
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 NetApp server
The following package will be removed:
- HALmmsnet
Removing Agent Layer Packages
-----------------------------
The procedure described in this sub-section can be performed on any
Sun Management Center agent host where PrimeAlert for Network
Appliance is no longer required.
First, unload any instances of PrimeAlert for Network Appliance
currently loaded on the agent host where PrimeAlert for Network
Appliance is to be uninstalled.
Then, login to the agent host as root, and run the following commands:
Solaris: % su -
# cd /var/opt/SUNWsymon/uninstall
# ./HALUninstall.sh -module NetApp agent
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
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 Network Appliance 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 NetApp console
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 the PrimeAlert for Network Appliance 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 labelled "Add/Remove Programs (Properties)" will
appear.
3. Select "Halcyon PrimeAlert for Network Appliance" 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, see the file:
/var/opt/SUNWsymon/uninstall/log/uninstall.log.-
---//---