Monitor Agent Installation


Linux Installation Directory

Folder icon /opt/novell/groupwise

Line SpacerGroupWise installation directory

Folder icon agents

Line SpacerLinux agent installation directory

Folder icon binPage icon gwmon

Line SpacerSubdirectory for GroupWise agent executables
Line SpacerMonitor Agent executable

Folder icon lib
Page icon *.so

Line SpacerSubdirectory for GroupWise agent library files
Line SpacerSupporting shared library files

Folder icon sharePage icon monitor.xml

Line SpacerSubdirectory for agent shared files
Line SpacerMonitor Agent configuration file

Folder icon gwmonitor

Line SpacerSubdirectory for Monitor Application files

Page icon gwmonitor.cfg
Folder icon default
Folder icon logs
Folder icon users

Line SpacerMonitor Application configuration file
Line SpacerSubdirectory for boilerplate configuration files
Line SpacerSubdirectory for Monitor Application log files
Line SpacerDirectory for Monitor users' session files

Folder icon /etc/init.d
Page icon grpwise-ma

Line SpacerStandard Linux location for application startup scripts
Line SpacerStartup script for the Monitor Agent

Folder icon rc3.d
Page icon S99grpwise-ma

Line SpacerStandard Linux location for run-level-3 symbolic links
Line SpacerSymbolic link to the startup script for the Monitor Agent

Folder icon rc5.d
Page icon S99grpwise-ma

Line SpacerStandard Linux location for run-level-5 symbolic links
Line SpacerSymbolic link to the startup script for the Monitor Agent

Folder icon /var/log/
Folder icon novell/groupwise

Line SpacerStandard Linux location for application log files
Line SpacerSubdirectory for GroupWise agent log files

Folder icon gwmon
Page icon mmddmon.nnn
Page icon mmddhist.nnn

Line SpacerSubdirectory for Monitor Agent log files
Line SpacerMonitor Agent event log files
Line SpacerMonitor Agent history log files


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 Monitor Agent" in "Monitor" in the GroupWise 6.5 Administration Guide.


lib directory

The lib directory holds GroupWise shared library files.


*.so files

These files are Linux shared library files that provide information to the Monitor Agent executable.


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.


gwmonitor directory

The gwmonitor directory holds files used by the Monitor Application.


gwmonitor.cfg file

The gwmonitor.cfg file holds the same configuration information that is stored on the Monitor Application object (named GroupWiseMonitor) in eDirectory. For more information, see "Configuring the Monitor Application" in "Monitor" in the GroupWise 6.5 Administration Guide.


default directory

The default directory holds boilerplate versions of the gwmonitor.cfg file and the monitor.xml file.


logs directory

The logs subdirectory holds Monitor Application log files. For more information, see "Modifying Monitor Application Log Settings" in "Monitor" in the GroupWise 6.5 Administration Guide.


users directory

The users subdirectory holds session files for Monitor users.


/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 Monitor Agent" in "Monitor" in the GroupWise 6.5 Administration 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 run level 3 (multi-user; boots to a text mode login prompt without The X Window System). The symbolic link to the grpwise-ma script is S99grpwise-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 run level 5 (multi-user; boots to The X Window System login dialog box). The symbolic link to the grpwise-ma script is S99grpwise-ma. It is created if you choose during installation to have the Monitor Agent start automatically when the server boots.


/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 6.5 Administration Guide.

The first two digits of the filename 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.


Windows Installation Directory

Folder icon c:\gwmon

Line SpacerWindows Monitor Agent installation directory

File icon gwenv1a.dll
File icon gwmon.exe
File icon monitor.xml

Line SpacerGroupWise Agent Engine
Line SpacerMonitor Agent program
Line SpacerMonitor Agent configuration file

File icon gwmonxx.dll
File icon gwsnmp.dll

Line SpacerMonitor Agent language information file
Line SpacerCustomized DLL program for SNMP

File icon x*10.dll
File icon gwmon.xml

Line SpacerXIS DLL programs
Line SpacerXIS agent configuration file

Folder icon monwork

Line SpacerMonitor Agent working directory

Additional Monitor files are integrated into your Web server to support the Monitor Web console. For an example, see Apache/Tomcat Installation.


c:\gwmon

On a Windows server, the Monitor Agent can be installed in any directory you choose. The default location is c:\gwmon. 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 "Starting the Monitor Agent" in "Monitor" in the GroupWise 6.5 Administration 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 6.5 Administration Guide.


gwmonxx.dll files

The gwmonxx.dll files contain all language-specific information for the WebAccess 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 of Agent Problems" in "Monitor" in the GroupWise 6.5 Administration Guide


x*10.dll files

The x*10.dll programs provide XIS capability for the GroupWise agents, so that you can create XML documents to monitor and change the agents as needed.


gwmon.xml file

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


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 6.5 Administration Guide