GroupWise Agent Installation (POA and MTA)

The Post Office Agent (POA) and the Message Transfer Agent (MTA) are always installed together. The agent installation directory differs depending on the platform where the agents are installed.


NetWare Installation Directory

Folder icon sys:\system

Line SpacerNetWare® agent installation directory

File icon gwenn4.nlm
File icon gwpoa.nlm
File icon gwmta.nlm

Line SpacerGroupWise® 6.5 Agent Engine
Line SpacerPost Office Agent (POA) program
Line SpacerMessage Transfer Agent (MTA) program

File icon strtupxx.poa
File icon strtupxx.mta

Line SpacerBoilerplate POA startup file
Line SpacerBoilerplate MTA startup file

File icon post_office.poa
File icon domain.mta

Line SpacerPOA startup file for a specific post office
Line SpacerMTA startup file for a specific domain

File icon gwpoanxx.hlpFile icon gwmtanxx.hlp

Line SpacerPOA online help files
Line SpacerMTA online help files

File icon gwpoanxx.filFile icon gwmtanxx.fil

Line SpacerPOA language information files
Line SpacerMTA language information files

File icon grpwise.ncf

Line SpacerAgent load file

File icon x*10.nlm

Line SpacerXIS NLMTM programs

File icon agent.xml

Line SpacerXIS agent configuration files

File icon gwtsa.nlm
File icon gwtsaxx.fil
File icon gwtsa.ncf

Line SpacerGroupWise Target Service Agent (GWTSA) program
Line SpacerGWTSA language information files
Line SpacerGWTSA load file

File icon gwtmstmp.nlm

Line SpacerGroupWise Time Stamp program

Folder icon help

Line SpacerSubdirectory for GroupWise agent Web console help files


NetWare agent installation directory

When you first install GroupWise Administration, the GroupWise agents are initially installed in platform-specific subdirectories in the agent directory in the software distribution directory. However, the agents cannot be run from this initial location. They must be installed on the servers where they will run.

On a NetWare® server, the GroupWise agents are typically installed in the sys:\system directory. You can choose a different location during installation.


gwenn4.nlm file

The gwenn4.nlm file is the GroupWise 6 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 loaded on a server automatically loads the GroupWise Agent Engine.


gwpoa.nlm file

The gwpoa.nlm file is the Post Office Agent program. You load this NLM program to start the Post Office Agent. See "Starting the POA" in "Post Office Agent" in the GroupWise 6.5 Administration Guide.


gwmta.nlm file

The gwmta.nlm is the Message Transfer Agent program. You load this NLM program to start the Message Transfer Agent. See "Starting the MTA" in "Message Transfer Agent" in the GroupWise 6.5 Administration Guide.


strtupxx.poa file

The POA startup file contains startup switches for the POA. Switch settings placed in the POA startup file override comparable options set for the POA in ConsoleOne®. The xx in the startup filename represents a two-letter language code.

During installation, a customized version of the POA startup file, named post_office.POA, is created. This customized version has the /home startup switch automatically set to the post office directory the POA will service. See "Using POA Startup Switches" in "Post Office Agent" in the GroupWise 6.5 Administration Guide.


strtupxx.mta file

The MTA startup file contains startup switches for the MTA. Switch settings placed in the MTA startup file override comparable options set for the MTA in ConsoleOne. The xx in the startup filename represents a two-letter language code.

During installation, a customized version of the MTA startup file, named domain.MTA, is created. This customized version has the /home startup switch automatically set to the domain directory the MTA will service. See "Using MTA Startup Switches" in "Message Transfer Agent" in the GroupWise 6.5 Administration Guide.


nlm_agentnxx.hlp files

Online help is available by pressing F1 at the agent console on the server where it runs. See "Using the POA Agent Console" in "Post Office Agent" and "Using the MTA Agent Console" in "Message Transfer Agent" in the GroupWise 6.5 Administration Guide

The first five characters of the filename are the agent name. The digit n is a version number. The last two characters xx are a language code.


nlm_agentnxx.fil files

These files contain all language-specific information for the POA and the MTA. The first five characters of the filename are the agent name. The digit n is a version number. The last two characters xx are a language code.


grpwise.ncf file

The grpwise.ncf file is the NetWare configuration file that automatically loads the agents whenever the server is restarted. A typical grpwise.ncf file would look similar to the following:

load sys:\system\gwmta.nlm @corpdom.mta  
load sys:\system\gwpoa.nlm @acctpo.poa

For more information, see "Starting the NetWare POA" in "Post Office Agent" and "Starting the NetWare MTA" in "Message Transfer Agent" in the GroupWise 6.5 Administration Guide.


x*10.nlm files

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


nlm_agent.xml files

The nlm_agent.xml files are specialized agent configuration files for use in the XIS environment.


