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
Copy the files contained in the Software Distribution Directory
Step 2 -- Modifying Config Files for WebAccess
Open the file z:\
<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
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.

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