Red Hat NETSCAPE ENTERPRISE SERVER 6.0 - PROGRAMMER GUIDE TO SERVLETS User Manual

Sun Java SystemWeb Server 6.1SP9 Installation and MigrationGuideSun Microsystems, Inc.4150 Network CircleSanta Clara, CA 95054U.S.A.Part No: 820–5707F

TABLE P–2 Sun Java System Web Server Documentation Roadmap (Continued)For Information About See the FollowingUsing programming technologies and APIs t

New Features in Sun Java System Web Server6.1Sun Java System Web Server is a multi-process, multi-threaded, secure web server built on openstandards.

Easy Migration—Sun Java System Web Server 6.1 allows easy migration from iPlanet WebServer versions 4.1 and 6.0. WebDAV Support—Sun Java System Web S

New Search Engine Support— Sun Java System Web Server 6.1 supports a new Java-basedsearch engine that provides full-text search indexing and retrieva

PHP version 4.3.2 is recommended for use with Sun Java System Web Server 6.1. ForPHP-related installation and conguration information specic to Sun

BeforeYou Install Sun Java SystemWeb ServerThe following sections provide the information you need to know before you install Sun JavaSystem Web Serve

TABLE 2–1 Sun Java System Web Server 6.1 SP8 Supported Platforms (Continued)Vendor Architecture Operating SystemMinimumRequiredMemoryRecommendedMemory

TABLE 2–1 Sun Java System Web Server 6.1 SP8 Supported Platforms (Continued)Vendor Architecture Operating SystemMinimumRequiredMemoryRecommendedMemory

Required PatchesYou are recommended to update your operating system with the latest applicable patches.For the Solaris OE platform, Sun's recomme

Windows If you plan on running more than two separate instances of Sun Java System Web Server onyour system, an additional 16 MB RAM for each server i

Copyright 2008 Sun Microsystems, Inc. 4150 Network Circle, Santa Clara, CA 95054 U.S.A. All rights reserved.Sun Microsystems, Inc. has intellectual pr

the owner. It is best to create a UNIX or Linux account for the server that has restricted access toyour system resources. The account needs read perm

Note – It is strongly recommended that you use a dedicated account for the server.Choosing Unique Port NumbersYou need multiple port numbers: one for

▼To install Sun Java System Web ServerIf you have iPlanet Web Server 4.1 already installed and plan to migrate that server to work withSun Java System

Installing Sun Java System Web Server on UNIXThis chapter tells you how to install Sun Java System Web Server on UNIX systems. It containsthe followin

If you meet these conditions, you do not need to log in as root to install the server; insteadlog in as the user account that the Administration Serve

Change to the directory on your UNIX machine where you copied the le. For example:cd /tmp/SUNWwbinstallUntar the le by typing tar -xvf lename. For

template.inf.Note – Untarring the le will cause the permissions of the destination directory to bemodied so that applications can no longer write 

Choose whether you accept the software license agreement by typing Yes to accept, or No todecline. If you have not yet read the license agreement, can

Enter the Administration Server user name and password to use for authentication. You areasked to enter your password twice. Press Enter.Type the Admi

The JDK must already exist in the specied directory.If the custom JDK is located in a directory with a standard tree structure, you can press Enter t

ContentsPreface ...

Installation Setting Valuesubcomponents All default subcomponents installedCaution – You must log in as root to use Express installation.If you are no

Go to the https-adminserv directory under your server root directory (for example,/opt/SUNWwbsvr/) and start Administration Server by typing ./start.

For example, if the remote machine is host1 on the domain do gs, and you are logged in asroot, enter the following information:host1.docs.com rootIn t

Enter the installation setting: HostNames: the name of the host where the web server will be installed, separated bycommas. For example:host1,host2,ho

The following is an example of the template.inf le:[ MachineName]HostNames = draco.sunComponents=webcore,snmp,cleanupSetUpLocation=/Sun/WebServer/P20

Caution – The install.inf le contains the password used to log on to the AdministrationServer. The password is not encrypted; it is in plain text. If

JDK_DIR= /Sun/WebServer/bin/https/jdkJDK_LIBPATH=AdminSysUser= rootAdminName= adminAdminPassword= adminCompVersions= 2:2:1:0:0:Components= webcore,JDK

Default Sun Java SystemWeb Server DirectoriesWhen you install the Sun Java System Web Server product, two web server instances areinstalled by default

Note – The uninstall program does not remove every server le. For example, it does not removekeys and certicates, conguration les, logs, ACL les

Installing Sun Java System Web Server onWindowsThis chapter provides information on how to install Sun Java System Web Server on Windows.It contains t

▼ To install using templatized installation ... 31▼ To install using s

Note – If you have previous versions of Netscape or Sun Java System web servers installed, you mustinstall your 4.x iPlanet Web Server in a dierent s

▼To run setup.exeRun the setup.exe program to install Sun Java System Web Server.Double-click the setup.exe le.TheWelcome screen appears. After readi

Caution – Ensure that the path to which you install the Web Server has no spaces in its name. Forexample, do not choose the C:\Program Files directory

The Default Web Server dialog box appears. A default instance of Sun Java System Web Server isinstalled automatically.Type a port number for the defau

