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
NetWare® agent installation directory
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
|
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.
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
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.
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.