Internet Agent Installation


NetWare Installation Directory

Folder icon sys:\system

Line SpacerNetWare Internet Agent installation directory

File icon gwenn4.nlm
File icon gwia.nlm

Line SpacerGroupWise 6.5 Agent Engine
Line SpacerInternet Agent NLM program

File icon gwia.cfg

Line SpacerInternet Agent configuration file

File icon gwianxx.fil

Line SpacerInternet Agent language information file

File icon gwia.ncf

Line SpacerInternet Agent load file

File icon x*10.nlm

Line SpacerXIS NLM programs

File icon gwia.xml

Line SpacerXIS Internet Agent configuration file

Folder icon help

Line SpacerSubdirectory for GroupWise agent console help files

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


gwenn4.nlm file

The gwenn4.nlm file is the GroupWise 6.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 6.5 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 6.5 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*10.nlm files

The x*10.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.


Linux Installation Directory

Folder icon /opt/novell/groupwise/agents

Line SpacerLinux agent installation directory

Folder icon binPage icon gwia
Page icon gwia.xml

Line SpacerSubdirectory for GroupWise agent executables
Line SpacerInternet Agent executable
Line SpacerInternet Agent XIS configuration file

Folder icon lib
Page icon gwiaxxx.fil

Line SpacerSubdirectory for GroupWIse agent library files
Line SpacerInternet Agent language information file

Page icon libgwia.so
Page icon libgwia_ui.so
Page icon *.so

Line SpacerInternet Agent shared library file
Line SpacerInternet Agent user interface shared library file
Line SpacerSupporting shared library files

Folder icon image

Line SpacerSubdirectory for icon images

Folder icon sharePage icon gwia.cfg

Line SpacerSubdirectory for agent shared files
Line SpacerInternet Agent configuration file

Folder icon agtcon
Folder icon help

Line SpacerSubdirectory for agent console files
Line SpacerSubdirectory agent console help files

Folder icon webcon
Folder icon help

Line SpacerSubdirectory for agent Web console files
Line SpacerSubdirectory for agent Web console help files

Folder icon /etc/init.d
Page icon grpwise-ia

Line SpacerStandard Linux location for application startup scripts
Line SpacerStartup script for the Internet Agent

Folder icon rc3.d
Page icon S99grpwise-ia

Line SpacerStandard Linux location for run-level-3 symbolic links
Line SpacerSymbolic link to the startup script for the Internet Agent

Folder icon rc5.d
Page icon S99grpwise-ia

Line SpacerStandard Linux location for run-level-5 symbolic links
Line SpacerSymbolic link to the startup script for the Internet Agent

Folder icon /var/log/
Folder icon novell/groupwise

Line SpacerStandard Linux location for application log files
Line SpacerSubdirectory for GroupWise agent log files

Folder icon domain.gwia
Page icon mmddgwia.nnn

Line SpacerDomain-specific subdirectory for Internet Agent log files
Line SpacerInternet Agent log files

See also 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 6.5 Installation Guide.


gwia.xml file

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


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 6.5 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-ia 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 6.5 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 run level 3 (multi-user; boots to a text mode login prompt without The X Window System). The symbolic link to the grpwise-ia script is S99grpwise-ia. 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 run level 5 (multi-user; boots to The X Window System login dialog box). The symbolic link to the grpwise-ia script is S99grpwise-ia. It is created if you choose during installation to have the Internet 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.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 6.5 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.


Windows Installation Directory

Folder icon c:\grpwise\gwia

Line SpacerWindows Internet Agent installation directory

File icon gwenv1a.dll
File icon gwia.exe
File icon gwia.cfg
File icon gwianxx.chm
File icon gwianxx.dll
File icon gwwww1.dll
File icon x*10.dll
File icon gwia.xml

Line SpacerGroupWise Agent Engine
Line SpacerInternet Agent program
Line SpacerInternet Agent configuration file
Line SpacerInternet Agent online help file
Line SpacerInternet Agent language information file
Line SpacerCustomized DLL program for MIME
Line SpacerXIS DLL programs
Line SpacerXIS agent configuration file

See also 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 6.5 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 files

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*10.dll files

The x*10.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.