8.5 Apache/Tomcat Installation

WebAccess, WebPublisher, and Monitor rely on the presence of a Web server in order to fulfil their functions. A number of Web servers are supported. See GroupWise System Requirements in Installing a Basic GroupWise System in the GroupWise 7 Installation Guide. In this section, the Apache Web server and the Tomcat Servlet Engine used to illustrate how GroupWise integrates with your Web server.

8.5.1 NetWare Installation Directory

  • sys:\apache2
  • Apache installation directory
  • bin
  • cgi-bin
  • Standard Apache directory
  • Standard Apache directory
  • Standard Apache directory
  • Main Apache configuration file
  • Specialized Apache configuration file for use with GroupWise
  • error
  • Standard Apache directory
  • Apache document root directory
  • Web server default Web page
  • icons
  • logs
  • man
  • manual
  • modules
  • Standard Apache directory
  • Standard Apache directory
  • Standard Apache directory
  • Standard Apache directory
  • Standard Apache directory
  • sys:\tomcat\4
  • bin
  • common
  • conf
  • examples
  • logs
  • server
  • shared
  • temp
  • Tomcat installation directory
  • Standard Tomcat directory
  • Standard Tomcat directory
  • Standard Tomcat directory
  • Standard Tomcat directory
  • Standard Tomcat directory
  • Standard Tomcat directory
  • Standard Tomcat directory
  • Standard Tomcat directory
  • webapps/ROOT
  • Standard Tomcat document root directory
  • GroupWise-specific document root directory
  • GroupWise default Web services page
  • com/novell
  • Directory for Novell product files
  • collexion
  • Directory for Novell class files and properties files
  • GWMonitor
  • help
  • images
  • Directory for GroupWise Monitor files
  • Subdirectory for Monitor Web console help files
  • Subdirectory for Monitor Web console image files
  • images
  • inso
  • Directory for Novell product image files
  • Directory for Inso* viewer files for viewing attachments
  • webaccess
  • applets
  • help
  • images
  • webconsole
  • Directory for GroupWise WebAccess files
  • Subdirectory for WebAccess client properties files
  • Subdirectory for WebAccess client help files
  • Subdirectory for WebAccess client image files
  • Subdirectory for WebAccess Application Web console help files
  • webpublisher
  • help
  • images
  • Directory for GroupWise WebPublisher files
  • Subdirectory for WebPublisher help files
  • Subdirectory for WebPublisher image files
  • Web server information directory
  • Web server configuration file
  • classes/com/novell
  • Directory for Novell product files
  • collexion
  • Directory for language-specific morphology files
  • Directory for GroupWise Monitor files
  • Subdirectory for service provider files
  • Subdirectory for template files
  • Directory for GroupWise WebAccess files
  • Subdirectory for service provider files
  • Subdirectory for template files
  • Directory for GroupWise WebPublisher files
  • Subdirectory for service provider files
  • Subdirectory for template files
  • work
  • Standard Tomcat directory
  • sys:\novell
  • Directory for Novell product configuration files
  • Subdirectory for GroupWise Monitor
  • Monitor Application configuration file
  • Directory for Monitor Application log files
  • Subdirectory for WebAccess
  • WebAccess Application configuration file
  • Communications Manager configuration file
  • Novell Speller Application configuration file
  • LDAP service provider configuration file
  • Directory for WebAccess Application log files
  • Temporary working directory
  • Directory for WebAccess users’ session files
  • Subdirectory for WebAccess Application files
  • WebPublisher Application configuration file
  • Communications Manager configuration file
  • Subdirectory for boilerplate configuration files
  • Subdirectory for WebPublisher Application log files

conf/httpd.conf file

The httpd.conf file is the main Apache configuration file. On NetWare, the GroupWise Installation program modifies it to include a reference to the GWApache2.conf file.

conf/GWApache2.conf file

The GWApache2.conf file includes the jkmount command that enables Apache and Tomcat to communicate with each other.

htdocs/index.html file

