Red Hat NETSCAPE ENTERPRISE SERVER 6.0 - NSAPI PROGRAMMER GUIDE Guide d'installation

ServletExec TM 5.0 Installation Guide for Microsoft Internet Information Server Netscape Enterprise Server iPlanet Web Server Sun ONE Web

2. MICROSOFT IIS PLUGIN (WINDOWS) OS Web Server Windows 2003 Internet Information Server (IIS) 6.0 Windows 2003 64-bit Edition Internet Informatio

2. MICROSOFT IIS PLUGIN (WINDOWS) 2.2.3.1 Multiple JDK/JRE Versions Installed You may have multiple versions of the JDK/JRE installed on your system.

2. MICROSOFT IIS PLUGIN (WINDOWS) See Section 2.5.4 for more information. 2.4 Running the ServletExec/ISAPI Installer Double-click the ServletExec/IS

2. MICROSOFT IIS PLUGIN (WINDOWS) Guide for instructions on running these examples. lib The lib subdirectory contains the Java archive (.jar) files r

2. MICROSOFT IIS PLUGIN (WINDOWS) The following User should be granted Full Control to the ServletExec ISAPI directory and its subdirectories: IUSR_&

2. MICROSOFT IIS PLUGIN (WINDOWS) To confirm your settings for IIS 1. In Internet Service Manager, open the Properties dialog for the virtual direct

2. MICROSOFT IIS PLUGIN (WINDOWS) 5. Right-click the server icon, and then click Properties. You should see a dialog similar to Figure 2. Make sure

2. MICROSOFT IIS PLUGIN (WINDOWS) Figure 3. ISAPI Filters (IIS 5.0) 8. Click any previously installed servlet engines, and then click Remove. 9.

2. MICROSOFT IIS PLUGIN (WINDOWS) Figure 4. Server Properties (IIS 4.0) 4. In Master Properties, click the ISAPI Filters tab (see Figure 5). 5. Cl

2. MICROSOFT IIS PLUGIN (WINDOWS) Figure 5. ISAPI Filters 2.6 ServletExec Admin Username & Password 2.6.1 Windows NT 4.0 and Windows 2000/XP/200

NEW ATLANTA COMMUNICATIONS, LLC ServletExecTM 5.0 Installation Guide October 24, 2003 Version 5.0 Copyright © 1997-2002 New Atlanta Communicatio

2. MICROSOFT IIS PLUGIN (WINDOWS) 4. Expand the Internet Services Manager entry until you can see the icon for your server. 5. Right-click the ser

2. MICROSOFT IIS PLUGIN (WINDOWS) to read and write to the file system because access to the NT File System (NTFS) is based on the user account of th

2. MICROSOFT IIS PLUGIN (WINDOWS) Using the Services control panel… 1. In Control Panel, click Services. 2. Click IIS Admin Service, and then click

33. ServletExec/NSAPI: NES/iWS/Sun ONE Plugin (Windows) Installing the Windows NT/2000/XP/2003 plugin servlet engine for Netscape Enterprise Server,

3. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (WINDOWS) To upgrade to a new version of ServletExec/NSAPI and maintain your old configuration setting

3. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (WINDOWS) 3.2 System Requirements 3.2.1 Operating System and Web Server • ServletExec/NSAPI 5.0 is no

3. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (WINDOWS) Important The JDK or JRE must be installed on a local drive and not on a mapped network driv

3. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (WINDOWS) 3.3 Uninstalling Other Servlet Engines Very Important You must uninstall any other servlet e

3. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (WINDOWS) 2. On the Server Manager page, click the Java tab. 3. On the Enable/Disable Servlets/JSP p

3. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (WINDOWS) • Registry entries for ServletExec/NSAPI were created or modified • The obj.conf and magnu

Contents 1. INTRODUCTION...1 1.1 SERVLETEX

3. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (WINDOWS) used by the installer. lib The lib sub-directory contains the Java archive (.jar) files requ

3. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (WINDOWS) 3.6.2 Registry Entries The ServletExec/NSAPI installer creates a new registry entry for each

3. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (WINDOWS) You must either: (a) make sure the ServletExec/NSAPI Init directives appear before these two

3. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (WINDOWS)  Completely Uninstall ServletExec to uninstall ServletExec/NSAPI for all NES/iWS/Sun ONE w

3. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (WINDOWS) # You can edit this file, but comments and formatting changes # might be lost when the admin

