7.1 GroupWise Agent Installation (MTA, POA, and DVA)
The Message Transfer Agent (MTA), Post Office Agent (POA), and Document Viewer Agent (DVA) are always installed together. The agent installation directory differs depending on the platform where the agents are installed.
7.1.1 Linux MTA, POA, and DVA Installation Directory
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Linux agent 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.
gwmta file
The gwmta file is the MTA executable. You run this executable file to start the MTA. See Starting the Linux Agents with a User Interface
in Installing GroupWise Agents
in the GroupWise 2012 Installation Guide.
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 Linux Agents with a User Interface
in Installing GroupWise Agents
in the GroupWise 2012 Installation Guide.
gwdva file
The gwdva file is the Document Viewer Agent executable. You run this executable file to start the Document Viewer Agent. See Starting the Linux Agents with a User Interface
in Installing GroupWise Agents
in the GroupWise 2012 Installation Guide.
strtupxx.mta file
The strtupxx.mta file is the boilerplate file from which a domain-specific domain.mta file is created in the share directory. The xx in the startup file name represents a two-letter language code.
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 file name represents a two-letter language code.
strtup.dva file
The strtup.dva file is the boilerplate file from which a customizable gwdva.dva file is created in the share directory.
gwdca file
The gwdca file is the Document Converter Agent executable. The POA runs this executable file to start the Document Converter Agent. See Enabling the Document Viewer Agent (DVA) for Indexing
in Post Office Agent
in the GroupWise 2012 Administration GuideGroupWise 2012 Installation Guide.
gwha file
The gwha file is the GroupWise High Availability service executable. If the MTA, POA, or DVA goes down for any reason, the High Availability service automatically restarts it. See Enabling the GroupWise High Availability Service for the Linux GroupWise Agents
in Installing GroupWise Agents
in the GroupWise 2012 Installation Guide.
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 GroupWise agents. For more information about starting the agents, see Installing and Starting the Linux GroupWise Agents
in Installing a Basic GroupWise System
in the GroupWise 2012 Installation Guide.
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 Administration
in the GroupWise 2012 Administration Guide.
gwtmstmp file
The gwtmstmp file is the GroupWise Time Stamp utility. If you deselect 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 2012 Administration Guide.
lib directory
The lib directory holds GroupWise library files.
*.fil files
These files contain all language-specific information for the MTA and the POA. The first five characters of the file name 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 server consoles and Web consoles.
domain.mta file
The MTA startup file contains 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 switch automatically set to the domain directory the MTA will service. See Using MTA Startup Switches
in Message Transfer Agent
in the GroupWise 2012 Administration Guide.
post_office.poa file
The POA startup file contains 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 switch automatically set to the post office directory the POA will service. See Using POA Startup Switches
in Post Office Agent
in the GroupWise 2012 Administration Guide.
gwdva.dva file
The DVA startup file contains switches for the DVA. No switches are set during installation. DVA configuration must be performed after installation, as described in Configuring the DVA
in Document Viewer Agent
in the GroupWise 2012 Administration Guide.
agtcon directory
The agtcon directory holds subdirectories and files used by the agent server consoles, such as help files. See Using the POA Server Console
in Post Office Agent
and Using the MTA Server Console
in Message Transfer Agent
in the GroupWise 2012 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 2012 Administration Guide.
gwcsrgen directory
The gwcsrgen directory holds subdirectories and files used by the GroupWise Generate CSR (GWCSRGEN) utility, such as help files. See Generating a Certificate Signing Request
in Security Administration
in the GroupWise 2012 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 GroupWise agents. For more information about starting the agents, see Installing and Starting the Linux GroupWise Agents
in Installing a Basic GroupWise System
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 script is Snngrpwise. It is created if you choose during installation to have the agents start automatically when the server boots. See Starting the Linux Agents on System Startup
in Installing GroupWise Agents
in the GroupWise 2012 Installation 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 runlevel 5 (multi-user; boots to the X Window System login dialog box). The symbolic link to the grpwise script is Snngrpwise. It is created if you choose during installation to have the agents start automatically when the server boots. See Starting the Linux Agents on System Startup
in Installing GroupWise Agents
in the GroupWise 2012 Installation Guide.
/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.
/etc/opt/novell/groupwise directory
The /etc/opt directory is the standard Linux location for application configuration files. Files that configure how the GroupWise agents interact with Linux are stored in the novell/groupwise subdirectory.
gwha.conf file
The gwha.conf file is on of the configuration files for the GroupWise High Availability service (gwha). It is created automatically during installation and provides information necessary for the High Availability service to restart the GroupWise agents if they go down unexpectedly. See Enabling the GroupWise High Availability Service for the Linux GroupWise Agents
in Installing GroupWise Agents
in the GroupWise 2012 Installation Guide.
uid.conf file
The uid.conf file configures the GroupWise agents to run as a non-root user. See Running the Linux GroupWise Agents as a Non-root User
in Installing GroupWise Agents
in the GroupWise 2012 Installation Guide.
/etc/xinetd.d directory
The /etc/xinetd.d directory is the standard Linux location for configuration files for services controlled by the Extended Internet Services daemon.
gwha file
The gwha file is one of the configuration files for the GroupWise High Availability service (gwha). It is created automatically during installation and provides information necessary for the High Availability service to restart the GroupWise agents if they go down unexpectedly. See Enabling the GroupWise High Availability Service for the Linux GroupWise Agents
in Installing GroupWise Agents
in the GroupWise 2012 Installation 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.
domain.mta directory
The domain.mta directory is a domain-specific location for MTA log files.
Within the domain.mta directory, the 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 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 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.
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 2012 Administration Guide guide.
The first two digits of the file name 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.
gwdva directory
The gwdva directory holds DVA log files.
Within the gwdva directory, the DVA creates log files (mmdddva.nnn) to inform you of its processing and any problems it encounters. For more information about log files, see Using DVA Log Files
in Document Viewer Agent
in the GroupWise 2012 Administration Guide guide.
The first two digits of the file name 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, 0518dva.002 is the second DVA log file created on May 18.
gwdca directory
The gwdca directory holds DCA log files.
Within the gwdca directory, the DCA creates log files (mmdddca.nnn) to inform you of its processing and any problems it encounters. For more information about the DCA, see Configuring the Document Converter Agent (DCA)
in Post Office Agent
in the GroupWise 2012 Administration Guide guide.
The first two digits of the file name 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, 0518dva.002 is the second DVA log file created on May 18.
7.1.2 Windows MTA, POA, and DVA Installation Directory
|
|
|
|
|
|
|
|
|
|
|
|
|
c:\Program Files\Novell\GroupWise\Agents
On a Windows server, the GroupWise agents can be installed in any directory you choose. The default is c:\Program Files\Novell\GroupWise\Agents. 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 the MTA, POA, and DVA. 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.
gwmta.exe file
The gwmta.exe file is the MTA program. You run this executable file to start the MTA. See Starting the Windows GroupWise Agents
in Installing GroupWise Agents
in the GroupWise 2012 Installation Guide.
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 Windows GroupWise Agents
in Installing GroupWise Agents
in the GroupWise 2012 Installation Guide.
gwdva.exe file
The gwdva.exe file is the Document Viewer Agent executable. You run this executable file to start the Document Viewer Agent. See Starting the Windows GroupWise Agents
in Installing GroupWise Agents
in the GroupWise 2012 Installation Guide.
gwdca.exe file
The gwdca.exe file is the Document Converter Agent executable. The POA runs this executable file to start the Document Converter Agent. See Enabling the Document Viewer Agent (DVA) for Indexing
in Post Office Agent
in the GroupWise 2012 Administration GuideGroupWise 2012 Installation 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 and post_office.poa file
The POA startup file contains 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 file name 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 switch automatically set to the post office directory the POA will service. See Using POA Startup Switches
in Post Office Agent
in the GroupWise 2012 Administration Guide.
strtupxx.mta file and domain.mta file
The MTA startup file contains 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 file name 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 switch automatically set to the domain directory the MTA will service. See Using MTA Startup Switches
in Message Transfer Agent
in the GroupWise 2012 Administration Guide.
strtup.dva file and gwdva.dva file
The strtup.dva file is the boilerplate file from which a customizable gwdva.dva file is created. No switches are set during installation. DVA configuration must be performed after installation, as described in Configuring the DVA
in Document Viewer Agent
in the GroupWise 2012 Administration Guide.
agentnxx.chm files
The .chm files contain the online documentation for the agents. 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 file name 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.
dbcopy.exe file
The dbcopy.exe file is the GroupWise Database Copy utility, which copies files from a live GroupWise post office or domain to a static location for backup. During the copy process, DBCopy prevents the files from being modified, using the same locking mechanism used by other GroupWise programs that access databases. This ensures that the backed-up versions are consistent with the originals even when large databases take a substantial amount of time to copy. For more information, see GroupWise Database Copy Utility
in Databases
in the GroupWise 2012 Administration Guide.
gwtmstmp.exe file
The gwtmstmp.exe file is the GroupWise Time Stamp utility. If you deselect 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 2012 Administration Guide.
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 2012 Administration Guide.
7.1.3 DVA Working Directory
The Document Viewer Agent (DVA) creates its working directory as a subdirectory of its installation directory. The default location varies by platform:
|
Linux: |
/opt/novell/groupwise/agents/bin/gwdva.dir |
|
Windows: |
c:\Program Files\Novell\GroupWise Server\Agents\gwdva.dir |
You can specify the location for the DVA working directory using the --home switch. See Setting the DVA Home Directory
in Document Viewer Agent
in the GroupWise 2012 Administration Guide.
|
gwdva.dir directory
The gwdva.dir directory is the working directory for the Document Viewer Agent.
gwdva.ste files
The gwdvannn.ste files hold state information about each DVA worker thread. To control the number of worker threads, see Controlling Thread Usage
in Document Viewer Agent
in the GroupWise 2012 Administration Guide.
quarantine directory
The quarantine directory contains document files that cannot be converted to HTML format, so that they can be examined manually if necessary. See Enabling the DVA Document Quarantine
in Document Viewer Agent
in the GroupWise 2012 Administration Guide.
log directory (Windows only)
The log directory stores log files produced by the Document Viewer Agent. See Using DVA Log Files
in Document Viewer Agent
in the GroupWise 2012 Administration Guide.
NOTE:On Linux, DVA log files are stored in the typical location for log files on Linux (/var/log/novell/groupwise/gwdva), rather than in the gwdva.dir directory.
temp directory
The temp directory is used for the temporary files created during HTML conversion.
template directory
The template directory holds the HTML template file that the DVA uses when converting document files into HTML format.