The index.html file in the htdocs directory is the default HTML file that displays in your Web browser when you go to the IP address or hostname of the server.

webapps/gw/index.html file

The index.html file in the gw directory is the default HTML file for GroupWise Web services (WebAccess, WebPublisher, and Monitor) and displays when you go to the following URL:

http://web_server_address/gw

From this default page, specific GroupWise URLs can be easily accessed:

http://web_server_address/gw/webacc
http://web_server_address/gw/webpub
http://web_server_address/gw/gwmonitor

WEB-INF/web.xml file

The web.xml file tells the Web server where the various GroupWise service providers and their configuration files are located. By default, they are located in subdirectories under sys:\novell.

GWMonitor/providers directory

The providers directory holds the Java* class and properties files for the Monitor provider. For more information, see Adding or Removing Service Providers in Monitor in the GroupWise 7 Administration Guide.

GWMonitor/templates directory

The templates directory holds subdirectories for the various file formats used in various browser environments. For more information, see Modifying Monitor Application Template Settings in Monitor in the GroupWise 7 Administration Guide.

webaccess/providers directory

The providers directory holds the Java class and properties files for the WebAccess providers. For more information, see Adding or Removing Service Providers in WebAccess in the GroupWise 7 Administration Guide.

webaccess/templates directory

The templates directory holds subdirectories for the various file formats used in various browser environments. For more information, see Modifying WebAccess Application Template Settings in WebAccess in the GroupWise 7 Administration Guide.

webpublisher/providers directory

The providers directory holds the Java class and properties files for the WebPublisher providers. For more information, see Adding or Removing Service Providers in WebAccess in the GroupWise 7 Administration Guide.

webpublisher/templates directory

The templates directory holds subdirectories for the various file formats used in various browser environments. For more information, see Modifying WebPublisher Application Template Settings in WebAccess in the GroupWise 7 Administration Guide.

sys:\novell directory

The sys:\novell directory holds subdirectories for each Novell product that uses application configuration files.

gwmonitor directory

The gwmonitor directory is created when you install GroupWise Monitor.

gwmonitor.cfg file

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

logs directory

The logs subdirectory holds Monitor Application log files. For more information, see Modifying Monitor Application Log Settings in Monitor in the GroupWise 7 Administration Guide.

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

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.

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.

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 WebAccess Application log files. For more information, see Controlling WebAccess Application Logging in WebAccess in the GroupWise 7 Administration Guide.