44. ServletExec/NSAPI: NES/iWS/Sun ONE Plugin (SPARC Solaris) Installing the SPARC Solaris plugin servlet engine for Netscape Enterprise Server, iPl

4. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (SPARC SOLARIS) To upgrade to a new version of ServletExec/NSAPI and maintain your old configuration s

4. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (SPARC SOLARIS) ServletExec/NSAPI 5.0 installed in the default location, the following lines should ap

4. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (SPARC SOLARIS) You can download the Sun JDKs for SPARC Solaris from: http://java.sun.com/j2se/ 4.2.2.

4. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (SPARC SOLARIS) 4.2.5 Disable the Built-In Servlet Engine (Sun ONE Web Server 6.1) For Sun ONE Web Ser

4.2.4 Disable the Built-In Servlet Engine (iWS 4.0 and higher)...33 4.2.5 Disable the Built-In Servlet Engine (Sun ON

4. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (SPARC SOLARIS) # ./ServletExec_NSAPI_50.sh 3. Review the ServletExec License Agreement carefully and

4. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (SPARC SOLARIS) https-<server-name> There is one https-<server-name> subdirectory for each

4. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (SPARC SOLARIS) or open directory structure. See the READ ME in the webapps directory and the Servlet

4. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (SPARC SOLARIS) 4.5.2.3 LD_PRELOAD The LD_PRELOAD environment variable must be set to explicitly load

4. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (SPARC SOLARIS) Init classpath=".." ldpath=".." fn="SJavaBootInit" Yo

4. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (SPARC SOLARIS)  Completely Uninstall ServletExec to uninstall ServletExec/NSAPI for all NES/iWS/Sun

4. SERVLETEXEC/NSAPI: NES/IWS/SUN ONE PLUGIN (SPARC SOLARIS) # You can edit this file, but comments and formatting changes # might be lost when the

55. ServletExec/AS: Application Server (Windows) Installing the Windows NT/2000/XP/2003 web server adapters for Microsoft IIS, Netscape Enterprise Se

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) To upgrade to ServletExec/AS 5.0 from 3.0 or 3.1 and maintain your old configuration settings 1. Stop y

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) OS Web Server Windows 2003  Microsoft IIS 6.0  iPlanet Web Server (iWS) 4.0 and higher  Sun ONE

6.4 RUNNING THE SERVLETEXEC/AS INSTALLER ...72 6.5 WHAT WAS INSTALLED AND/OR MODIFIED? .

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) • JDK/JRE for Windows 1.3 from IBM Important The JRE does not contain a Java compiler, which is require

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) 2. Read the CurrentVersion variable from the key found in Step 1. Currently, the only valid values for

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) Important You must install at least one web server adapter whenever you install a ServletExec/AS instanc

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) Important Do NOT move or rename the folder you choose after ServletExec/AS is installed. 5. Enter an In

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) 7. Before making any change to your computer, the ServletExec/AS installer displays a confirmation dial

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) 9. Update the server configuration file. If you’re installing a web server adapter for Netscape Enterpr

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) Documentation Contains the ServletExec User Guide, and the Servlet 2.4 and JSP 2.0 API documentation fro

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) Servlets This subdirectory contains the class files for legacy servlets hosted by ServletExec/ISAPI. The

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) To examine or manually modify the metabase ISAPI Filter under IIS 5.0/5.1/6.0 1. Click Start, point to

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) Figure 15. ISAPI Filters (IIS 5.0) To examine or manually modify the metabase ISAPI Filter under IIS 4.

11. Introduction Installing ServletExec 5.0 (all product configurations) ewwePaby Sun Mic Atlanta ServletExec 5.0 is a high-performance, reliable, an

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) Figure 16. Server Properties (IIS 4.0) 4. In Master Properties, click the ISAPI Filters tab (see Figur

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) Figure 17. ISAPI Filters 5.5.3.3 The webadapter.properties Configuration File The webadapter.properties

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) 5.5.4.1 Server Configuration Files To install a ServletExec/AS web server adapter for NES/iWS/Sun ONE, m

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) Service method=(GET|HEAD|POST) type=magnus-internal/nac fn="ServletExecService" Figure 18 and

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) # You can edit this file, but comments and formatting changes # might be lost when the admin server make

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) Important If you chose not to allow the installer to make these modifications, you must make them manual

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) when the pool is empty and another request is received… default setting is 5). Once the pool max idle l

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) 5.7.1 Starting ServletExec/AS A ServletExec/AS instance is a standalone Java application that communicat

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) Argument Explanation which the ServletExec/AS instance communicates with the web server adapter(s). If

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) Argument Explanation -addl <url=directory> Optional. This can be used to specify additional docum

