======================================================================
Halcyon PrimeAlert (R) Enterprise Reporter
Version 1.1.0
README
======================================================================
Included Components
======================================================================
This distribution includes the following PrimeAlert product:
PrimeAlert Enterprise Reporter
Supported Platforms
======================================================================
PrimeAlert Enterprise Reporter is only supported for the following
software product(s):
Sun Management Center 3.5 - 4.0
Oracle 10g, 11g
PostgreSQL 8.3.3 (included)
Firefox 2.x - 3.x
Internet Explorer 7
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*
x86/x64 Solaris 2.10 Sun MC 4.0 x*
* - The PrimeAlert Enterprise Reporter product includes its own
web-based interface. There is no component to be installed
on the Sun MC console layer.
Note: Halcyon officially supports the versions listed above as the
product was tested against these releases. It is possible
that the product may function correctly with other versions.
Informational Text Files
======================================================================
A number of useful informational text files are included with this
distribution:
- README
- README.install
- README.oracle
- TroubleShooting
- ReleaseNotes
- LICENSE
- COPYRIGHT
These files are located in the base directory of the distribution
tarball, and after installation, in the directory:
- On a Solaris host:
/var/opt/SUNWsymon/install/HALEnterpriseReporter
Installation and Uninstallation Instructions
======================================================================
For installation or uninstallation instructions, refer to the
following file:
- README.install
Use Oracle Database with PrimeAlert Enterprise Reporter
======================================================================
For information on how to use Oracle Database with PrimeAlert
Enterprise Reporter, refer to the following file:
- README.oracle
Troubleshooting
======================================================================
For troubleshooting information, refer to the following file:
- TroubleShooting
Release Notes
======================================================================
For information about bug fixes, enhancements, known problems, and
upgrade strategy for the current release, refer to the following file:
- ReleaseNotes
Help Documentation
======================================================================
To view the online help for PrimeAlert Enterprise Reporter, point your
browser to the following file:
./doc/EnterpriseReporter/HALEReporter-h.html
This documentation is also available as from within the web-based
interface for PrimeAlert Enterprise Reporter.
License Agreement
======================================================================
Please read the license agreement in the following file:
- LICENSE
Without purchasing a license, PrimeAlert Enterprise Reporter will only
operate for a trial period of 30 days from installation.
If you wish to purchase a license to use PrimeAlert Enterprise Reporter,
please contact us at:
Web: http://www.HalcyonInc.com
Email: info@HalcyonInc.com
Tel: 416-932-4647
Fax: 416-932-4711
Overview
======================================================================
PrimeAlert Enterprise Reporter collects reporting data from Sun MC
agents that have the PrimeAlert Reporter module loaded and stores it
in a database. It also provides a web-based user interface to graph
the stored data.
In order to contact the Sun MC server and collect reporting data from
Sun MC agents, PrimeAlert Enterprise Reporter must be installed on the
Sun MC server layer. Also, the PrimeAlert Reporter module must be
installed and loaded on each Sun MC agent host where reporting is to
take place.
Getting Started with PrimeAlert Enterprise Reporter
======================================================================
After installing and starting PrimeAlert Enterprise Reporter a user
can login on the host and port provided during installation. The user
is authenticated against the local /etc/passwd, /etc/group, and
/etc/shadow files.
Start/Stop PrimeAlert Enterprise Reporter PostgreSQL Database server
======================================================================
If a user chooses to install PostgreSQL database along with Enterprise
Reporter, the PrimeAlert Enterprise Reporter PostgreSQL Database
instance will be started when Enterprise Reporter is started (Please
refer to README.install file on how to start the Apache Tomcat server
of PrimeAlert Enterprise Reporter), and it will be stopped when
Enterprise Reporter is stopped.
However, after the installation of Enterprise Reporter, a user can
start/stop PrimeAlert Enterprise Reporter PostgreSQL Database server
instance alone at any time as needed.
To start PrimeAlert Enterprise Reporter PostgreSQL Database instance,
run the following command as root:
% su -
# $ESROOT/HALmmspgd/bin/halpgStartDB.sh
To stop PrimeAlert Enterprise Reporter PostgreSQL Database instance,
run the following command as root:
% su -
# $ESROOT/HALmmspgd/bin/halpgStopDB.sh
where, ESROOT is defined in README.install. The default value is
/opt/SUNWsymon.
Backup/Restore PrimeAlert Enterprise Reporter PostgreSQL Database
======================================================================
After installing the module, a user can backup/restore PrimeAlert Enterprise
Reporter PostgreSQL Database at any preferred time.
To backup PrimeAlert Enterprise Reporter PostgreSQL Database, run the
following command as root. Database dumps will be written to a backup SQL
script file. User will be asked to type in the full path of the backup
script file name.
% su -
# $ESROOT/HALmmspgd/bin/halpgBackupDB.sh
To restore PrimeAlert Enterprise Reporter PostgreSQL Database from a
backup script file that was generated by halpgBackupDB.sh tool, run
the following command as root. You will be asked to type in the full
path of the backup script file name.
% su -
# $ESROOT/HALmmspgd/bin/halpgRunPSQL.sh
where, ESROOT is defined in README.install. The default value is
/opt/SUNWsymon.
---//---