8.5.2 Linux Installation Directory

  • /opt/novell/httpd
  • modules
  • Novell Apache installation directory
  • Standard Apache directory
  • /etc/opt/novell/httpd
  • conf.d
  • gconf.d
  • sslconf.d
  • Novell Apache configuration directory
  • Standard Apache directory
  • Standard Apache directory
  • Standard Apache directory
  • /etc/opt/novell/tomcat4
  • catalina.properties
  • jk2.properties
  • server.xml
  • tomcat-users.xml
  • tomcat4.conf
  • web.xml
  • init.d
  • logrotate.d
  • Novell Tomcat configuration directory
  • Standard Tomcat file
  • Standard Tomcat file
  • Standard Tomcat file
  • Standard Tomcat file
  • Standard Tomcat file
  • Web server configuration file
  • Standard Tomcat directory
  • Standard Tomcat directory
  • /var/opt/novell
  • Novell subdirectory under /var
  • Apache document root directory for WebAccess and WebPublisher
  • Web server default Web page
  • com/novell
  • Directory for Novell product files
  • collexion
  • Directory for Novell class files and properties files
  • images
  • inso
  • Directory for Novell product image files
  • Directory for Inso viewer files for viewing attachments
  • webaccess
  • applets
  • help
  • images
  • webconsole
  • Directory for GroupWise WebAccess files
  • Subdirectory for WebAccess client properties files
  • Subdirectory for WebAccess client help files
  • Subdirectory for WebAccess client image files
  • Subdirectory for WebAccess Application Web console help files
  • webpublisher
  • help
  • images
  • Directory for GroupWise WebPublisher files
  • Subdirectory for WebPublisher help files
  • Subdirectory for WebPublisher image files
  • Web server information directory
  • Web server configuration file
  • classes/com/novell
  • Web server configuration file
  • collexion
  • Directory for language-specific morphology files
  • Directory for GroupWise WebAccess files
  • Subdirectory for service provider files
  • Subdirectory for template files
  • Directory for GroupWise WebPublisher files
  • Subdirectory for service provider files
  • Subdirectory for template files
  • Apache document root directory for Monitor
  • Web server default page
  • com/novell
  • Directory for Novell product files
  • gwmonitor
  • help
  • images
  • Directory for GroupWise WebPublisher files
  • Subdirectory for WebPublisher help files
  • Subdirectory for WebPublisher image files
  • Web server information directory
  • Web server configuration file
  • Directory for GroupWise Monitor files
  • Subdirectory for service provider files
  • Subdirectory for template files
  • httpd
  • log
  • novlwww
  • run
  • Standard Apache directory
  • Standard Apache directory
  • Home directory for the novlwww user created at installation
  • Standard Apache directory
  • tomcat4
  • bin
  • common
  • conf
  • logs
  • server
  • shared
  • temp
  • Standard Tomcat directory
  • Standard Tomcat directory
  • Standard Tomcat directory
  • --> /etc/opt/novell/tomcat4
  • Standard Tomcat directory
  • Standard Tomcat directory
  • Standard Tomcat directory
  • Standard Tomcat directory
  • webapps
  • admin.xml
  • manager.xml
  • examples
  • gw
  • gwmon
  • tomcat-docs
  • webdav

gw/index.html file

The index.html file in the gw directory is the default HTML file for GroupWise Web services (WebAccess and WebPublisher) and displays when you go to the following URL:

http://web_server_address/gw

From this default page, specific GroupWise URLs can be easily accessed:

http://web_server_address/gw/webacc
http://web_server_address/gw/webpub
gw/WEB-INF/web.xml file

The web.xml file in the gw/WEB-INF directory tells the Web server where the various WebAccess service providers and their configuration files are located. By default, they are located in /opt/novell/groupwise/webaccess.

webaccess/providers directory

The providers directory holds the Java class and properties files for the WebAccess providers. For more information, see Adding or Removing Service Providers in WebAccess in the GroupWise 7 Administration Guide.

webaccess/templates directory

The templates directory holds subdirectories for the various file formats used in various browser environments. For more information, see Modifying WebAccess Application Template Settings in WebAccess in the GroupWise 7 Administration Guide.

webpublisher/providers directory

The providers directory holds the Java class and properties files for the WebPublisher providers. For more information, see Adding or Removing Service Providers in WebAccess in the GroupWise 7 Administration Guide.

webpublisher/templates directory

The templates directory holds subdirectories for the various file formats used in various browser environments. For more information, see Modifying WebPublisher Application Template Settings in WebAccess in the GroupWise 7 Administration Guide.

gwmon/index.html file

The index.html file in the gwmon directory is the default HTML file for the GroupWise Monitor Web service and displays when you go to the following URL:

http://web_server_address/gwmon

From this default page, the GroupWise Monitor login page can be easily accessed:

http://web_server_address/gwmon/gwmonitor
gwmon/WEB-INF/web.xml file

The web.xml file in the gwmon/WEB-INF directory tells the Web server where the Monitor service provider and its configuration file are located. By default, they are located in /opt/novell/groupwise/gwmonitor.

gwmonitor/providers directory

The providers directory holds the Java class and properties files for the Monitor provider. For more information, see Adding or Removing Service Providers in Monitor in the GroupWise 7 Administration Guide.

gwmonitor/templates directory

The templates directory holds subdirectories for the various file formats used in various browser environments. For more information, see Modifying Monitor Application Template Settings in Monitor in the GroupWise 7 Administration Guide.