Use the GroupWise Monitor Installation Summary Sheets to record your decisions about how to install GroupWise Monitor. The topics in this section present the required information in a convenient planning sequence. The Installation Summary Sheet organizes the information in the order in which you need it during installation.
For additional assistance in planning your GroupWise installation, see GroupWise Best Practices and GroupWise 8 Good and Bad Habits.
IMPORTANT:If you plan to install GroupWise Monitor in a clustered server environment, refer to the GroupWise 8 Interoperability Guide as you plan your Monitor installation.
After reviewing Section 7.1, GroupWise Monitor Overview and the system requirements listed in Section 7.2, Monitor System Requirements, plan where you want to install the Monitor components in your system.
The Monitor Agent runs on Linux and Windows. On Linux, the Monitor Agent runs as a daemon. On Windows, the Monitor Agent runs as an application. The Monitor Agent cannot be run as a Windows service.
If you want to install the Monitor Agent and the Monitor Application on the same server, you can install them at the same time. If you want to install them on different servers, you must run the Monitor Installation program twice, once for each server. For example, you might want to install the Monitor Application on NetWare for use with a NetWare Web server, but you must always install the Monitor Agent on Linux or Windows.
The Monitor Agent needs to communicate with an MTA. If possible, install the Monitor Agent on the same server where a domain and MTA are already located. If you want to install the Monitor Agent on its own server, consider creating a domain on that server specifically for helping the Monitor Agent communicate with the rest of your GroupWise system.
The installation directory for the Monitor Agent depends on the platform:
|
Linux: |
The Linux Monitor Agent is automatically installed to /opt/novell/groupwise/agents. |
|
Windows: |
The default installation directory is c:\Program Files\Novell\GroupWise Server\Monitor. |
|
GROUPWISE MONITOR AGENT INSTALLATION SUMMARY SHEET |
|---|
|
Under , mark the platform (Linux or Windows) where you plan to install the Monitor Agent. Under , specify the directory on the Linux or Windows server where you want to install the Monitor Agent software. |
The Monitor Application integrates with your Web server to pass agent status information gathered by the Monitor Agent to your Web browser for display in the Monitor Web console. The location of the Monitor Application files that are installed depends on the Web server that it is being integrated with. The default Web server paths vary by platform:
|
Apache Web Server for NetWare: |
drive:\Apache2 |
|
Apache Web Server for OES Linux: Tomcat for OES Linux: |
/etc/opt/novell/httpd/conf.d /var/opt/novell/tomcat5/webapps |
|
Apache Web Server for SLES: Tomcat for SLES: |
/etc/apache2/conf.d /srv/www/tomcat5/base/webapps |
|
Microsoft Internet Information Server (IIS) for Windows: |
c:\inetpub\wwwroot |
The Web server uses a servlet engine in order to incorporate product-specific components, such as the Monitor Application, into its functioning.
|
GROUPWISE MONITOR APPLICATION INSTALLATION SUMMARY SHEET |
|---|
|
Under , select the type of Web server you want to use with Monitor, and specify the directory path to the Web server root directory. On Windows, if the Internet Information Server services more than one Web site, specify the Web site where you want to install the Monitor Application. |
As you install the Monitor Agent, you are prompted to supply the configuration information described in the following sections:
The Monitor Agent can monitor both GroupWise agents and Messenger agents. In addition, the Monitor Agent works in conjunction with the GroupWise High Availability service on Linux to automatically restart GroupWise and Messenger agents that go down unexpectedly
It is not necessary to have an entire GroupWise system installed in order for the Monitor Agent to monitor Messenger agents. For more information, see Setting Up the High Availability Service
in Installing a Novell Messenger System
in the Novell Messenger 2.2 Installation Guide.
|
GROUPWISE MONITOR AGENT INSTALLATION SUMMARY SHEET |
|---|
|
Under , mark whether you want to monitor a GroupWise system, a Messenger system, or both. |
The Monitor Agent communicates with the Monitor Application and with monitored agents by way of TCP/IP.
|
GROUPWISE MONITOR AGENT INSTALLATION SUMMARY SHEET |
|---|
|
Under , record the IP address or DNS hostname of the Linux or Windows server where you plan to install the Monitor Agent software. Use the default port number of 8200 unless that number is already in use on that server. |
For a complete list of default port numbers used by the GroupWise agents, refer to GroupWise Port Numbers
in the GroupWise 8 Administration Guide.
The Monitor Agent can gather information about the locations of GroupWise agents to monitor by reading from a domain database. Using the gathered information, the Monitor Agent can display a list of monitored agents when you start it for the first time.
|
GROUPWISE MONITOR AGENT INSTALLATION SUMMARY SHEET |
|---|
|
Under , specify the directory path to a domain where a GroupWise 6.x or later MTA is running. |
GroupWise Monitor is automatically installed in all available languages. During installation, you can select a default language for the Monitor Agent server console interface, which is available only on Windows.
|
GROUPWISE MONITOR AGENT INSTALLATION SUMMARY SHEET |
|---|
|
Under , specify a default language. |
NOTE:On Linux, you use the Monitor Web consoles exclusively.
For more information, see Multilingual GroupWise Systems
in the GroupWise 8 Administration Guide.
If you are installing the Linux Monitor Agent and Monitor Application, the Installation program needs to access eDirectory through LDAP. eDirectory access is required in order to create the Monitor Application objects. To obtain access, the Installation program needs the IP address and port number of an LDAP server, along with an eDirectory username and password to log in with. The user must have sufficient rights to create GroupWise objects in eDirectory. Because the Linux Installation program uses LDAP to access eDirectory, you must provide the username in LDAP format. For example:
cn=admin,ou=users,o=corporate
If you want to secure the connection to eDirectory with SSL, you can specify a root certificate file. For background information about SSL, see Trusted Root Certificates and LDAP Authentication
in Security Administration
in the GroupWise 8 Administration Guide.
IMPORTANT:If you do not want to use SSL, the LDAP server must be configured to accept clear text passwords. This is configured on the server’s LDAP Group object in ConsoleOne by deselecting .
|
GROUPWISE MONITOR AGENT INSTALLATION SUMMARY SHEET |
|---|
|
Under , specify the IP address and port number of an LDAP server, a username in LDAP format, the password for the username, and if necessary, the full path to your SSL root certificate file. |
As you install the Monitor Application to a Web server, you are prompted to supply the configuration information described in the following sections:
Monitor Application configuration information is stored in two places:
In Novell eDirectory
In a configuration file (gwmonitor.cfg), located in the following directories:
You can easily modify the configuration information in ConsoleOne by editing the properties of the GroupWise Monitor Application object (named GroupWiseMonitor). However, the configuration file is required if you need to install the Monitor Application to a Web server that is outside your firewall, where access to eDirectory is not available.
|
GROUPWISE MONITOR APPLICATION INSTALLATIONSUMMARY SHEET |
|---|
|
Under , specify the tree and context where you want the Installation program to create the GroupWise Monitor Application object (named GroupWiseMonitor) and the accompanying Monitor Provider object (named GroupWiseProvider). |
eDirectory is considered the master location for the Monitor Application configuration information. Any changes made directly to the Monitor Application configuration file are overwritten the next time the information in eDirectory is modified and saved.
The default configuration information is sufficient for an initial Monitor installation. For more information about configuring Monitor, see Monitor
in the GroupWise 8 Administration Guide.
GroupWise Monitor is automatically installed in all available languages. If necessary, you can select a different default language for the Monitor Web console interface than you selected for the Monitor Agent server console interface.
NOTE:The Monitor Agent server console interface is available only on Windows.
|
GROUPWISE MONITOR AGENT INSTALLATION SUMMARY SHEET |
|---|
|
Under Default Language, specify a default language for the Monitor Web console |
For more information, see Multilingual GroupWise Systems
in the GroupWise 8 Administration Guide.