7.2 Internet Agent Installation

7.2.1 Linux Internet Agent Installation Directory

  • Linux agent installation directory
  • Subdirectory for GroupWise agent executables
  • GWIA executable
  • GroupWise High Availability service executable
  • GroupWise agent startup script
  • Subdirectory for GroupWise agent library files
  • GWIA language information file
  • Subdirectory for agent shared files
  • GWIA 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 GWIA
  • Standard Linux location for run-level-3 symbolic links
  • Symbolic link to the startup script for the GWIA
  • Standard Linux location for run-level-5 symbolic links
  • Symbolic link to the startup script for the GWIA
  • Standard Linux location for application startup script links
  • Link to the startup script for the GWIA
  • 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 GWIA log files
  • GWIA log files

See also Section 6.4, Internet Agent Queue Directory.

agents directory

On a Linux server, the GWIA 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 GWIA executable. You run this executable file to start the GWIA. See Starting the GWIA in Installing the GroupWise Internet Agent in the GroupWise 2012 Installation Guide.

gwha file

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

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 GWIA. For more information about starting the agents, see Installing and Starting the Linux GroupWise Agents in Installing a Basic GroupWise System in the GroupWise 2012 Installation Guide.

lib directory

The lib directory holds GroupWise shared library files.

gwiaxxx.fil files

These files contain all language-specific information for the GWIA. The last two characters xx are a language code.

share directory

The share directory holds agent startup files and files that are used by the agent consoles and Web consoles.

gwia.cfg

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

During installation, the GWIA startup file is created in the share directory with the --home switch automatically set to the domain directory where the GWIA queue directory is located. See Using GWIA Startup Switches in Internet Agent in the GroupWise 2012 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 GWIA. For more information about starting the GWIA, see Starting the GWIA in Installing the GroupWise Internet Agent in the GroupWise 2012 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 GWIA 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 GWIA start automatically when the server boots.

/usr/sbin directory

The /usr/sbin directory is the standard location for application scripts that can be run from any directory on the Linux server. The /usr/sbin directory is always included in the PATH environment variable. Files in this directory are links to the corresponding script files in /etc/init.d.

/etc/opt/novell/groupwise directory

The /etc/opt directory is the standard location of application configuration files on Linux. Files that configure how the GWIA 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 GWIA if it goes down unexpectedly. See Enabling the GroupWise High Availability Service for the Linux GroupWise Agents in Installing GroupWise Agents in the GroupWise 2012 Installation Guide.

uid.conf file

The uid.conf file configures the GWIA 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 2012 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.

gwia.domain directory

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

Within the domain.gwia directory, the GWIA creates log files (mmddgwia.nnn) to inform you of its processing and any problems it encounters. For more information about log files, see Using GWIA Log Files in Internet Agent in the GroupWise 2012 Administration Guide.

The first two digits of the file name 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 GWIA log file created on May 18.

7.2.2 Windows GWIA Installation Directory

  • Windows Internet Agent installation directory (64‑bit machine)  
  • Windows Internet Agent installation directory (32-bit machine)
  • GroupWise Agent Engine
  • GWIA program
  • GWIA configuration file
  • GWIA online help file
  • GWIA language information file
  • Customized DLL program for MIME

See also Section 6.4, Internet Agent Queue Directory.

c:\Program Files\Novell\GroupWise Server\GWIA

On a Windows server, the GWIA can be installed in any directory you choose. The default location is c:\Program Files\Novell\GroupWise Server\GWIA. The GWIA 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.

gwia.exe file

The gwia.exe file is the GWIA program. You run this executable file to start the GWIA. See Starting the GWIA in Installing the GroupWise Internet Agent in the GroupWise 2012 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 GWIA configuration file is located.

gwianxx.chm file

The .chm files contain the online documentation for the GWIA. Online help is available by clicking Help in the GWIA 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 GWIA. 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.