1. INTRODUCTION - ServletExec/AS is available for Windows NT/2000/XP/2003 and various UNIX platforms, including SPARC Solaris, Linux, HP-UX, and AIX.

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) 5.7.2 Stopping ServletExec/AS You must stop a ServletExec/AS instance using the StopServletExec.bat file

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) web server adapters running on the local machine. It is possible to install and configure web server ada

5. SERVLETEXEC APPLICATION SERVER (WINDOWS) See either the Virtual Servers chapter or the Servlet Alias section in the ServletExec User Guide for de

66. ServletExec/AS: Application Server (UNIX/Linux) Installing the UNIX web server adapters for Netscape Enterprise Server, iPlanet Web Server, Sun

6. SERVLETEXEC/AS: APPLICATION SERVER (UNIX/LINUX) To upgrade to ServletExec/AS 5.0 from 3.0 or 3.1 and maintain your old configuration settings 1.

6. SERVLETEXEC/AS: APPLICATION SERVER (UNIX/LINUX) OS Web Server SPARC Solaris 2.6, 7, 8 and 9  Netscape Enterprise Server (NES) 3.5.1 and higher

6. SERVLETEXEC/AS: APPLICATION SERVER (UNIX/LINUX) fail, ServletExec is not fully supported in these environments. Correcting these types of problem

6. SERVLETEXEC/AS: APPLICATION SERVER (UNIX/LINUX) 6.3 Uninstalling Other Servlet Engines Very Important You must uninstall any other servlet engines

6. SERVLETEXEC/AS: APPLICATION SERVER (UNIX/LINUX) 6.5.1 The ServletExecAS Directory The ServletExecAS directory was created within the /usr/local/Ne

6. SERVLETEXEC/AS: APPLICATION SERVER (UNIX/LINUX) The se-<instance-name> subdirectories of the ServletExecAS directory each contain the follow

22. ServletExec/ISAPI: Microsoft IIS Plugin (Windows) Installing the plugin servlet engine for Microsoft Internet Information Server ervSeenin a sta

6. SERVLETEXEC/AS: APPLICATION SERVER (UNIX/LINUX) Important If you chose not to allow the installer to make these modifications, you must make them

6. SERVLETEXEC/AS: APPLICATION SERVER (UNIX/LINUX) Important You must stop and restart the NES/iWS/Sun ONE web server after modifying the configurati

6. SERVLETEXEC/AS: APPLICATION SERVER (UNIX/LINUX) # You can edit this file, but comments and formatting changes # might be lost when the admin serve

6. SERVLETEXEC/AS: APPLICATION SERVER (UNIX/LINUX) Important If you chose not to allow the installer to make these modifications, you must make them

6. SERVLETEXEC/AS: APPLICATION SERVER (UNIX/LINUX) when the pool is empty and another request is received… default setting is 5). Once the pool max

6. SERVLETEXEC/AS: APPLICATION SERVER (UNIX/LINUX) 6.7.1 Starting ServletExec/AS A ServletExec/AS instance is a standalone Java application that comm

6. SERVLETEXEC/AS: APPLICATION SERVER (UNIX/LINUX) Argument Explanation the ServletExec/AS instance communicates with the web server adapter(s). If

6. SERVLETEXEC/AS: APPLICATION SERVER (UNIX/LINUX) Argument Explanation directory> -addl <url=directory> Optional. This can be used to spec

6. SERVLETEXEC/AS: APPLICATION SERVER (UNIX/LINUX) arguments. A complete list of StopServletExec command line arguments is provided below. 6.7.2.2 Us

6. SERVLETEXEC/AS: APPLICATION SERVER (UNIX/LINUX) See Section 6.4 for more information. 3. Enter the name, IP address, and port number of the Servl

2. MICROSOFT IIS PLUGIN (WINDOWS) stop_iis.bat command file or, (c) click Restart IIS in the Internet Services Manager administrative tool. 2. Close

6. SERVLETEXEC/AS: APPLICATION SERVER (UNIX/LINUX) 6.8 Uninstalling ServletExec/AS To uninstall ServletExec/AS or a web server adapter 1. Re-run the