8.3 WebAccess Agent Installation
8.3.1 NetWare Installation Directory
|
|
|
|
|
|
|
|
|
|
|
|
|
NetWare WebAccess Agent installation directory
Additional WebAccess files are integrated into your Web server to support the WebAccess client and the WebAccess Agent Web console. See Section 9.0, Web Application Installation Directories on Your Web Server. See also Section 7.4, WebAccess Agent Queue Directory.
NetWare WebAccess Agent installation directory
On a NetWare server, the GroupWise WebAccess Agent is typically installed in the sys:\system directory. You can choose a different location during installation.
gwenn5.nlm file
The gwenn5.nlm file is the GroupWise 8 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.
gwinter.nlm file
The gwinter.nlm file is the WebAccess Agent program.
gwdva.nlm file
The gwdva.nlm file is the Document Viewer Agent program.
strtweb.ncf file
The strtweb.ncf file is the NetWare configuration file that automatically loads the WebAccess Agent whenever the server is restarted. A typical strtweb.ncf file would look similar to the following:
load sys:\system\gwinter @webac80a.waa
It includes the WebAccess Agent startup file in the load command. For more information, see Starting GroupWise WebAccess
in Installing GroupWise WebAccess
in the GroupWise 8 Installation Guide.
stopweb.ncf
The stopweb.ncf file is the NetWare configuration file that unloads the WebAccess Agent. A typical stopweb.ncf file would look similar to the following:
unload gwinter
webac80a.waa file
The WebAccess Agent startup file contains startup switches for the WebAccess Agent. Switch settings placed in the WebAccess Agent startup file override comparable options set for the WebAccess Agent in ConsoleOne. The startup file is named the same as the WebAccess Agent object in ConsoleOne. The default is webac80a.
During installation, a customized version of the WebAccess Agent startup file is created. This customized version has the /home startup switch automatically set to the domain directory where the WebAccess Agent’s queue directories are located. See Using WebAccess Startup Switches
in WebAccess
in the GroupWise 8 Administration Guide.
gwdva.dva file
The gwdva.dva file is the Document Viewer Agent startup file. The Viewer Agent is currently configured completely by startup switches. For more information, see Document Viewer Agent Startup Switches
.
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.
gwinter.xml file
The gwinter.xml file is a specialized WebAccess Agent configuration file for use in the XIS environment.
cache\template\xx directory
The cache\template\xx directory holds language-specific HTML template files that the WebAccess Agent passes to the Document Viewer Agent for viewing documents in documents in WebAccess and WebPublisher. The xx is a two-letter language code.
gwdva.dir directory
help directory
The help directory holds help files and images used by the WebAccess Agent Web console. See Using the WebAccess Agent Web Console
in WebAccess
in the GroupWise 8 Administration Guide.
8.3.2 Linux Installation Directory
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Additional WebAccess files are integrated into your Web server to support the WebAccess client and the WebAccess Agent Web console. See Section 9.0, Web Application Installation Directories on Your Web Server. See also Section 7.4, WebAccess Agent Queue Directory.
agents directory
On a Linux server, the WebAccess Agent is always installed in subdirectories of /opt/novell/groupwise/agents.
bin directory
The bin directory holds GroupWise executable files.
gwinter file
The gwinter file is the WebAccess Agent executable. You run this executable file to start the WebAccess Agent. See Linux: Setting Up GroupWise WebAccess
in Installing GroupWise WebAccess
in the GroupWise 8 Installation Guide.
gwinter.xml file
The gwinter.xml file is a specialized configuration file for use in the XIS environment.
webac80axx.waa file
The webac80axx.waa file is the boilerplate file from which a domain-specific webac80a.waa file is created in the share directory. The webac80a represents the name of the WebAccess Agent object in eDirectory. The xx represents a two-letter language code.
template\xx directory
The template\xx directory holds language-specific HTML template files that the WebAccess Agent passes to the Document Viewer Agent for viewing documents in WebAccess and WebPublisher. The xx is a two-letter language code.
gwdva file
The gwdva file is the Document Viewer Agent executable. The WebAccess Agent starts and stops the Viewer Agent automatically whenever it starts and stops.
gwdva.dir directory
lib directory
The lib directory holds GroupWise shared library files.
*.so files
The *.so files are Linux shared library files that provide information to the WebAccess Agent executable.
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.
webac80a.waa file
The WebAccess Agent startup file contains startup switches for the WebAccess Agent. Switch settings placed in the WebAccess Agent startup file override comparable options set for the WebAccess Agent in ConsoleOne. The startup file is named the same as the WebAccess Agent object in ConsoleOne. The default is webac80a.
During installation, a customized version of the WebAccess Agent startup file is created. This customized version has the /home startup switch automatically set to the domain directory where the WebAccess Agent’s queue directories are located. See Using WebAccess Startup Switches
in WebAccess
in the GroupWise 8 Administration Guide.
gwdva.dva file
The gwdva.dva file is the Document Viewer Agent startup file. The Viewer Agent is currently configured completely by startup switches. For more information, see Document Viewer Agent Startup Switches
.
webcon directory
The webcon directory holds subdirectories and files used by the agent Web consoles, such as help files.
/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 WebAccess Agent. For more information about starting the WebAccess Agent, see Linux: Setting Up GroupWise WebAccess
in Installing GroupWise WebAccess
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 WebAccess 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 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 WebAccess 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.
domain.webac80a directory
The domain.webac80a directory is a domain-specific location for WebAccess Agent log files.
000.prc directory
Within the 000.prc directory, the WebAccess Agent creates log files (mmddweb.nnn) to inform you of its processing and any problems it encounters. For more information about log files, see Controlling WebAccess Agent Logging
in WebAccess
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 three-digit extension is a sequence number for multiple log files created on the same day. For example, 0518web.002 is the second WebAccess Agent log file created on May 18.
gwdva directory
The gwdva directory stores Viewer Agent log files. 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, 0518web.002 is the second Viewer Agent log file created on May 18.
8.3.3 Windows Installation Directory
|
|
|
|
|
|
|
|
|
|
|
|
|
Additional WebAccess files are integrated into your Web server to support the WebAccess client and the WebAccess Agent Web console. See Section 9.0, Web Application Installation Directories on Your Web Server. See also Section 7.4, WebAccess Agent Queue Directory.
c:\Program Files\Novell\GroupWise Server\WebAccess
On a Windows server, the WebAccess Agent can be installed in any directory you choose. The default location is c:\Program Files\Novell\GroupWise Server\WebAccess. The WebAccess 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.
gwinter.exe file
The gwinter.exe file is the WebAccess Agent program.
strtweb.bat file
The strtweb.bat file is used to start the WebAccess Agent. The batch file specifies the WebAccess startup file. A typical strtweb.bat file includes the following:
title Novell GroupWise WebAccess @echo off cls gwinter.exe @webac80a.waa
You run this batch file to start the WebAccess Agent. See Starting GroupWise WebAccess
in Installing GroupWise WebAccess
in the GroupWise 8 Installation Guide.
webac80a.waa file
The WebAccess Agent startup file contains startup switches for the WebAccess Agent. Switch settings placed in the WebAccess Agent startup file override comparable configuration options set for the WebAccess Agent in ConsoleOne. The startup file is named the same as the WebAccess Agent object in eDirectory. The default is webac80a.
During installation, the WebAccess Agent startup file is created with the /home startup switch automatically set to the domain directory where the WebAccess Agent queue directory (domain\wpgate\webac80a) is located. See Using WebAccess Startup Switches
in WebAccess
in the GroupWise 8 Administration Guide.
gwdva.exe file
The gwdva.exe file is the Document Viewer Agent program. The WebAccess Agent automatically starts and stops the Viewer Agent whenever the WebAccess Agent starts and stops.
gwdva.dva file
The gwdva.dva file is the Document Viewer Agent startup file. The Viewer Agent is currently configured completely by startup switches. See Document Viewer Agent Startup Switches
.
gwdva.dir directory
gwwanxx.dll files
The gwwanxx.dll files contain all language-specific information for the WebAccess Agent. The digit n is a version number. The last two characters xx are a language code.
gwwasnmp.dll file
The gwwasnmp.dll file provides interaction with the Windows SNMP Service, so that you can monitor the WebAccess Agent using an SNMP monitoring program. This file is not installed unless you enable SNMP during installation. It cannot be installed if the SNMP Service is not installed on the Windows server.
gwwww1.dll file
The gwwww1.dll file provides parsing of MIME messages received from the Internet.
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.
gwinter.xml file
The gwia.xml file is a specialized agent configuration file for use in the XIS environment.
cache\template\xx directory
The cache\template\xx directory holds language-specific HTML template files that the WebAccess Agent passes to the Document Viewer Agent for viewing documents in WebAccess and WebPublisher. The xx is a two-letter language code.
help directory
The help directory holds help files and images used by the WebAccess Agent Web console. See Using the WebAccess Agent Web Console
in WebAccess
in the GroupWise 8 Administration Guide.
8.3.4 Document Viewer Agent Working Directory
The Document Viewer Agent creates its working directory as a subdirectory of its installation directory. The default location varies by platform:
|
NetWare: |
|
|
Linux: |
|
|
Windows: |
c:\Program Files\Novell\GroupWise Server\WebAccess\gwdva.dir |
|
|
|
|
|
|
|
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 Document Viewer Agent worker thread. To control the number of worker threads, see Agent Performance
in Configuring the Document Viewer Agent
in the GroupWise 8 Administration Guide.
cache directory
The cache directory contains subdirectories for managing the documents that the Viewer Agent has already converted. See Document Cache
in WebAccess
in the GroupWise 8 Administration Guide.
000 directory
The 000 directory holds GroupWise library documents that have been converted to HTML. Because these documents belong to a GroupWise library, they are retained for a longer period of time. If the documents in the 000 directory exceed the established maximum cache size, a new directory, 001, is created. Additional library cache directories are created as needed.
tran directory
The tran directory holds attachment documents that have been converted to HTML. Attached documents are more transitory than GroupWise library documents and are retained for a shorter period of time.
problem directory
The problem directory stores information about documents that have failed conversion. This prevents the Viewer Agent from needlessly attempting to convert the same failed documents.
hold directory
The hold directory is the document quarantine directory. Here the Viewer Agent places documents that have failed HTML conversion. You can configure the Viewer Agent to notify an administrator when a document fails conversion. See Document Quarantine
in WebAccess
in the GroupWise 8 Administration Guide
log directory
The log directory stores log files produced by the Viewer Agent. See Agent Log Files
in WebAccess
in the GroupWise 8 Administration Guide.
NOTE:On Linux, Viewer Agent log files are stored in the typical location for log files on Linux (/var/log/novell/groupwise/gwdva), rather than under the gwdva.dir directory.
temp directory
The temp directory is used for the temporary files created during HTML conversion. See Document Conversion
in WebAccess
in the GroupWise 8 Administration Guide.