gwtsa.nlm file

The gwtsa.nlm is the GroupWise Target Service Agent (GWTSA), which provides reliable backups of a running GroupWise system by successfully backing up open files and locked files, rather than skipping them as some backup software does. For more information, see "GroupWise Target Service Agent " in "Databases" in the GroupWise 6.5 Administration Guide.


gwtmstmp.nlm file

If you use the GroupWise Target Service Agent (GWTSA) to back up your GroupWise system, the time stamping is an automatic part of the backup process. However, if you choose not to use the GWTSA, you must still make sure that user databases are time-stamped so that items will not be prematurely purged. The gwtmstmp.nlm accomplishes this task. For more information, see "GroupWise Time Stamp Utility" in "Databases" in the GroupWise 6.5 Administration Guide.


gwtsaxx.fil file

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


gwtsa.ncf file

The gwtsa.ncf file is the NetWare configuration file that automatically loads the GWTSA whenever the server is restarted. A typical gwtsa.ncf file would look similar to the following:

load sys:\system\smdr  
load sys:\system\gwtsa /home-sys:\gwsystem\corpdom
/home-sys:\gwsystem\acctpo


help directory

The help directory contains language-specific subdirectories for the help files available from the POA and MTA Web consoles. See "Using the POA Web Console" in "Post Office Agent" and "Using the MTA Web Console" in "Message Transfer Agent" in the GroupWise 6.5 Administration Guide.


Linux Installation Directory

Folder icon /opt/novell/groupwise/agents

Line SpacerLinux agent installation directory

Folder icon binPage icon gwpoa
Page icon gwmta

Line SpacerSubdirectory for GroupWise agent executables
Line SpacerPost Office Agent (POA) executable
Line SpacerMessage Transfer Agent (MTA) executable

Page icon gwpoa.xml
Page icon gwmta.xml

Line SpacerPOA XIS configuration file
Line SpacerMTA XIS configuration file

Page icon strtupxx.poa
Page icon strtupxx.mta

Line SpacerBoilerplate POA startup file
Line SpacerBoilerplate MTA startup file

Page icon gwcsrgen
Page icon gwtmstmp

Line SpacerGroupWise Generate CSR utility
Line SpacerGroupWise Time Stamp utilityLine Spacer

Folder icon lib
Page icon gwpoaxxx.fil
Page icon gwmtaxxx.fil

Line SpacerSubdirectory for GroupWise agent library files
Line SpacerPOA language information file
Line SpacerMTA language information file

Page icon libpoa.so*
Page icon libpoa_ui.so*
Page icon libmta.so*
Page icon libmta_ui.so*
Page icon *.so*

Line SpacerPOA shared library files
Line SpacerPOA shared library files for the optional user interface
Line SpacerMTA-specific library files
Line SpacerMTA-specific library files for the optional user interface
Line SpacerSupporting library files

Folder icon image

Line SpacerSubdirectory for icon images

Folder icon sharePage icon post_office.poa
Page icon domain.mta

Line SpacerSubdirectory for agent shared files
Line SpacerPOA startup file for a specific post office
Line SpacerMTA startup file for a specific domain

Folder icon agtcon
Folder icon help

Line SpacerSubdirectory for agent console files
Line SpacerSubdirectory agent console help files

Folder icon webcon
Folder icon help

Line SpacerSubdirectory for agent Web console files
Line SpacerSubdirectory for agent Web console help files

Folder icon /etc/init.d
Page icon grpwise

Line Spacer Standard Linux location for application startup scripts
Line Spacer Startup script for the POA and MTA

Folder icon rc3.d
Page icon S99grpwise

Line Spacer Standard Linux location for run-level-3 symbolic links
Line Spacer Symbolic link to the startup script for the POA and MTA

Folder icon rc5.d
Page icon S99grpwise

Line Spacer Standard Linux location for run-level-5 symbolic links
Line Spacer Symbolic link to the startup script for the POA and MTA

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 post_office.poa
Page icon mmddpoa.nnn

Line SpacerPost office-specific subdirectory for POA log files
Line SpacerPOA log files

Folder icon domain.mta
Page icon mmddmta.nnn

Line SpacerDomain-specific subdirectory for MTA log files
Line Spacer MTA log files

Folder icon /var/opt/novell/groupwise/log
Page icon mmddlog.nnn

Line SpacerLocation for script log files
Line Spacer Log file for the agent startup script (grpwise)


agents directory

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


bin directory

The bin directory holds GroupWise executable files.


gwpoa file

The gwpoa file is the Post Office Agent executable. You run this executable file to start the Post Office Agent. See "Starting the POA" in "Post Office Agent" in the GroupWise 6.5 Administration Guide.


gwmta file

