======================================================================
Halcyon PrimeAlert (R) for Oracle
Version 2.1.0
For use with Sun Management Center
README.install
======================================================================
Overview
======================================================================
This README.install file describes how to install and setup the
PrimeAlert for Oracle module.
It consists of the following sections:
- Definitions
- Extracting the Distribution
- Installation Instructions
. Server Packages
. Agent Packages
. Console Packages
. Zone Configuration
- Uninstallation Instructions
. Server Packages
. Agent Packages
. Console Packages
- Install & Uninstall Logs
- Module Loading
Definitions
======================================================================
Server Host The host where the Sun Management Center server is
installed and running. This system must be a Solaris
host, and contain the package SUNWessrv.
Agent Host A host where a Sun Management Center agent is
installed and running. This system must be a Solaris
host, and contain the package SUNWesagt.
Console Host A host where the Sun Management Center console is
installed and running. This system may be a Solaris or
a windows host. On Solaris it contains the package
SUNWescon.
ESROOT: This parameter only applies for a Solaris
installation host. This directory is determined by
the user while installing Sun MC; the default value
is $ESROOT. To determine the value of $ESROOT on a
SunMC agent host, run the following command (for Solaris
10+ zoned environment, run the following command in a
non-sparse root zone):
# echo "`pkgparam SUNWesagt BASEDIR`/SUNWsymon"
Extracting the Distribution
======================================================================
The PrimeAlert for Oracle distribution file,
HALOracleDB_[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
In this case, the procedure for extracting the distribution will be:
% su -
# cd /tmp
# gzip -d HALOracleDB_[version].tar.gz
# tar -xvf HALOracleDB_[version].tar
Following the example above, the source directory [EXTRACT_DIR] would
be the following:
/tmp/HALOracleDB_[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 two required steps to install this product:
1. Install the server host packages
2. Install the agent host packages
3. Install the console host packages
4. Zone configuration (optional)
1. Server Packages (Solaris)
----------------------------------------------------------------------
To install the "PrimeAlert for Oracle" module packages on the Sun
Management Center server host, do the following:
1. Become the "root" user on the Sun Management Center server host
2. Extract the distribution file
3. Run the install script
% su -
# cd [EXTRACT_DIR] (i.e. /tmp/HALOracleDB_[version])
# ./HALDBMSAlertOracle-install.sh
Note: During installation on the server host, when asked whether you
want to install the packages for the agent layer, answer "y"
only if this is the agent that will be monitoring Oracle.
Answer "y" when asked to install the console layer packages,
if the console packages are to be installed.
2. Agent Layer Packages - (Solaris)
----------------------------------------------------------------------
The installation of the agent host packages is similar to the server
host packages installation.
To install the "PrimeAlert for Oracle" 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. Extract the distribution file
3. Run the install script
4. Restart the agent
% su -
# cd [EXTRACT_DIR] (i.e. /tmp/HALOracleDB_[version])
# ./HALDBMSAlertOracle-install.sh
# $ESROOT/sbin/es-stop -a
# $ESROOT/sbin/es-start -a
3. Console Packages (Solaris & Windows)
----------------------------------------------------------------------
The installation of the console host packages is optional and is only
required if you would like to launch Oracle Enterprise Manager
from the Sun Management Center console.
When installing the console layer of PrimeAlert for Oracle on a Solaris
host, the user is asked: "Do you want to set up Oracle Enterprise
Manager integration?". If the user chooses yes, then the installation
directory of the Oracle OEM console must be provided.
When installing the console layer of PrimeAlert for Oracle on a Windows
host, the console layer installer will automatically detect the Oracle
OEM console software, and configure the SunMC console accordingly.
NOTE: If the Oracle OEM console software is installed after the console
layer of PrimeAlert for Oracle is installed, it will not be possible to
launch the OEM console from the SunMC console unless the console layer
of PrimeAlert for Oracle is re-installed.
After Oracle OEM console integration has been configured for a
particular SunMC console host, the user will find that any PrimeAlert
for Oracle node in the hierarchical view of the Browser tab (Host
Details window) will have a new pop-up menu item, 'Launch OEM...'.
When selected, the launcher will cause the OEM console application to
be launched on the current SunMC console host.
To install the "PrimeAlert for Oracle" module packages
on the Sun Management Center console host, do the following:
Solaris Console
---------------
1. Become the "root" user on the Sun Management Center console host
2. Extract the distribution file
3. Run the install script
4. Restart the console
% su -
# cd [EXTRACT_DIR] (i.e. /tmp/HALOracleDB_[version])
# ./HALDBMSAlertOracle-install.sh
# $ESROOT/sbin/es-start -c
Windows Console
---------------
1. Extract the distribution file
2. Run the InstallShield installer for Windows
3. Restart the console
# cd [EXTRACT_DIR]/packages/win32
# Double click on "HALDBMSAlertOracle_2.1.0.exe"
# Double click on "Sun Management Center.exe" to start the console
4. Zone Configuration
----------------------------------------------------------------------
If you would like to use this product in a Solaris whole root zoned
environment, just install the module the same way as in a global zone.
If you would like to use this product in a Solaris sparse root zoned
environment, ensure Sun MC agent is configured in the sparse root zone.
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
Uninstallation Instructions
======================================================================
This section explains how to uninstall the various PrimeAlert for
Oracle components:
1. Uninstall the server host packages
2. Uninstall the agent host packages
3. Uninstall the console host packages
In general, the uninstall script can be used with no arguments to
uninstall any Halcyon PrimeAlert product:
# /var/opt/SUNWsymon/uninstall/HALUninstall.sh
Uninstall Server Packages
----------------------------------------------------------------------
To uninstall the PrimeAlert for Oracle module packages
on the Sun Management Center server host, do the following:
1. Become the "root" user on the Sun Management Center server host
2. Run the uninstall script with the appropriate parameters
% su -
# cd /var/opt/SUNWsymon/uninstall
# ./HALUninstall.sh -module Oracle server
Uninstall Agent Packages
----------------------------------------------------------------------
To uninstall the PrimeAlert for Oracle 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
# ./HALUninstall.sh -module Oracle agent
Uninstall Console Packages (Solaris & Windows)
----------------------------------------------------------------------
To uninstall the "PrimeAlert for Oracle" module
packages on the Sun Management Center console host, do the following:
Solaris Console
---------------
1. Become the "root" user on the Sun Management Center server host
2. Run the uninstall script with the appropriate parameters
% su -
# cd /var/opt/SUNWsymon/uninstall
# ./HALUninstall.sh -module Oracle console
Windows Console
---------------
1. Double-click on "Add/Remove Programs" in the "Control Panel"
Start -> Settings -> Control Panel
2. Select "Halcyon PrimeAlert for Oracle" and
click the "Add/Remove..." button.
3. An UnInstallShield session will be launch; follow the
instructions to uninstall the product.
Install & Uninstall Logs
======================================================================
All Halcyon PrimeAlert install and uninstall log files can be found
in the following directories:
/var/opt/SUNWsymon/install
/var/opt/SUNWsymon/uninstall
Note: There are no install or uninstall logs for the Windows console.
Installation Log
----------------
The name of the installation log for this product is the following:
HALDBMSAlertOracle-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".
---//---