Configuring GroupWise WebAccess on Apache Webserver

Novell Cool Solutions: Tip

Digg This - Slashdot This

Posted: 2 Jan 2002

Versions: GroupWise 6

How to Configure Tomcat for WebAccess

NOTE: This document assumes that you already have Apache and Tomcat installed and running on your NetWare server.

On NetWare 6, Apache and Tomcat are installed by default.

On NetWare 5.1, running WebAccess using Apache/Tomcat is NOT a supported configuration (but should work) and requires that you update your JVM for NetWare to version 1.2 or higher (1.2.2 recommended). To install Apache/Tomcat, you will need to download and install the latest version of the Apache web server for NetWare from http://www.apache.org/dist/httpd/binaries/netware/ and the latest version of the Tomcat Servlet/JSP Engine from http://jakarta.apache.org/builds/jakarta-tomcat/release/.

Step 1 -- Copying files for WebAccess
Step 2 -- Modifying Config Files for WebAccess
Step 3 -- Modifying Config Files for WebPublisher
Apache Setup

Step 1 -- Copying files for WebAccess

NOTE: If you are using GroupWise Enhancement Pack, you MUST install Service Pack 4 or later of the GroupWise Enhancement Pack Webaccess. The update that provides compatibility with Apache/Tomcat will be included in the regular release of Enhancement Pack SP4 or prior to the full release of SP4, you can download a BETA release by going to http://support.novell.com/filefinder/ and typing in the filename FWAEP4*.* . Displayed will be the latest BETA releases of Webaccess software.

z: will be used to denote a drive mapped to your NetWare server.

Copy the COM directory contained in the Software Distribution Directory :\\internet\webacces\servlets\ to z:\\webapps\ROOT\web-inf\classes. If the classes portion of the path is not there then create it. The \ on NetWare 6 is normally z:\tomcat\33.

Copy the files contained in the Software Distribution Directory :\\internet\webacces\jarlib to z:\\ webapps\ROOT\web-inf\lib. If the LIB portion of the directory is not there then create it. WARNING: Do not copy the jarlib directory, only the files contained in it.

Step 2 -- Modifying Config Files for WebAccess

Open the file z:\\webapps\ROOT\web-inf\web.xml for editing. Add the following text between the and tags:

<servlet>
    <servlet-name>webacc</servlet-name>
    <servlet-class>com.novell.webaccess.WebAccessServlet</servlet-class>
    <init-param>
        <param-name>Config</param-name>
        <param-value>sys:/Novell/WebAccess/webacc.cfg</param-value>
    </init-param>
    <load-on-startup> </load-on-startup>
</servlet>

NOTE: Add the following section ONLY if you are running GroupWise 6 WebAccess.

<servlet>
    <servlet-name>spellchk</servlet-name>
    <servlet-class>com.novell.collexion.spell.servlet.SpellServlet</servlet-class>
    <init-param>
        <param-name>Config</param-name>
        <param-value>sys:/Novell/WebAccess/spellchk.cfg</param-value>
    </init-param>
    <load-on-startup> </load-on-startup>
</servlet>

Open the z:\novell\webaccess\webacc.cfg for editing. If the file or the directory does not exist, then create the directory (if necessary), and copy Software Distribution Directory <server>:<volume>:\internet\webacces\config\webacc.cfg to z:\novell\webaccess.

If the webacc.cfg did not need to be copied from the CD then modify the following line and skip the next step. If the webacc.cfg had to be copied from the CD, then modify the following line and complete the next step.
Change
Templates.path=/java/servlets/com/novell/webaccess/templates
To
Templates.path=\\<server-name>\sys\<tomcat-root>\webapps\ROOT\web-inf\classes\com\ novell\webaccess\templates

Modify the following lines:
Change
File.Upload.path=/novell/webaccess/temp
To
File.Upload.path=sys:/Novell/webaccess/temp

Change
Log.path=/novell/webaccess/logs
To
Log.path=\\<server-name>\sys\Novell\webaccess\logs

Change
Securi.ty.Timeout.path=/novell/webaccess/users
To
Security.Timeout.path=\\<server-name>\sys\Novell\webaccess\users

Change
Provider.GWAP.Config.file=/novell/webaccess/commgr.cfg
To
Provider.GWAP.Config.file=\\<server-name>\sys\Novell\webaccess\commgr.cfg

Change
Provider.LDAP.Config.file=/novell/webaccess/ldap.cfg
To
Provider.LDAP.Config.file=\\<server-name>\sys\Novell\webaccess\ldap.cfg

