Agent Installation Directories
101
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 8 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 
8 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 Server Console” in “Post Office Agent” and “Using the MTA Server Console” in “Message 
Transfer Agent” in the GroupWise 8 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 GroupWise Agents in “Installing GroupWise 
Agents” in the GroupWise 8 Installation Guide.
x*5.nlm and gwxis12.nlm files
The 
x*5.nlm
and 
gwxis12.nlm
programs provide XIS capability for the GroupWise agents, so that 
you can create XML documents to monitor and change the agents as needed.
Change pdf to ppt - SDK software service:C# Create PDF from PowerPoint Library to convert pptx, ppt to PDF in C#.net, ASP.NET MVC, WinForms, WPF
Online C# Tutorial for Creating PDF from Microsoft PowerPoint Presentation
www.rasteredge.com
Change pdf to ppt - SDK software service:VB.NET Create PDF from PowerPoint Library to convert pptx, ppt to PDF in vb.net, ASP.NET MVC, WinForms, WPF
VB.NET Tutorial for Export PDF file from Microsoft Office PowerPoint
www.rasteredge.com
102
GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure
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
file 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 8 Administration Guide.
gwtmstmp.nlm file
If you use the GroupWise Target Service Agent (GWTSA) of the GroupWise Target Server Agent for 
File Systems (TSAFSGW) to back up your GroupWise system, the time stamping is an automatic part 
of the backup process. However, if you choose not to use one of these TSAs, you must still make sure 
that user databases are time-stamped so that items are not prematurely purged. The 
gwtmstmp.nlm
accomplishes this task. For more information, see “GroupWise Time Stamp Utility” in “Databases in 
the GroupWise 8 Administration Guide.
dbcopy.nlm file
The 
dbcopy.nlm
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 8 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 8 Administration Guide.
SDK software service:Online Convert PowerPoint to PDF file. Best free online export
Creating a PDF from PPTX/PPT has never been so easy! Web Security. Your PDF and PPTX/PPT files will be deleted from our servers an hour after the conversion.
www.rasteredge.com
SDK software service:How to C#: Convert PDF, Excel, PPT to Word
Convert Jpeg to PDF; Merge PDF Files; Split PDF Document; Remove Password from PDF; Change PDF Permission Settings. How to C#: Convert PDF, Excel, PPT to Word.
www.rasteredge.com
Agent Installation Directories
103
8.1.2
Linux Installation Directory
/opt/novell/groupwise/agents
Linux agent installation directory 
bin
gwpoa
gwmta
gwha
Subdirectory for GroupWise agent executables 
Post Office Agent (POA) executable 
Message Transfer Agent (MTA) executable 
GroupWise High Availability service executable 
gwpoa.xml
gwmta.xml
POA XIS configuration file 
MTA XIS configuration file 
strtupxx.poa
strtupxx.mta
Boilerplate POA startup file 
Boilerplate MTA startup file 
gwcsrgen
gwtmstmp
GroupWise Generate CSR utility 
GroupWise Time Stamp utility 
lib
gwpoaxxx.fil
gwmtaxxx.fil
Subdirectory for GroupWise agent library files 
POA language information file 
MTA language information file 
libpoa.so*
libpoa_ui.so*
libmta.so*
libmta_ui.so*
libgwha.so*
*.so*
POA shared library files 
POA shared library files for the optional user interface 
MTA-specific library files 
MTA-specific library files for the optional user interface 
GroupWise High Availability service library files 
Supporting library files 
image
Subdirectory for icon images 
share
post_office.poa
domain.mta
Subdirectory for agent shared files 
POA startup file for a specific post office 
MTA startup file for a specific domain 
agtcon
help
Subdirectory for agent console files 
Subdirectory agent console help files 
webcon
help
Subdirectory for agent Web console files 
Subdirectory for agent Web console help files 
gwcsrgen
help
Subdirectory for the GWCSRGEN utility files 
Subdirectory for GWCSRGEN utility help files 
/etc/init.d
grpwise
Standard Linux location for application startup scripts 
Startup script for the POA and MTA 
rc3.d
Snngrpwise
Standard Linux location for runlevel-3 symbolic links 
Symbolic link to the startup script for the POA and MTA 
rc5.d
Snngrpwise
Standard Linux location for runlevel-5 symbolic links 
Symbolic link to the startup script for the POA and MTA 
SDK software service:C# PDF Convert: How to Convert MS PPT to Adobe PDF Document
PDF; Merge PDF Files; Split PDF Document; Remove Password from PDF; Change PDF Permission Settings. C# PDF Convert: How to Convert MS PPT to Adobe PDF Document.
www.rasteredge.com
SDK software service:How to C#: Convert Word, Excel and PPT to PDF
Convert Jpeg to PDF; Merge PDF Files; Split PDF Document; Remove Password from PDF; Change PDF Permission Settings. How to C#: Convert Word, Excel and PPT to PDF
www.rasteredge.com
104
GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure
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 Linux Agents with a User Interface in “Installing GroupWise Agents” in the 
GroupWise 8 Installation 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 Linux Agents with a User Interface” in “Installing 
GroupWise Agents” in the GroupWise 8 Installation Guide.
gwha file
The 
gwha
file is the GroupWise High Availability service executable. If the POA or the MTA 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 8 Installation 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.
/etc/opt
novell/groupwise
gwha.conf
Standard Linux location for application configuration files 
Subdirectory for GroupWise configuration files 
GroupWise High Availability service configuration file 
agents
uid.conf
Subdirectory for GroupWise agents 
Agent configuration file for running as a non-root user 
/var/log/
novell/groupwise
Standard Linux location for application log files 
Subdirectory for GroupWise agent log files 
post_office.poa
mmddpoa.nnn
Post office-specific subdirectory for POA log files 
POA log files 
domain.mta
mmddmta.nnn
Domain-specific subdirectory for MTA log files 
MTA log files 
SDK software service:VB.NET PowerPoint: Process & Manipulate PPT (.pptx) Slide(s)
If you want to change the order of current processing control add-on can do PPT creating, loading powerful & profession imaging controls, PDF document, image to
www.rasteredge.com
SDK software service:C# TIFF: Learn to Convert MS Word, Excel, and PPT to TIFF Image
C# TIFF - Conversion from Word, Excel, PPT to TIFF. Learn How to Change MS Word, Excel, and PowerPoint to TIFF Image File in C#. Overview
www.rasteredge.com
Agent Installation Directories
105
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 Administration” in the 
GroupWise 8 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 8 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 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 8 Administration Guide.
SDK software service:VB.NET PowerPoint: Convert & Render PPT into PDF Document
VB.NET PowerPoint - Render PPT to PDF in VB.NET. What VB.NET demo code can I use for fast PPT (.pptx) to PDF conversion in .NET class application?
www.rasteredge.com
SDK software service:VB.NET PowerPoint: Read & Scan Barcode Image from PPT Slide
VB.NET PPT PDF-417 barcode scanning SDK to detect PDF-417 barcode image from PowerPoint slide. VB.NET APIs to detect and decode
www.rasteredge.com
106
GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure
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 8 Administration Guide.
agtcon directory
The 
agtcon
directory holds subdirectories and files used by the agent 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 8 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 8 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 8 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 Linux GroupWise Agents in “Installing a Basic 
GroupWise System” in the GroupWise 8 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 GroupWise 
Agents on System Startup” in “Installing GroupWise Agents” in the GroupWise 8 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 GroupWise Agents on System 
Startup” in “Installing GroupWise Agents” in the GroupWise 8 Installation Guide.
Agent Installation Directories
107
/etc/opt/novell/groupwise directory
The 
/etc/opt
directory is the standard location of application configuration files on Linux. 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 the GroupWise High Availability service configuration file. It is created 
automatically during installation and provides the 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 8 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 8 
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.
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 8 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, 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 8 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.
108
GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure
8.1.3
Windows Installation Directory
c:\Program Files\Novell\GroupWise\Agents
When you first install GroupWise Administration, the GroupWise agents are initially installed in 
platform-specific subdirectories in the 
agent
directory of 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 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 both GroupWise 
agents. It provides the following services to the agents: 
 Database management 
 File operations
 Message handling
