Administration Guide
Overview Guide
Installation Guide
Previous Next Contents



Installing the Netscape Application Server Web Connector Plug-in
The Netscape Application Server Web Connector plug-in passes requests from the web server to applications on the Netscape Application Server.

Netscape provides Web Connector plug-ins for the following web servers:

See "Checking Hardware and Software Requirements" on page 38 for information about the supported versions.

If you install Netscape Application Server on a different machine than where the web server resides, you are configuring what is referred to as a "webless installation" of Netscape Application Server. If this is the case, you must install the Netscape Application Server Web Connector plug-in on the web server machine.

Use the following procedure to install the Netscape Application Server Web Connector plug-in on a machine running the Solaris or HPUX operating system.

Before you install the Web Connector plug-in, do the following:

Note: If your web server resides on a Windows NT machine, see the Windows NT version of the Installation Guide for information on how to install the Netscape Application Server Web Connector plug-in.

To install the Web Connector plug-in

  1. After you finish installing Netscape Application Server as a webless installation, take the installation CD-ROM to the machine or machines that host the web server.
  2. Mount the CD-ROM on, for example, /cdrom/cdrom0.
    1. Create a directory (for example, nas21).
    2. Change to that directory.

  3. At the shell prompt, type the following command:

setup_WebConnector.sh

The Web Connector installation program starts.

  1. Follow the Web Connector installation program instructions to complete the installation.
  2. When the installation program prompts you for the web server directory, be sure to specify the directory of the appropriate web server instance.

Manually Configuring a Web Server
When you install Netscape Application Server, your web server is automatically configured for the Web Connector plug-in, meaning that all the necessary directories and settings on the web server are updated. However, there may be occasions, when, after you've installed the Web Connector plug-in, you must manually re-configure the web server. This procedure is recommended only if you are having problems with the connection between Netscape Application Server and your web server.

The following steps explain how to manually configure a web servers to use the Web Connector plug-in, whether your web server resides on the same or a different machine than where the Netscape Application Server is installed.

If you perform only Step 1 (enabling CGI) of this procedure, the Web Connector will run as a CGI script. If you perform the entire procedure, the Web Connector will run as a plug-in, which is more efficient since a plug-in is faster than a CGI script.

Note that all CGI environment variables are automatically sent to a Netscape Application Server AppLogic, so you do not have to modify the registry on the web server machine. However, if any special HTTP/CGI variables need to be retrieved by the Web Connector plug-in and sent to the AppLogic, then you must add them to the registry.

For Netscape Enterprise Server 3.6, if the Web Administrator server is installed by the root user, you must log on as the root user, or as a user from the same group as the root user, to bring up the web server

Note: If you web server is installed on a Windows NT machine, see the Windows NT version of the Netscape Application Server Installation Instructions for information about how to manually configure a web server.

To reconfigure the Netscape web server

  1. Enable CGI, if it is not already enabled:
    1. Go to the Netscape program group and click Administer Netscape Servers.
    2. Enter the administrator ID and password, and click OK.
    3. On the Netscape Server Selector screen, click on the web server instance you want to configure.
    4. On the main menu bar across the top of the page, click Programs.
    5. On the CGI directory screen under URL prefix, type cgi-bin.
    6. Under CGI directory, enter the cgi-bin path.

    <server home dir>/docs/cgi-bin

    Now, you are ready to configure the Web Connector plug-in.

  2. Edit the obj.conf file in the web server configuration directory.
  3. For example:

    Netscape Enterprise Server 2.x:

    <server home dir>/httpd-<machinename>/config

    Netscape Enterprise Server 3.x:

    <Netscape home dir>/https-<machinename>/config

    Make a copy of the file before modifying it. At the end of the Init section of the obj.conf file, add the following as two lines:

    Init fn="load-modules" funcs=gxrequest,gxlog,gxinit,gxredirect,gxhtmlrequest shlib="gxnsapi30.so"

    Init fn="gxinit"

The following table shows what you can specify for shlib.

Platform
Web Server
shlib =
Solaris
Netscape Enterprise Server 2.0.1
<NAS root>/gxlib/libgxnsapi201.so

Netscape Enterprise Server 3.6
<NAS root>/gxlib/libgxnsapi30.so
HPUX
Netscape Enterprise Server 3.6
<KIVA root >/javalib/libgxnsapi30.so

  1. In the Object name=default section, just after type=text/plain section, add the following two lines:
  2. Service fn="gxhtmlrequest" method="(GET|HEAD)" type="text/html"

    Service fn="gxredirect" fnname="imagemap" method="(GET|HEAD)"

  3. In the Objectname=cgi section(s), insert the following line immediately before the line Service fn="send-cgi":
  4. Service fn="gxrequest"

    And then insert the following line immediately after the line Service fn="send-cgi":

    AddLog fn="gxlog"

  5. Make a copy of the current version of the file obj.conf and copy it to the back up version (so that the backup is consistent with the current version) in the following directory:
  6. <Netscape home dir>/https-<machinename>/conf_bk

  7. Modify the web server's start and stop scripts as follows:
In the start script:

Solaris
HPUX

Solaris and HPUX

  1. Restart the web server.
 

© Copyright 1998 Netscape Communications Corporation