Open the z:\novell\webaccess\spellchk.cfg for editing. If the file or the directory does not exist, then create the directory (if necessary), and copy Software Distribution Directory <server>:\<volume>\internet\webacces\config\spellchk.cfg to z:\novell\webaccess.

If the spellchk.cfg did not need to be copied from the CD then modify the following line and skip the next step. If the spellchk.cfg had to be copied from the Software Distribution Directory, then modify the following line and complete the next step.

Change
Speller.Dictionary.path=/java/servlets/com/novell/collexion/morphology/data
To
Speller.Dictionary.path=\\server\sys\Tomcat\33\webapps\ROOT\web-if\classes\ com\novell\collexion\morphology\data

Modify the following lines:
Change
File.Upload.path=/novell/webaccess/temp
To
File.Upload.path=sys:/Novell/webaccess/temp

Change
Log.file=/novell/webaccess/logs/spellchk.log
To
Log.file=\\<server-name>\sys\Novell\WebAccess\logs\spellchk.log

If the ldap.cfg file is not contained in z:\novell\webaccess directory, then copy the ldap.cfg file from Software Distribution Directory:\internet\webacces\config to z:\novell\webaccess.

Step 3 -- Modifying Config Files for WebPublisher

Open the file z:\<tomcat-root>\webapps\ROOT\web-inf\web.xml for editing. Add the following text between the <web-app> and </web-app> tags:
<servlet>
    <servlet-name>webpub</servlet-name>
    <servlet-class>com.novell.webpublisher.WebPublisherServlet</servlet-class>
    <init-param>
        <param-name>Config</param-name>
        <param-value>sys:/Novell/WebPublisher/webpub.cfg</param-value>
    </init-param>
    <load-on-startup> </load-on-startup>
</servlet>

Open the z:\novell\webpublisher\webpub.cfg for editing. If the file or the directory does not exist, then create the directory (if necessary), and copy Software Distribution Directory's <server>:\<volume>:\internet\webacces\config\webpub.cfg to z:\novell\webpublisher.

If the webpub.cfg did not need to be copied from the Software Distribution Directory then modify the following line and skip the next step. If the webpub.cfg had to be copied from the Software Distribution Directory, then modify the following line and complete the next step.

Change
Templates.path=/java/servlets/com/novell/webaccess/templates
To
Templates.path=\\<server-name>\sys\<tomcat-root>\webapps\ROOT\web-inf\classes\com\ novell\webpublisher\templates

Modify the following lines:
Change
File.Upload.path=/novell/webaccess/temp
To
File.Upload.path=sys:/Novell/webaccess/temp

Change
Log.path=/novell/webpublisher/logs
To
Log.path=\\<server-name>\sys\Novell\webpublisher\logs

Change
Provider.GWDOC.Config.file=/novell/webpublisher/commgr.cfg
To
Provider.GWDOC.Config.file=\\<server-name>\sys\Novell\webpublisher\commgr.cfg

APACHE SETUP

Step 1 -- Copying files for WebAccess

z: will be used to denote a drive mapped to your NetWare server.

Copy the COM directory contained in your Software Distribution Directory <server>:\<volume>\internet\webacces\docs\ to the Apache document root (i.e. z:\apache\htdocs).

Step 2 -- Modifying Config Files

Create a copy of the configuration file z:\<apache-root>\conf\httpd.conf in the same directory, and rename it to gwapache.conf
Open the z:\<apache-root>\conf\gwapache.conf for editing. Add the following lines to the configuration file:

#
# The following line instructs Apache to load the jk module
#
Loa.dModule jk_module modules/mod_jk.nlm
JkWorkersFile "SYS:/tomcat/33/conf/jk/nwworkers.properties"
JkLogFile "SYS:/tomcat/33/logs/mod_jk.log"

#
# Log level to be used by mod_jk
#
JkLogLevel error

#
# Root context mounts for Tomcat
#
JkMount /*.jsp ajp12
JkMount /servlet/* ajp12

Create a text file in z:\system and name it gwwebup.ncf. Add the following line to the file:
load address space=GW apache -f sys:\apache\conf\GWApache.conf

Create a text file in z:\system and name it gwwebdn.ncf. Add the following line to the file:
unload address space=GW apache

Note: Don't forget to install the Webaccess Agent on the server.

For details or updates on this tip, see TID-10065572.

Like what you see?
Sign up for our weekly newsletter.

Want to contribute?
It could earn you a nano! Learn more.

Like Wikis?
Join the Cool Solutions Wiki.

Interested?
Request a sales call

Novell Cool Solutions (corporate web communities) are produced by WebWise Solutions. www.webwiseone.com