c:\Program Files\Novell\GroupWise 
Server\Agents
Windows agent installation directory 
gwenv1a.dll
gwpoa.exe
gwmta.exe
GroupWise Agent Engine 
Post Office Agent (POA) program 
Message Transfer Agent (MTA) program 
strtupxx.poa
strtupxx.mta
post_office.poa
domain.mta
Boilerplate POA startup file 
Boilerplate MTA startup file 
Customized POA startup file 
Customized MTA startup file 
post_office.poa
domain.mta
POA startup file for a specific post office 
MTA startup file for a specific domain 
gwpoanxx.chm
gwmtanxx.chm
POA online help file 
MTA online help file 
gwpoanxx.dll
gwmtanxx.dll
POA language information files 
MTA language information files 
gwsnmp.dll
Customized DLL program for SNMP 
gwwww1.dll
Customized DLL program for MIME 
x*10a.dll
gwxis10.dll
XIS DLL programs 
GroupWise XIS DLL program 
agent.xml
XIS agent configuration files 
dbcopy.exe
GroupWise Database Copy program 
help
Subdirectory for GroupWise agent Web console help files 
Agent Installation Directories
109
 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 Windows GroupWise Agents in “Installing GroupWise Agents in 
the GroupWise 8 Installation 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 Windows GroupWise Agents” in “Installing GroupWise 
Agents” in the GroupWise 8 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 post_office.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 8 Administration Guide.
strtupxx.mta file domain.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 
8 Administration Guide.
110
GroupWise 8 Troubleshooting 3: Message Flow and Directory Structure
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 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*10a.dll and gwxis10.dll files
The 
x*10a.dll
and 
gwxis10.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.
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 8 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 8 Administration Guide.
8.2
Internet Agent Installation
 Section8.2.1, “NetWare Installation Directory,” on page110
 Section8.2.2, “Linux Installation Directory,” on page112
 Section8.2.3, “Windows Installation Directory,” on page116
8.2.1
NetWare Installation Directory
sys:\system
NetWare Internet Agent installation directory 
Documents you may be interested
Documents you may be interested