You can start the Administration Server in either of the following ways: Select Start Menu -> Programs -> Sun Java System Web Server, and choose

Caution – The install.inf le contains the password used to log on to the Administrationserver. The password is not encrypted; it is in plain text. If

The server is installed.The following is an example of an install.inf le.[General]Components=svrcore,WebServerServerRoot=d:\servers\s1ws61-0815[WebSe

Default Sun Java SystemWeb Server DirectoriesWhen you install the Sun Java System Web Server product, two web server instances areinstalled by default

48

Migrating Web Server fromVersion 6.0 to 6.1This chapter contains migration information, the changes that take place when you migrate theWeb Server fro

Web Publishing Using WebDAV ... 636 Migrating from Web Ser

Migrating Settings and DataCaution – Shut down the server instances before migrating.▼To migrate settings and data from a 6.0 to the Sun JavaSystemWeb

Sun Java System Web Server detects whether there are server instances installed in the directoryyou specied and displays the servers you can migrate

The sections on the form that you see depend upon which features your 6.0 Web Server is usingand which components you installed. The following section

What Does Not Get MigratedThe migration process does not migrate the following: 4.x-style legacy servletsSee“Legacy Servlets” on page 59 for more info

“Security” on page 60 “Session Managers” on page 61 “Symbolic Links in Conguration Files (UNIX and Linux)” on page 62 “Web Applications” on page 62

Conguration FilesThe following table provides a summary listing of the conguration les in Sun Java SystemWeb Server 6.1. It describes the changes i

Conguration File Description For more information, see:magnus.conf Location: server-id/config Denes server plug-ins library initializationand server

Conguration File Description For more information, see:obj.conf Location: install-dir/config/ Contains instructions for the server on howto handle HT

Conguration Files Removed in Sun Java System Web Server 6.1The following conguration les are no longer supported and are removed during migration:

During migration you can choose to install either the JDK that is bundled with Sun Java SystemWeb Server 6.1 (JDK 1.4.2_13) or install a custom JDK. I

6

iPlanet Web Server 6.0 supported both types of deployment schemes, but the 4.ximplementation (referred to as legacy servlets) was marked as deprecated

Session ManagersThe Simple Session Manager and JDBC Session Manager that were deprecated in the version6.0 release of Sun Java System Web Server are n

Symbolic Links in Conguration Files (UNIX and Linux)Symbolic or relative links in server conguration les might cause problems when upgrading.Ensure

<session-manager><manager-properties><property name=”reapIntervalSeconds” value=”180”></manager-properties></session-manage

64

Migrating fromWeb Server Version 4.1 to 6.1This chapter contains migration information to help, when you migrate your Sun Java SystemWeb Server from v

Note – Direct migration from a version of iPlanet Web Server that is lower than 4.1 to Sun JavaSystem Web Server 6.1 is not supported. You must rst m

Enter the server root of the server from which you want to migrate and click Search. Forexample:/usr/netscape/server4C:\netscape\server4Sun Java Syste

In the new Migration parameters window that is launched, specify the migration parameters.The sections on the form that you see depend upon which feat

General Migration Parameters Document Root JavaFor more information, see The Migration Parameters Page in the online help.Click Migrate.The Migrate s

PrefaceThis guide explains how to install Sun JavaTMSystem Web Server 6.1 and migrate from aprevious version of the Sun Java System Web Server to this

Click Congure Migrated Server to congure your migrated server instance in the ServerManager, or click Close to close the migration window.The Migrat

Migrating CerticatesThe migration process copies the database les in the 4.1_server_root/alias directory, such askey3.db and cert7.db, to the 6.1_se

What Does Not Get MigratedThe migration process does not migrate the following: 4.1-style legacy servletsSee“Java Servlets” on page 73 for more inform

Access and Error LogsThe access and error server log les records the activity of the Server. During migration, newaccess logs are created. Error logs

Sun Java System Web Server 6.1 does not support Legacy Servlets. The legacy-style propertiesles for the server you want to migrate - servlet.properti

The package name of the MMapSessionManager has been changed fromcom.netscape.server.http.session in the 4.1 version of the Web Server tocom.iplanet.se

See the Sun Java System Web Server 6.1 SP9 Programmer’s Guide to Web Applications for anappendix explaining how to convert SSJS applications to JSPs.

IndexNumbers and Symbols4.x-style legacy servlets, 53AACLs, migrating, 70Administration interface, more information about, 9authentication, 60Authoriz

installing (Continued)JDK, 27, 42overview, 21preparation for, 15Unix, 23-31express, 29-31typical or custom, 26-29uninstall, 37-38user account needed f

migration (Continued)from iPlanet web Server 6.0*.cllter les, 57ACL les, 55certicate mappings, 53certmap.conf, 55cgistub directory, 53, 54command

TABLE P–1 How to Use This Guide (Continued)If you want to do this: See:Migrate your data andapplications from iPlanet WebServer 6.0.Chapter 5, Migrati

Ttechnical requirements, 19-21template.inf, 31templatized installation, 31UuninstallUnix, 37-38Windows, 47Unix installation, 23-31Unix user accounts,

TABLE P–2 Sun Java System Web Server Documentation Roadmap (Continued)For Information About See the FollowingGetting started with Sun Java System Web