8.3 WebAccess Agent Installation

8.3.1 NetWare Installation Directory

  • NetWare WebAccess Agent installation directory
  • GroupWise 7.x Agent Engine
  • WebAccess Agent program
  • Document Viewer Agent program
  • WebAccess Agent load file
  • WebAccess Agent unload file
  • WebAccess Agent startup file
  • Document Viewer Agent startup file
  • XIS NLM programs
  • GroupWise XIS NLM program
  • WebAccess Agent XIS configuration file
  • Subdirectory for WebAccess template file storage
  • Subdirectory for HTML template files
  • WebAccess template files
  • WebPublisher template files
  • Document Viewer Agent working directory
  • Subdirectory for GroupWise agent console help files

Additional WebAccess files are integrated into your Web server to support the WebAccess client and the WebAccess Agent Web console. See Section 8.5, Apache/Tomcat Installation. See also Section 7.5, 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 7.x 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 @webac70a.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 7 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

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

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

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 7 Administration Guide.

8.3.2 Linux Installation Directory

  • Novell GroupWise installation directory
  • Linux agent installation directory
  • Subdirectory for GroupWise agent executables
  • WebAccess Agent executable
  • WebAccess Agent XIS configuration file
  • Boilerplate WebAccess startup file
  • Subdirectory for HTML template files
  • Document Viewer Agent executable
  • Document Viewer Agent working directory
  • Subdirectory for GroupWise agent library files
  • Supporting shared library files
  • Subdirectory for icon images
  • Subdirectory for agent shared files
  • WebAccess Agent startup file
  • Document Viewer Agent startup file
  • Subdirectory for agent Web console files
  • Subdirectory for agent Web console help files
  • Subdirectory for WebAccess Application files
  • WebAccess Application configuration file
  • Communications Manager configuration file
  • Novell Speller Application configuration file
  • LDAP service provider configuration file
  • Subdirectory for boilerplate configuration files
  • Subdirectory for WebAccess Application log files
  • Subdirectory for users’ WebAccess session information
  • Subdirectory for WebAccess Application files
  • WebPublisher Application configuration file
  • Communications Manager configuration file
  • Subdirectory for boilerplate configuration files
  • Subdirectory for WebPublisher Application log files
  • Standard Linux location for application startup scripts
  • Startup script for the WebAccess Agent
  • Standard Linux location for run-level-3 symbolic links
  • Symbolic link to the startup script for the WebAccess Agent
  • Standard Linux location for run-level-5 symbolic links
  • Symbolic link to the startup script for the WebAccess Agent
  • Standard Linux location for application log files
  • Subdirectory for GroupWise agent log files
  • Domain-specific subdirectory for WebAccess Agent log files
  • Processing directory for log files
  • WebAccess Agent log files
  • Subdirectory for Viewer Agent log files
  • Viewer Agent log files

Additional WebAccess files are integrated into your Web server to support the WebAccess client and the WebAccess Agent Web console. See Section 8.5, Apache/Tomcat Installation. See also Section 7.5, 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 7 Installation Guide.

gwinter.xml file

The gwinter.xml file is a specialized configuration file for use in the XIS environment.

webac70axx.waa file

The webac70axx.waa file is the boilerplate file from which a domain-specific webac70a.waa file is created in the share directory. The webac70a 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.

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.

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

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

webaccess directory

The webaccess directory holds files used by the WebAccess Application.

webacc.cfg file

The webacc.cfg file holds the same configuration information that is stored on the WebAccess Application object (named GroupWiseWebAccess) in eDirectory. For more information, see Configuring the WebAccess Application in WebAccess in the GroupWise 7 Administration Guide.

commgr.cfg file

The commgr.cfg file holds the same configuration information that is stored on the GroupWise Provider object (named GroupWiseProvider) in eDirectory, including the IP address and encryption key for the WebAccess Agent. This information enables the WebAccess Application to communicate with the WebAccess Agent. For more information, see Configuring the GroupWise Service Provider in WebAccess in the GroupWise 7 Administration Guide.

A copy of the commgr.cfg file is automatically maintained in the WebAccess Agent queue directory (domain/wpgate/webac70a).

spellchk.cfg file

The spellchk.cfg file holds the same configuration information that is stored on the Novell Speller Application object (named NovellSpeller) in eDirectory. For more information, see Configuring the Novell Speller Application in WebAccess in the GroupWise 7 Administration Guide.

