======================================================================
Halcyon PrimeAlert (R) Neuron Agent for Microsoft Windows
Version 3.1.0
README.INSTALL.html
======================================================================
Installation Instructions
=========================
Definitions
-----------
: On a Windows host, the user-selected installation
directory for the Neuron Agent for Windows. The
default value is:
C:\Program Files\Halcyon\Neuron.
Agent Host: The host where the Neuron Agent for Windows is
installed and running.
Requirements
------------
1) This product has been tested on:
Windows NT/2000/XP/2003 (32 bit)
Note: Halcyon officially supports the versions listed above as the
product was tested against these versions. It is possible
that the product may function correctly with other versions.
2) If the Neuron Agent is being installed on a host that is currently
running Microsoft SQL Server, it is recommended that the host be
rebooted after the Neuron Agent is installed.
3) For Windows NT 4 - In order for the Agent to function properly, it is
highly recommended that Service Pack 5 or later be applied. There is
also a hot fix to Service Pack 4 that can be employed. For details,
please consult the file NT_SP5.txt (see the sub-section 'Informational
Text Files' in the README.txt file for information on where to find
this file).
For Windows 2000 - In order for the Agent to function properly, it is
highly recommended that Service Pack 1 or later be applied.
4) If you wish to integrate the Neuron Agent with the Neuron Core, you must have:
Java 1.5 or higher
Note: For Sun Java use version 1.5.0_7 or higher
Note: The Neuron Core is the central event integration component and is
bundled with the Neuron Integration.
For more information visit: http://www.HalcyonInc.com
Installation Procedure
----------------------
The procedure described in this sub-section should be performed on
any Windows agent host that is being upgraded to the
latest version of the Neuron Agent for Windows, or that is
receiving packages for the first time.
SECURITY NOTE - If the Neuron Agent for Windows is installed on a Windows
drive that has a FAT filesystem (and not an NTFS filesystem), then the
agent files will be readable and writable by any user that can log into
the agent host, even if the user does not have administrative privileges.
Thus, it is highly recommended that the agent be installed on a drive
that contains an NTFS filesystem, so that proper access control rules apply.
1. Extract the Neuron Agent for Windows distribution file (see the
above section 'Extracting the Distribution File') using a zip
utility.
2. From the extracted distribution, copy the Windows InstallShield
installer file to a convenient location. It is located in the
distribution at:
/packages/win32/HALNeuronWindows_.exe
3. Select the user that will run the Neuron Agent Windows service.
It is recommended that a Windows user be created exclusively for
running the Neuron Agent.
Running the Neuron Agent as user LocalSystem (with account
.\SYSTEM) is being discouraged due to security concerns. Consult
Microsoft's web site for more details.
The Setup program should be run by the local administrator or by a
person who is member of the local or domain administrator group. If
the user who is performing the installation does not have
administrative privileges, installation may not be successful.
During installation, Setup attempts to set file permissions for the
user that was specified. If the installation drive contains an NTFS
filesystem, the following security scheme is applied:
Private Directories (\local\bin, \local\cfg):
Everyone: No Access
\Administrators: Full Control
Agent Service User: Full Control
Public Directories (\install, \local\log):
Everyone: Readable
\Administrators: Full Control
Agent Service User: Full Control
If you would like to choose different permissions, please set them
in the installation directory, , and its subdirectories.
In order for the service to execute the Neuron Agent, it is
required that the specified user has the right to log-on as a
service. This right can be granted with the User Rights Policy
dialog that is available from the Policies menu in the Windows
User Manager. Make sure the 'Show Advanced User Rights' check-box
is marked.
4. Run the InstallShield package HALNeuronWindows_.exe, for example:
Start->Run... \HALNeuronWindows_.exe
Follow the instructions presented on screen.
5. The following information must be entered to configure
the agent:
- Agent Port: The port the Neuron Agent will use to communicate
with SNMP managers. The default value is 6681.
- User Name: This is the account under which the Neuron Agent
is to be run. It must be a user known to Windows or the special
account LocalSystem, for example YOURDOMAIN\Neuron. You can
select a user from your domain by clicking on 'Select User'.
See step 3. above.
- Password: The password of the account for the Neuron Agent.
This password is for the User Name above. Note: If you use the
default User Name, LocalSystem, do not provide a password, as it
is not needed.
Following installation you can choose to start the 'Halcyon PrimeAlert
Agent' service. To manually start and stop the agent select:
Windows NT 4 --
Start -> Settings -> Control Panel -> Services ->
Halcyon PrimeAlert Agent -> Start/Stop
Windows 2000 --
Start -> Settings -> Control Panel -> Administrative Tools ->
Services -> Halcyon PrimeAlert Agent -> Start/Stop
Agent Layer Installation Problems
---------------------------------
If the installation program reports that it could not start the
Neuron Agent service due to a log-on error, ensure that the user
for the Neuron Agent service is valid and has the right to log on
as a service (see Item 4 of the previous sub-section).
---
Uninstallation Instructions
===========================
Removing Agent
--------------
The procedure described in this sub-section should be performed on any
Windows host where the Neuron Agent for Windows is to be removed.
1. Stop the 'Halcyon PrimeAlert Agent' service:
Windows NT 4 --
Start -> Settings -> Control Panel -> Services ->
Halcyon PrimeAlert Agent -> Stop
Windows 2000 --
Start -> Settings -> Control Panel -> Administrative Tools ->
Services -> Halcyon PrimeAlert Agent -> Stop
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 Agent for Windows" 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.
---//---