Upgrading a NetWare 5.1 server running Novell Portal Services 1.0 to NetWare 6

(Last modified: 16Aug2002)

This document (10066693) is provided subject to the disclaimer at the end of this document.

goal

fact

Novell NetWare 6.0

Novell NetWare 5.1 Support Pack 3 (NW51SP3.EXE)

Novell Portal Services 1.0 (Support Pack 1 or 2)

Novell Portal Services 1.01

Apache Web Server

Tomcat Web Application Server

change

In-place upgrade from NetWare 5.1 to NetWare 6

cause

Novell Portal Services 1.0 was released prior to NetWare 6. The NPS installation script was not written to accomodate NetWare 6 upgrades or installations.

fix

After upgrading a NetWare 5.1 server running NPS 1.0 (with Support Pack 1 or 2) or NPS 1.01 to NetWare 6, you need to be aware of the following post-upgrade configuration steps:

Note: This document assumes that Apache is listening on port 80/443. Depending on your installation and configuration of NW6, Apache may be listening on different port. (I.e. port 51080/51443) If you install Apache on a port other than port 80/443, you must include the specified port in the URL. I.e. http://192.168.0.1:51080/nps)
This document also assumes that you are running the Tomcat web application server from the default location. (SYS:\Tomcat\33\conf)
It is highly recommended that you have NetWare 5.1 Support Pack 3 (or later) applied prior to doing an in-place migration to NetWare 6.

1. Move or copy the existing NPS directory from SYS:\tomcat\webapps\nps to SYS:\webapps\nps

2. Using a text editor, open SYS:\tomcat\conf\Mod_jk.conf-nw and cut and paste the Portal Services content to SYS:\apache\conf\Adminserv.conf.

Note: In theory, the NPS section can reside anywhere outside the virtual host section of the adminserv.conf file. (Recent experience shows that it works better after the virtual host block or at the bottom of Adminserv.conf.)

(Below is a snippet from the Adminserv.conf file. Please note the changes that need to be made to the Novell Portal Services content in steps 3 and 4.)

###################
# NOVELL PORTAL SERVICES BEGIN #
###################
#
# The following line makes apache aware of the location of the portal context
#
Alias /nps "sys:tomcat\webapps\nps"
<Directory "sys:tomcat\webapps\nps">
    Options Indexes FollowSymLinks
    AllowOverride None
    Order deny,allow
    Allow from all
</Directory>

#
# The following line mounts all JSP files and the /servlet/ uri to tomcat
#
JkMount /nps/servlet/* ajp12
JkMount /nps/*.jsp ajp12

#
# The following line prohibits users from directly accessing WEB-INF
#
<Location "/nps/WEB-INF/">
    AllowOverride None
    deny from all
</Location>
#
# Use Directory too. On Windows, Location doesn't work unless case matches
#
<Directory "sys:tomcat\webapps\nps/WEB-INF/">
    AllowOverride None
    deny from all
</Directory>

#
# The following line prohibits users from directly accessing META-INF
#
<Location "/nps/META-INF/">
    AllowOverride None
    deny from all
</Location>
#
# Use Directory too. On Windows, Location doesn't work unless case matches
#
<Directory "sys:tomcat\webapps\nps/META-INF/">
    AllowOverride None
    deny from all
</Directory>
###################
# NOVELL PORTAL SERVICES END   #
###################

3. Find the following two lines in the Novell Portal Services section:

JkMount /nps/servlet/* ajp12
JkMount /nps/*.jsp ajp12

**Change the ajp protocol versions from 12 to 13 as follows:**

JkMount /nps/servlet/* ajp13
JkMount /nps/*.jsp ajp13

4. Find the 1 Alias statement and 3 Directory entry path statements in the Novell Portal Services section:

Alias /nps "sys:tomcat\webapps\nps"
<Directory "sys:tomcat\webapps\nps">
    Options Indexes FollowSymLinks
        AllowOverride None
    Order deny,allow
        Allow from all
</Directory>

<Directory "sys:tomcat\webapps\nps/WEB-INF/">
AllowOverride None
deny from all
</Directory>

<Directory "sys:tomcat\webapps\nps/META-INF/">
AllowOverride None
deny from all
</Directory>

**Change the directory entry path from SYS:Tomcat/Webapps to SYS:Webapps as follows:**

Alias /nps "sys:webapps\nps"
<Directory "sys:webapps\nps">
    Options Indexes FollowSymLinks
    AllowOverride None
    Order deny,allow
    Allow from all
</Directory>

<Directory "sys:webapps\nps/WEB-INF/">
AllowOverride None
deny from all
</Directory>

<Directory "sys:webapps\nps/META-INF/">
AllowOverride None
deny from all
</Directory>

5. In the SYS:\TOMCAT\33\CONF subdirectory create a file named nwapps-nps.xml with the following contents or copy & modify the contents of nwapps-webaccess.xml:
(Note: You must create this file so that tomcat knows how to load NPS.)

<?xml version="1.0" encoding="ISO-8859-1" ?>
<webapps>
     
    <Context path="/nps"
        docBase="SYS:/webapps/nps"
        debug="0"
        reloadable="false" >
    </Context>
</webapps>

Optional Step: If you are currently running NetWare WebAccess, you may want to disable WebAccess to avoid any confusion. Although WebAccess can be run in parallel with NPS, you may prefer to have Apache ONLY use the full blown NPS installation and discontinue using NetWare WebAccess altogether.

- To accomplish this, you will need to modify the Adminserv.conf file located in: SYS:apache\conf.
- Search for nwwaApache.conf in this file and comment it out by putting a # in front of the include statement:
#Include sys:/webapps/webaccess/web-inf/nwwaApache.conf
(Note: By putting in this comment, you have disabled NetWare WebAccess from being accessible.)

6. Restart Apache & Tomcat -or- preferably reboot the server.

7. To verify Novell Portal Services is configured properly, point your browser to: http://YourIPaddressORDomainName/nps/
(Note: Please replace "YourIPaddressORDomainName" with the actual IP address or DNS name on which your Apache web server is listening.).

document

Document Title:	Upgrading a NetWare 5.1 server running Novell Portal Services 1.0 to NetWare 6
Document ID:	10066693
Solution ID:	NOVL65790
Creation Date:	10Dec2001
Modified Date:	16Aug2002
Novell Product Class:	Web Services

disclaimer

The Origin of this information may be internal or external to Novell. Novell makes all reasonable efforts to verify this information. However, the information provided in this document is for your information only. Novell makes no explicit or implied claims to the validity of this information.
Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information.