7.3 Monitor Agent Installation

7.3.1 Linux Monitor Agent Installation Directory

  • Linux agent installation directory
  • Subdirectory for GroupWise agent executables
  • Monitor Agent executable
  • Subdirectory for GroupWise agent library files
  • Monitor Agent language information files
  • Subdirectory for agent shared files
  • Monitor Agent configuration file
  • Standard Linux location for application startup scripts
  • Startup script for the Monitor Agent
  • Standard Linux location for run-level-3 symbolic links
  • Symbolic link to the startup script for the Monitor Agent
  • Standard Linux location for run-level-5 symbolic links
  • Symbolic link to the startup script for the Monitor Agent
  • Standard Linux location for application startup script links
  • Link to the startup script for the Monitor Agent
  • Standard Linux location for application log files
  • Subdirectory for GroupWise agent log files
  • Subdirectory for Monitor Agent log files
  • Monitor Agent event log files
  • Monitor Agent history log files
  • Subdirectory for Monitor Agent accounting files

Monitor Application files are integrated into your Web server to support the Monitor Web console. See Section 8.0, Web Application Installation Directories on Your Web Server.

agents directory

On a Linux server, the Monitor Agent is always installed in subdirectories of /opt/novell/groupwise/agents.

bin directory

The bin directory holds GroupWise executable files.

gwmon file

The gwmon file is the Monitor Agent executable. You run this executable file to start the Monitor Agent. See Starting the Linux Monitor Agent as a Daemon in Installing GroupWise Monitor in the GroupWise 2012 Installation Guide.

lib directory

The lib directory holds GroupWise shared library files.

gwmonxxx.fil files

These files contain all language-specific information for the Monitor Agent. The last two characters xx are a language code.

share directory

The share directory holds agent startup files and files that are used by the agent consoles and Web consoles.

monitor.xml file

The monitor.xml file is a specialized configuration file for use in the XIS environment.

/etc/init.d directory

The /etc/init.d directory is the standard location for Linux startup scripts.

grpwise-ma file

The grpwise-ma script is created automatically during installation. You can use the script to start, restart, stop, and display status information about the Monitor Agent. For more information about starting the Monitor Agent, see Starting the Linux Monitor Agent as a Daemon in Installing GroupWise Monitor in the GroupWise 2012 Installation Guide.

rc3.d directory

The rc3.d directory holds symbolic links to scripts that you want your Linux server to run when it is booted to runlevel 3 (multi-user; boots to a text mode login prompt without the X Window System). The symbolic link to the grpwise-ma script is Snngrpwise-ma. It is created if you choose during installation to have the Monitor Agent start automatically when the server boots.

rc5.d directory

The rc5.d directory holds symbolic links to scripts that you want your Linux server to run when it is booted to runlevel 5 (multi-user; boots to the X Window System login dialog box). The symbolic link to the grpwise-ma script is Snngrpwise-ma. It is created if you choose during installation to have the Monitor Agent start automatically when the server boots.

/usr/sbin directory

The /usr/sbin directory is the standard location for application scripts that can be run from any directory on the Linux server. The /usr/sbin directory is always included in the PATH environment variable. Files in this directory are links to the corresponding script files in /etc/init.d.

/var/log/novell/groupwise directory

The /var/log directory is the standard location for log files on Linux. All GroupWise agent log files are created in the novell/groupwise subdirectory.

gwmon directory

Within the gwmon directory, the Monitor Agent creates two different types of log files. The mmddmon.nnn log files inform you of its processing and any problems it encounters. The mmddhist.nnn log files record dumps of all MIB values gathered during each poll cycle. For more information about log files, see Configuring Monitor Agent Log Settings in Monitor in the GroupWise 2012 Administration Guide.

The first two digits of the file name represent the month; the next two digits represent the day of the month. The three-digit extension is a sequence number for multiple log files created on the same day. For example, 0518mon.002 is the second Monitor Agent log file created on May 18.

acct directory

Within the gwmon directory, the Monitor Agent creates an acct subdirectory for storing accounting files received from the GWIA and GroupWise gateways. For more information, see Receiving and Forwarding the Accounting Files in Monitor in the GroupWise 2012 Administration Guide.

7.3.2 Windows Monitor Agent Installation Directory

  • Windows Monitor Agent installation directory (64-bit machine)   
  • Windows Monitor Agent installation directory (32-bit machine)
  • GroupWise Agent Engine
  • Monitor Agent program
  • Monitor Agent configuration file
  • Monitor Agent language information file
  • Customized DLL program for SNMP
  • Monitor Agent event log files
  • Monitor Agent history log files
  • Monitor Agent working directory
  • Monitor Agent directory for accounting files

Monitor Application files are integrated into your Web server to support the Monitor Web console. See Section 8.0, Web Application Installation Directories on Your Web Server.

c:\Program Files\Novell\GroupWise Server\Monitor directory

On a Windows server, the Monitor Agent can be installed in any directory you choose. The default location is c:\Program Files\Novell\GroupWise Server\Monitor. The Monitor Agent desktop icon is set up to include the full path to whatever directory you choose.

gwenv1a.dll file

The gwenv1a.dll file is the GroupWise Agent Engine, a program that is shared by all GroupWise agents. It provides the following services to the agents:

  • Database management

  • File operations

  • Message handling

  • Thread management

  • Semaphores (file/record locking)

  • Date/time services

The first agent started on a server automatically starts the GroupWise Agent Engine DLL.

gwmon.exe file

The gwmon.exe file is the Monitor Agent program. You run this executable file to start the Monitor Agent. See Windows: Setting Up GroupWise Monitor in Installing GroupWise Monitor in the GroupWise 2012 Installation Guide.

monitor.xml

The monitor.xml file stores the Monitor Agent configuration information that you establish in the Monitor Agent console, as described in Configuring the Monitor Agent in Monitor in the GroupWise 2012 Administration Guide.

gwmonxx.dll files

The gwmonxx.dll files contain all language-specific information for the Monitor Agent. The last two characters xx are a language code.

gwsnmp.dll file

The gwsnmp.dll file provides interaction with the Windows SNMP Service, so that the Monitor Agent can throw SNMP traps. See Configuring SNMP Trap Notification for Agent Problems in Monitor in the GroupWise 2012 Administration Guide.

mmddmon.nnn files and mmddhist.nnn files

The Monitor Agent creates two different types of log files. The mmddmon.nnn log files inform you of its processing and any problems it encounters. The mmddhist.nnn log files record dumps of all MIB values gathered during each poll cycle. For more information about log files, see Configuring Monitor Agent Log Settings in Monitor in the GroupWise 2012 Administration Guide.

The first two digits of the file name represent the month; the next two digits represent the day of the month. The three-digit extension is a sequence number for multiple log files created on the same day. For example, 0518mon.002 is the second Monitor Agent log file created on May 18.

monwork directory

The monwork directory is used for temporary files used in calculating system performance, as described in Measuring Agent Performance in Monitor in the GroupWise 2012 Administration Guide

acct directory

The acct directory is used for storing accounting files received from the GWIA and GroupWise gateways, as described in Receiving and Forwarding the Accounting Files in Monitor in the GroupWise 2012 Administration Guide.