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 6 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 Windows NT operating system.
Note: If your web server resides on a UNIX machine, see the UNIX version of the Installation Guide for information on how to install the Netscape Application Server Web Connector plug-in.
You must be logged on to Windows NT as an administrator before installing Netscape Application Server Web Connector plug-in.
To install the Netscape Web Connector plug-in
After you finish installing Netscape Application Server as a webless installation, take the Netscape Application Server Install CD-ROM to the web server machine or machines.
Insert the Netscape Application Server Install CD-ROM in the CD-ROM drive of the web server machine.
Start the installation program by running the file setup.exe under the NT directory.
When prompted for the software you want to install, click Netscape Application Web Connector.
When prompted for the target installation directory, enter the directory name. The default directory is c:\nas21\.
You cannot use a directory name that includes spaces.
Click your type of web server.
If you have multiple instances of the web server running on this machine, click the one you want the Connector plug-in to communicate with.
Specify the location of the web server's HTML files.
Specify the location of the web server's CGI programs.
Specify the IP address of the machine where Netscape Application Server is installed. This is a separate machine from the one where you are currently installing the Web Connector plug-in.
Specify the Executive Server (KXS) port number of the Netscape Application Server that the Web Connector will work with.
Specify the program folder for the Web Connector plug-in. The default is Netscape Application Server 2.1.
Review the Web Connector plug-in configuration list.
When the installation program finishes running, reboot the web server machine.
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.
You must be logged on as the same administrator user who installed the web server.
Note: If you web server is installed on a UNIX machine, see the UNIX version of the Netscape Application Server Installation Instructions for information about how to manually configure a web server.
To reconfigure the Netscape web server
Enable CGI, if it is not already enabled:
Go to the Netscape program group and click Administer Netscape Servers.
Enter the administrator ID and password, and click OK.
On the Netscape Server Selector screen, click on the web server instance you want to configure.
On the main menu bar across the top of the page, click Programs.
On the CGI directory screen under URL prefix, type cgi-bin.
Under CGI directory, enter the cgi-bin path.
For Netscape Enterprise Server 2.x:
<drive letter>:/Netscape/Server/docs/cgi-bin
For Netscape Enterprise Server 3.x and higher:
<drive letter>:/Netscape/SuiteSpot/docs/cgi-bin
Now, you are ready to configure the Web Connector plug-in.
Edit the obj.conf file in the web server configuration directory.
For example:
Netscape Enterprise Server 2.x:
<drive letter>:\Netscape\Server\httpd-<machinename>\config
Netscape Enterprise Server 3.x:
<drive letter>:\Netscape\SuiteSpot\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="<path
to NAS bin dir>/<example: gxnsapi351.dll>"
Init fn="gxinit"
The following table shows what you can specify for shlib.
In the Object name=default section, just after type=text/plain section, add the following two lines:
Service fn="gxhtmlrequest" method="(GET|HEAD)" type="text/html"
Service fn="gxredirect" fnname="imagemap" method="(GET|HEAD)"
In the Objectname=cgi section(s), insert the following line immediately before the line Service fn="send-cgi":
Service fn="gxrequest"
And then insert the following line immediately after the line Service
fn="send-cgi":
AddLog fn="gxlog"
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:
<drive_letter>:\Netscape\SuiteSpot\https-<machinename>\conf_bk
Restart the web server.
Reconfiguring the Microsoft Internet Information Server
Keep in mind the following information when reconfiguring Microsoft IIS:
Previous
