19.3 Planning GroupWise Monitor

Use the GroupWise Monitor Installation Worksheets 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 Worksheet organizes the information in the order in which you need it during installation.

IMPORTANT:If you are installing GroupWise Monitor in a clustered server environment, see the Setting up a GroupWise Cluster in the GroupWise 18 Interoperability Guide before you install Monitor.

19.3.1 Deciding Where to Install the GroupWise Monitor Components

After reviewing GroupWise Monitor Overview and the system requirements listed in GroupWise Monitor System Requirements, plan where you want to install the Monitor components in your system.

Monitor Agent Server

The Monitor Agent runs on Linux and Windows. On Linux, the Monitor Agent runs as a daemon. On Windows, the Monitor Agent runs as a Windows service or as an application. When the Monitor Agent runs as an application, it has a user interface on the Windows server. When it runs as a Windows service, it does not.

If you want to install the Monitor Agent and the Monitor Application to the same server, you can install them at the same time. If you want to install them to 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 Linux for use with a Linux web server, but you might want to install the Monitor Agent on Windows so that you can use its server console, which is not available on Linux.

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 folder for the Monitor Agent depends on the platform:

  • Linux:
  • Windows:
  • The Linux Monitor Agent is automatically installed to /opt/novell/groupwise/agents.
  • The default installation directory is c:\Program Files\Novell\GroupWise Monitor.

On Windows, you can specify a different directory during installation. On Linux, you cannot.

GROUPWISE MONITOR AGENT INSTALLATION WORKSHEET

Under Agent Software Platform, mark the platform (Linux or Windows) where you plan to install the Monitor Agent.

Under Server Information, specify the directory on the Linux or Windows server where you plan to install the Monitor Agent software.

Web Server

The Monitor Application can be installed to a web server on Linux or Windows.

GROUPWISE MONITOR APPLICATION INSTALLATION WORKSHEET

Under Web Server Platform, mark whether you plan to install the Monitor Application to a Linux or Windows web server.

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 on OES:
  • Tomcat on OES:
  • /etc/opt/novell/httpd/conf.d
  • /var/opt/novell/tomcat9/webapps
  • Apache Web Server on SLES:
  • Tomcat on SLES:
  • /etc/apache2/conf.d
  • /usr/share/tomcat9/webapps
  • Tomcat on Windows:
  • c:\novell\tomcat9\webapps

GROUPWISE MONITOR APPLICATION INSTALLATION WORKSHEET

Under Web Server Information, select the type of web server you want to use with Monitor, and specify the directory path to the web server root directory.

19.3.2 Determining the Monitor Agent’s Configuration

As you install the Monitor Agent, you are prompted to supply the configuration information:

Monitor Agent Network Address

The Monitor Agent communicates with the Monitor Application and with monitored agents by way of TCP/IP.

GROUPWISE MONITOR AGENT INSTALLATION WORKSHEET

Under Server Information, 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.

If you are installing the Monitor Application on a different server from where you are installing the Monitor Agent, record the same information under Monitor Agent Information on the GroupWise Monitor Agent Installation Worksheet.

For a complete list of default port numbers used by the GroupWise agents, see GroupWise Port Numbers in the GroupWise 18 Administration Guide.

Domain Folder

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 WORKSHEET

Under Domain Location, specify the path to a domain folder where an MTA is running.

If the domain is located on a different server from where you are installing the Monitor Agent, specify the IP address or DNS hostname of the domain server.

Service vs. Application (Windows Only)

On Windows, you can choose to install the Monitor Agent as a Windows service or an application.

When you install the Monitor Agent as an application, it displays a Monitor Agent console on the server where it runs. You can start the Windows Monitor Agent on the Windows Start menu, or you can create a desktop icon for it.

When you install the Monitor Agent as a service, it does not display a server console. You manage it by using the Windows Services administrative tool.

GROUPWISE MONITOR AGENT INSTALLATION WORKSHEET

Under Windows Installation Option, mark Service or Application.

19.3.3 Determining the Monitor Application’s Configuration

Monitor Application configuration information is stored in a configuration file (gwmonitor.cfg), located in the following directories:

  • Linux:
  • Windows:
  • /var/opt/novell/groupwise/monitor
  • c:\novell\groupwise\gwmonitor

The default configuration information is sufficient for an initial Monitor Application installation. For more information about configuring the Monitor Application, see Configuring the Monitor Application in the GroupWise 18 Administration Guide after you have installed the Monitor Application.