ldap.cfg file

The ldap.cfg file holds the same configuration information that is stored on the LDAP Provider object (named LDAPProvider) in eDirectory. For more information, see Configuring the LDAP Service Provider in WebAccess in the GroupWise 7 Administration Guide.

default directory

The default directory holds boilerplate versions of the various .cfg files.

logs directory

The logs subdirectory holds WebAccess Application log files. For more information, see Controlling WebAccess Application Logging in WebAccess in the GroupWise 7 Administration Guide.

users directory

The users subdirectory holds session files for WebAccess users. If WebAccess times out after a period of user inactivity, the user’s session information is saved. When the user logs back in, the session information is retrieved so that the user can continue working without loss of data. Also, users’ message text is saved during each session, so that if the WebAccess Application is restarted or goes down, users do not lose the message text they were composing at the time. Session files are deleted when users log back in.

webpublisher directory

The webpublisher directory holds files used by the WebPublisher Application.

webpub.cfg

The webpub.cfg file holds the same configuration information that is stored on the WebPublisher Application object (named GroupWiseWebPublisher) in eDirectory. For more information, see Configuring the WebPublisher Application in WebAccess in the GroupWise 7 Administration Guide.

commgr.cfg file

The commgr.cfg file holds the same configuration information that is stored on the GroupWise Provider object (named GroupWiseProvider) in eDirectory, including the IP address, port number, number of threads, and encryption key for the WebAccess Agent. This information enables the WebAccess Application to communicate with the WebAccess Agent. For more information, see Configuring the GroupWise Service Provider in WebAccess in the GroupWise 7 Administration Guide.

A copy of the commgr.cfg file is automatically maintained in the WebAccess Agent queue directory (domain/wpgate/webac70a).

default directory

The default directory holds boilerplate versions of the webpub.cfg and commgr.cfg files.

logs directory

The logs subdirectory holds WebPublisher Application log files. For more information, see Controlling WebAccess Application Logging in WebAccess in the GroupWise 7 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 WebAccess Agent. For more information about starting the WebAccess Agent, see Linux: Setting Up GroupWise WebAccess in Installing GroupWise WebAccess in the GroupWise 7 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 S99grpwise. 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 S99grpwise. 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.webac70a directory

The domain.webac70a 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 7 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

  • Windows WebAccess Agent installation directory
  • GroupWise Agent Engine
  • WebAccess Agent program
  • WebAccess Agent batch file
  • WebAccess Agent startup file
  • Document Viewer Agent program
  • Document Viewer Agent startup file
  • Document Viewer Agent working directory
  • WebAccess Agent language information file
  • Customized DLL program for SNMP
  • Customized DLL program for MIME
  • XIS DLL programs
  • GroupWise XIS DLL program
  • WebAccess Agent XIS configuration file
  • Subdirectory for HTML template files
  • WebAccess template files
  • WebPublisher template files
  • Subdirectory for GroupWise agent console help files

Additional WebAccess files are integrated into your Web server to support the WebAccess client and the WebAccess Agent Web console. See Section 8.5, Apache/Tomcat Installation. See also Section 7.5, WebAccess Agent Queue Directory.

c:\webacc

On a Windows server, the WebAccess Agent can be installed in any directory you choose. The default location is c:\webacc. 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 @webac70a.waa

You run this batch file to start the WebAccess Agent. See Starting GroupWise WebAccess in Installing GroupWise WebAccess in the GroupWise 7 Installation Guide.

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

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\webac70a) is located. See Using WebAccess Startup Switches in WebAccess in the GroupWise 7 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.

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 7 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:

  • Document Viewer Agent working directory
  • Subdirectory for caching converted documents for repeated display
  • Subdirectory for converted GroupWise library documents
  • Subdirectory for converted attachment documents
  • Subdirectory for information about documents that failed conversion
  • Subdirectory for quarantined documents that failed HTML conversion
  • Subdirectory for Document Viewer Agent log files
  • Subdirectory for the temporary files using during HTML conversion
  • (not currently used)

gwdva.dir directory

The gwdva.dir directory is the working directory for the Document Viewer Agent.

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 7 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 7 Administration Guide

log directory

The log directory stores log files produced by the Viewer Agent. See Agent Log Files in WebAccess in the GroupWise 7 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 7 Administration Guide.