The gwmta file is the Message Transfer Agent executable. You run this executable file to start the Message Transfer Agent. See "Starting the MTA" in "Message Transfer Agent" in the GroupWise 6.5 Administration Guide.


*.xml files

The agent.xml files are specialized agent configuration files for use in the XIS environment.


strtupxx.poa file

The strtupxx.poa file is the boilerplate file from which a post office-specific post_office.poa file is created in the share directory. The xx in the startup filename represents a two-letter language code.


strtupxx.mta file

The strtupxx.mta file is the boilerplate file from which a domain-specific domain.poa file is created in the share directory. The xx in the startup filename represents a two-letter language code.


gwcsrgen file

The gwcsrgen file is the GroupWise Generate CSR utility. If you enable SSL for the agents, they need access to a server certificate and private key. You can use the GroupWise Generate CSR utility (GWCSRGEN) to generate a Certificate Signing Request (CSR) file and a Private Key file. For more information, see "Server Certificates and SSL Encryption" in "Security" in the GroupWise 6.5 Administration Guide.


gwtmstmp file

The gwtmstmp file is the GroupWise Time Stamp utility. If you deselect Allow Purge of Items Not Backed Up in ConsoleOne, user databases (userxxx.db) must be time-stamped every time a backup is performed so that items can be purged only after being backed up. You can use the GroupWise Time Stamp (GWTMSTMP) utility to ensure that GroupWise user databases include the dates when they were last backed up, restored, and retained. For more information, see "GroupWise Time Stamp Utility" in "Databases" in the GroupWise 6.5 Administration Guide.


lib directory

The lib directory holds GroupWise library files.


*.fil files

These files contain all language-specific information for the POA and the MTA. The first five characters of the filename are the agent name. The last two characters xx are a language code.


*.so* files

These files are Linux library files that provide information to the GroupWise agent executables.


image directory

The image directory has subdirectories for agent icons for both color and monochrome displays.


share directory

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


post_office.poa

The POA startup file contains startup switches for the POA. Switch settings placed in the POA startup file override comparable options set for the POA in ConsoleOne.

During installation, a customized version of the strtupxx.poa file, named post_office.poa, is created in the share directory. This customized version has the --home startup switch automatically set to the post office directory the POA will service. See "Using POA Startup Switches" in "Post Office Agent" in the GroupWise 6.5 Administration Guide.


domain.mta

The MTA startup file contains startup switches for the MTA. Switch settings placed in the MTA startup file override comparable options set for the MTA in ConsoleOne.

During installation, a customized version of the strtupxx.mta file, named domain.mta, is created in the share directory. This customized version has the --home startup switch automatically set to the domain directory the MTA will service. See "Using MTA Startup Switches" in "Message Transfer Agent" in the GroupWise 6.5 Administration Guide.


agtcon directory

The agtcon directory holds subdirectories and files used by the agent consoles, such as help files. See "Using the POA Agent Console" in "Post Office Agent" and "Using the MTA Agent Console" in "Message Transfer Agent" in the GroupWise 6.5 Administration Guide.


webcon directory

The webcon directory holds subdirectories and files used by the agent Web consoles, such as help files. See "Using the POA Web Console" in "Post Office Agent" and "Using the MTA Web Console" in "Message Transfer Agent" in the GroupWise 6.5 Administration Guide.


/etc/init.d directory

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


grpwise file

The grpwise script is created automatically during installation. You can use the script to start, restart, stop, and display status information about the POA and MTA. For more information about starting the agents, see "Installing and Starting the GroupWise Linux Agents" in "Installing a Basic GroupWise System" in the GroupWise 6.5 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 run level 3 (multi-user; boots to a text mode login prompt without The X Window System). The symbolic link to the grpwise script is S99grpwise. It is created if you choose during installation to have the agents start automatically when the server boots. See "Starting the Linux POA" in "Post Office Agent" and "Starting the Linux MTA" in "Message Transfer Agent" in the GroupWise 6.5 Administration Guide.


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 script is S99grpwise. It is created if you choose during installation to have the agents start automatically when the server boots. See "Starting the Linux POA" in "Post Office Agent" and "Starting the Linux MTA" in "Message Transfer Agent" in the GroupWise 6.5 Administration Guide.


/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.


post_office.poa directory

The post_office.poa directory is a post office-specific location for POA log files.

Within the post_office.poa directory, the POA creates log files (mmddpoa.nnn) to inform you of its processing and any problems it encounters. For more information about log files, see "Using POA Log Files" in "Post Office Agent" in the GroupWise 6.5 Administration Guide guide.

The first two digits of the filename represent the month, the next two digits represent the day of the month, and the next three characters indicate what program created the log. The three-digit extension is a sequence number for multiple log files created on the same day. For example, 0518poa.002 is the second POA log file created on May 18.


domain.mta directory

