8.2 Internet Agent Installation
8.2.1 NetWare Installation Directory
NetWare Internet
Agent installation directory
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
|
|
|
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
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 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.