8.2 Internet Agent Installation

8.2.1 NetWare Installation Directory

  • NetWare Internet Agent installation directory
  • GroupWise 7.x Agent Engine
  • Internet Agent NLM program
  • Internet Agent configuration file
  • Internet Agent language information file
  • Internet Agent load file
  • XIS NLM programs
  • GroupWise XIS NLM programs
  • XIS Internet Agent configuration file
  • Subdirectory for GroupWise agent console help files

See also Section 7.4, Internet Agent Queue Directory.

NetWare Internet Agent installation directory

On a NetWare server, the GroupWise Internet 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.

gwia.nlm file

The gwia.nlm file is the Internet Agent program. You load this NLM program to start the Internet Agent. See Starting the Internet Agent in Installing the GroupWise Internet Agent in the GroupWise 7 Installation Guide.

gwia.cfg file

The Internet Agent configuration file contains startup switches for the Internet Agent. Switch settings placed in the Internet Agent startup file override comparable options set for the Internet Agent in ConsoleOne. The startup file is named the same as the Internet Agent object in ConsoleOne. The default is gwia.

During installation, a customized version of the Internet Agent startup file is created in sys:\system. This customized version has the /home startup switch automatically set to the domain directory where the Internet Agent’s queue directories are located. See Using Internet Agent Startup Switches in Internet Agent in the GroupWise 7 Administration Guide.

gwianxx.fil files

This file contains all language-specific information for the Internet Agent. The digit n is a version number. The last two characters xx are a language code.

gwia.ncf file

The gwia.ncf file is the NetWare configuration file that automatically loads the Internet Agent whenever the server is restarted. A typical gwia.ncf file would look similar to the following:

load sys:\system\gwia @gwia.cfg

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.

gwia.xml file

The gwia.xml file is a specialized Internet Agent configuration file for use in the XIS environment.

8.2.2 Linux Installation Directory

  • Linux agent installation directory
  • Subdirectory for GroupWise agent executables
  • Internet Agent executable
  • Internet Agent XIS configuration file
  • GroupWise High Availability service executable
  • Subdirectory for GroupWIse agent library files
  • Internet Agent language information file
  • Internet Agent shared library file
  • Internet Agent user interface shared library file
  • GroupWise High Availability service library files
  • Supporting shared library files
  • Subdirectory for icon images
  • Subdirectory for agent shared files
  • Internet Agent configuration file
  • Subdirectory for agent console files
  • Subdirectory agent console help files
  • Subdirectory for agent Web console files
  • Subdirectory for agent Web console help files
  • Standard Linux location for application startup scripts
  • Startup script for the Internet Agent
  • Standard Linux location for run-level-3 symbolic links
  • Symbolic link to the startup script for the Internet Agent
  • Standard Linux location for run-level-5 symbolic links
  • Symbolic link to the startup script for the Internet Agent
  • Standard Linux location for application configuration files
  • Subdirectory for GroupWise configuration files
  • GroupWise High Availability service configuration file
  • Subdirectory for GroupWise agents
  • Agent configuration file for running as a non-root user
  • Standard Linux location for application log files
  • Subdirectory for GroupWise agent log files
  • Domain-specific subdirectory for Internet Agent log files
  • Internet Agent log files

See also Section 7.4, Internet Agent Queue Directory.

agents directory

On a Linux server, the Internet Agent is always installed in subdirectories of /opt/novell/groupwise/agents.

bin directory

The bin directory holds GroupWise executable files.

gwia file

The gwia file is the Internet Agent executable. You run this executable file to start the Internet Agent. See Starting the Internet Agent in Installing the GroupWise Internet Agent in the GroupWise 7 Installation Guide.

gwia.xml file

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

gwha file

The gwha file is the GroupWise High Availability service executable. If the Internet Agent goes down for any reason, the High Availability service automatically restarts it. See Enabling the High Availability Service for the Linux GroupWise Agents in Installing GroupWise Agents in the GroupWise 7 Installation Guide.

lib directory

The lib directory holds GroupWise shared library files.

gwiaxxx.fil files

This file contains all language-specific information for the Internet Agent. The last two characters xx are a language code.

*.so files

These files are Linux shared library files that provide information to the Internet 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.

gwia.cfg

The Internet Agent configuration file contains startup switches for the Internet Agent. Switch settings placed in the Internet Agent configuration file override comparable configuration options set for the Internet Agent in ConsoleOne. The startup file is named the same as the Internet Agent object in ConsoleOne. The default is gwia.

During installation, the Internet Agent startup file is created in the share directory with the --home startup switch automatically set to the domain directory where the Internet Agent queue directory is located. See Using Internet Agent Startup Switches in Internet Agent in the GroupWise 7 Administration Guide.

agtcon directory

The agtcon directory holds subdirectories and files used by the agent consoles, such as help files.

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 Internet Agent. For more information about starting the Internet Agent, see Starting the Internet Agent in Installing the GroupWise Internet Agent 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 Internet 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 Internet Agent start automatically when the server boots.

/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 Internet Agent interacts 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 Internet Agent if it goes down unexpectedly. See Enabling the High Availability Service for the Linux GroupWise Agents in Installing GroupWise Agents in the GroupWise 7 Installation Guide.

uid.conf file

The uid.conf file configures the Internet Agent 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 7 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.gwia directory

The domain.gwia directory is a domain-specific location for Internet Agent log files.

Within the domain.gwia directory, the Internet Agent creates log files (mmddgwia.nnn) to inform you of its processing and any problems it encounters. For more information about log files, see Using Internet Agent Log Files in Internet Agent 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, 0518gwia.002 is the second Internet Agent log file created on May 18.

8.2.3 Windows Installation Directory

  • Windows Internet Agent installation directory
  • GroupWise Agent Engine
  • Internet Agent program
  • Internet Agent configuration file
  • Internet Agent online help file
  • Internet Agent language information file
  • Customized DLL program for MIME
  • XIS DLL programs
  • GroupWise XIS DLL program
  • XIS agent configuration file

See also Section 7.4, Internet Agent Queue Directory.

c:\grpwise\gwia

On a Windows server, the Internet Agent can be installed in any directory you choose. The default location is c:\grpwise\gwia. The Internet Agent 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 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.

gwia.exe file

The gwia.exe file is the Internet Agent program. You run this executable file to start the Internet Agent. See Starting the Internet Agent in Installing the GroupWise Internet Agent in the GroupWise 7 Installation Guide.

gwia.cfg file

On Windows, the gwia.cfg file in the installation directory is simply a pointer to the gwia.cfg file under the domain directory where the actual Internet Agent configuration file is located.

gwianxx.chm file

The .chm files contain the online documentation for the Internet Agent. Online help is available by clicking Help in the Internet Agent console on the server where the agent is running. In addition, dialog boxes have a Help button for context-sensitive Help.

The digit n is a version number. The last two characters xx are a language code.

gwianxx.dll files

The gwianxx.dll files contain all language-specific information for the Internet Agent. The digit n is a version number. The last two characters xx are a language code.

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.

gwia.xml file

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