The domain.mta directory is a domain-specific location for MTA log files.

Within the domain.mta directory, MTA creates log files (mmddxxx.nnn) to inform you of its processing and any problems it encounters. For more information about log files, see "Using MTA Log Files" in "Message Transfer Agent" 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 next three characters indicate what program created the log. The three-digit extension is a sequence number for multiple log files created on the same day. For example, 0518mta.002 is the second MTA log file created on May 18.


/var/opt/novell/groupwise/log directory

The /var directory is used for various types of files. The log file for the agent startup script is created in the opt/novell/groupwise/log subdirectory.


mmddlog.nnn

The mmddlog.nnn file stores messages from the agent startup script (grpwise) as it tries to start the GroupWise agents.


Windows Installation Directory

Folder icon c:\grpwise

Line SpacerWindows agent installation directory

File icon gwenv1a.dll
File icon gwpoa.exe
File icon gwmta.exe

Line SpacerGroupWise Agent Engine
Line SpacerPost Office Agent (POA) program
Line SpacerMessage Transfer Agent (MTA) program

File icon strtupxx.poa
File icon strtupxx.mta

Line SpacerBoilerplate POA startup file [need post.poa]
Line SpacerBoilerplate MTA startup file [need domain.mta]

File icon post_office.poa
File icon domain.mta

Line SpacerPOA startup file for a specific post office
Line SpacerMTA startup file for a specific domain

File icon gwpoanxx.chm
File icon gwmtanxx.chm

Line SpacerPOA online help file
Line SpacerMTA online help file

File icon gwpoanxx.dll
File icon gwmtanxx.dll

Line SpacerPOA language information files
Line SpacerMTA language information files

File icon gwsnmp.dll

Line SpacerCustomized DLL program for SNMP

File icon gwwww1.dll

Line SpacerCustomized DLL program for MIME

File icon x*10.dll

Line SpacerXIS DLL programs

File icon agent.xml

Line SpacerXIS agent configuration files

Folder icon help

Line SpacerSubdirectory for GroupWise agent Web console help files


c:\grpwise

When you first install GroupWise Administration, the GroupWise agents are initially installed in platform-specific subdirectories in the agent directory. However, the agents cannot be run from this initial location. They must be installed on the servers where they will run.

On a Windows server, the GroupWise agents can be installed in any directory you choose. The default is c:\grpwise. The agent icons are 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 both 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.


gwpoa.exe file

The gwpoa.exe file is the Post Office Agent program. You run this executable file to start the Post Office Agent. See "Starting the POA" in "Post Office Agent" in the GroupWise 6.5 Administration Guide.


gwmta.exe file

The gwmta.exe file is the Message Transfer Agent program. You run this executable file to start the Message Transfer Agent. See "Starting the MTA" in "Message Transfer Agent" in the GroupWise 6.5 Administration Guide.


gwsnmp.dll file

The gwsnmp.dll file provides interaction with the Windows SNMP Service, so that you can monitor the GroupWise agents using an SNMP monitoring program.


gwwww1.dll file

The gwwww1.dll file provides parsing of MIME messages received from the Internet.


strtupxx.poa file

The POA startup file contains startup switches for the POA. Switch settings placed in the POA startup file override comparable options set for the POA in ConsoleOne. The xx in the startup filename represents a two-letter language code.

During installation, a customized version of the POA startup file, named post_office.poa, is created. This customized version has the /home startup switch automatically set to the post office directory the POA will service. See "Using POA Startup Switches" in "Post Office Agent" in the GroupWise 6.5 Administration Guide.


strtupxx.mta file

The MTA startup file contains startup switches for the MTA. Switch settings placed in the MTA startup file override comparable options set for the MTA in ConsoleOne. The xx in the startup filename represents a two-letter language code.

During installation, a customized version of the MTA startup file, named domain.MTA, is created. This customized version has the /home startup switch automatically set to the domain directory the MTA will service. See "Using MTA Startup Switches" in "Message Transfer Agent" in the GroupWise 6.5 Administration Guide.


agentnxx.chm files

Online Help is available by clicking Help in the agent consoles on the server where the agents are running. In addition, dialog boxes have a Help button for context-sensitive Help.

The first five characters of the filename are the agent name. The digit n is a version number. The last two characters xx are a language code.


agentnxx.dll files

The agentnxx.dll files contain all language-specific information for the agents. The digit n is a version number. The last two characters xx are a language code.


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.


agent.xml files

The agent.xml files are specialized agent configuration files for use in the XIS environment.


help directory

The help directory contains language-specific subdirectories for the help files available from the POA and MTA Web consoles. See "Using the POA Web Console" in "Post Office Agent" and "Using the MTA Web Console" in "Message Transfer Agent" in the GroupWise 6.5 Administration Guide.