Red Hat NETSCAPE ENTERPRISE SERVER 6.1 - PROGRAMMER GUIDE TO SERVLETS Manuel d'utilisateur Page 1

Installation and Migration GuideSun™ ONE Web ServerVersion 6.1817-6245-10April 2004

Using the Documentation10 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004Performing the following administration tasks:• Using

Product SupportAbout This Guide 11Product Support If you have problems with your system, contact customer support using one of the following mechanism

Product Support12 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004

13Chapter 1New Features in Sun ONE WebServer 6.1Sun ONE Web Server is a multi-process, multi-threaded, secure web server built on open standards. It p

14 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004• JDK 1.4.1_03 Support—Sun ONE Web Server 6.1 supports the Java Developer&apo

Chapter 1 New Features in Sun ONE Web Server 6.1 15• JDBC Support— Sun ONE Web Server provides out-of-the-box seamless Java™ Database Connectivity (JD

16 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004For more information about Sun ONE Studio 5, visithttp://www.sun.com/software

17Chapter 2Before You Install Sun ONE WebServerThe following sections provide the information you need to know before you install Sun ONE Web Server.T

Supported Platforms18 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004Table 2-1 Sun ONE Web Server 6.1 Supported PlatformsVendor

Required PatchesChapter 2 Before You Install Sun ONE Web Server 19*Supported via binary compatibility. **As of iPlanet Web Server 6.0, older SPARC CPU

Sun Microsystems, Inc.4150 Network CircleSanta Clara, CA 95054 U.S.A.Copyright 2004 Sun Microsystems, Inc. All rights reserved. Sun, Sun Microsystems,

Other Technical Requirements20 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004All Platforms• Java and cookies enabled in your b

Other Technical RequirementsChapter 2 Before You Install Sun ONE Web Server 21• You have two port numbers - one for the Administration Server and the

Other Technical Requirements22 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004The Administration Server can also run with a use

Installation OverviewChapter 2 Before You Install Sun ONE Web Server 23Choosing Unique Port NumbersYou need multiple port numbers: one for the Adminis

Installation Overview24 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 20041. If you have iPlanet Web Server 4.1 already installed

25Chapter 3Installing Sun ONE Web Server onUNIXThis chapter tells you how to install Sun ONE Web Server on UNIX systems. It contains the following sec

Installing on UNIX Platforms26 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004• The location where you plan to install the serv

Installing on UNIX PlatformsChapter 3 Installing Sun ONE Web Server on UNIX 276. Change to the directory on your UNIX machine where you copied the fil

Installing on UNIX Platforms28 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 20044. Untar the unzipped file by typing tar -xvf fil

Installing on UNIX PlatformsChapter 3 Installing Sun ONE Web Server on UNIX 29• Press CTRL+B to return to a previous screen (note that this sequence d

3ContentsAbout This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Installing on UNIX Platforms30 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004❍ Java Development Kit. Sun ONE Web Server 6.1 pr

Installing on UNIX PlatformsChapter 3 Installing Sun ONE Web Server on UNIX 3111. Type the Administration Server port number or accept the default of

Installing on UNIX Platforms32 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 200416. After the installation program extracts and i

Installing on UNIX PlatformsChapter 3 Installing Sun ONE Web Server on UNIX 33To run setup, follow these steps:1. If you are not in the directory alre

Installing Across Multiple Machines34 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 200412. Go to the https-adminserv directory un

Installing Across Multiple MachinesChapter 3 Installing Sun ONE Web Server on UNIX 35To run templatized installation, perform the following steps:1. I

Installing Across Multiple Machines36 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004❍ HostNames: the name of the host where th

Installing Across Multiple MachinesChapter 3 Installing Sun ONE Web Server on UNIX 379. Run the installation wrapper by typing the following command a

Installing Across Multiple Machines38 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004Using Silent InstallationSilent installati

Installing Across Multiple MachinesChapter 3 Installing Sun ONE Web Server on UNIX 397. The server is installed.The following is an example of an inst

4 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004Unpacking the Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Default Sun ONE Web Server Directories40 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004Default Sun ONE Web Server DirectoriesW

Using Uninstall on UNIXChapter 3 Installing Sun ONE Web Server on UNIX 41To remove your Sun ONE Web Server:1. Go to your server root and type ./uninst

Using Uninstall on UNIX42 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004

43Chapter 4Installing Sun ONE Web Server onWindowsThis chapter tells you how to install Sun ONE Web Server on Windows. It contains the following secti

Installing on Windows44 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004• Because of DLL conflicts, if you install Sun ONE Web S

Installing on WindowsChapter 4 Installing Sun ONE Web Server on Windows 453. The Software License Agreement appears. Click Yes to accept the license.4

Installing on Windows46 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 20045. The Location of Installation dialog box appears. The

Installing on WindowsChapter 4 Installing Sun ONE Web Server on Windows 478. Type the user name for Administration Server access; the default is admin

Installing on Windows48 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 200411. The JDK Configuration dialog box appears. You can us

Using Silent InstallationChapter 4 Installing Sun ONE Web Server on Windows 49❍ From the Control Panel’s Services item.To start the servers automatica

5Chapter 6 Migrating from Version 4.1 to 6.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Migration Overview . .

Using Silent Installation50 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004Because Sun ONE Web Server is downloaded as a self-e

Using Silent InstallationChapter 4 Installing Sun ONE Web Server on Windows 51The following table shows some useful install.inf parameters to edit. Fo

Default Sun ONE Web Server Directories52 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004Default Sun ONE Web Server DirectoriesW

Using Uninstall on WindowsChapter 4 Installing Sun ONE Web Server on Windows 534. When the uninstall is complete, a message appears saying that the co

Using Uninstall on Windows54 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004

55Chapter 5Migrating from Version 6.0 to 6.1This chapter contains migration information to help you understand the changes that take place when you mi

Migrating Settings and Data56 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004• Access Control List (ACL) information• Secure So

Migrating Settings and DataChapter 5 Migrating from Version 6.0 to 6.1 572. Click Migrate Server.Migrate Server Page3. Enter the server root of the se

Migrating Settings and Data58 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 20044. Choose a server from the drop-down list and cli

Migrating Settings and DataChapter 5 Migrating from Version 6.0 to 6.1 595. In the new Migration parameters window that is launched, specify the migra

6 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004

What Does Not Get Migrated60 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004❍ Document Root❍ JavaFor more information, see The

Overview of Changes in Sun ONE Web Server 6.1Chapter 5 Migrating from Version 6.0 to 6.1 61• Simple Session Manager and JDBC Session ManagerSee “Sessi

Overview of Changes in Sun ONE Web Server 6.162 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004Cgistub DirectoryThe migration p

Overview of Changes in Sun ONE Web Server 6.1Chapter 5 Migrating from Version 6.0 to 6.1 63Configuration FilesThe following table provides a summary l

Overview of Changes in Sun ONE Web Server 6.164 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004magnus.conf •Location: server-id

Overview of Changes in Sun ONE Web Server 6.1Chapter 5 Migrating from Version 6.0 to 6.1 65obj.conf •Location: install-dir/config/• Contains instructi

Overview of Changes in Sun ONE Web Server 6.166 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004Configuration Files Removed in S

Overview of Changes in Sun ONE Web Server 6.1Chapter 5 Migrating from Version 6.0 to 6.1 67In Sun ONE Web Server 6.1, the connection group functionali

Overview of Changes in Sun ONE Web Server 6.168 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004If the previous version of your

Overview of Changes in Sun ONE Web Server 6.1Chapter 5 Migrating from Version 6.0 to 6.1 69Search MigrationBecause the search engine used in Sun ONE W

7About This GuideThis guide explains how to install Sun™ Open Net Environment (Sun ONE) Web Server 6.1 and how to migrate from a previous version of t

Overview of Changes in Sun ONE Web Server 6.170 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004• IWSSessionManager, a provided

Overview of Changes in Sun ONE Web Server 6.1Chapter 5 Migrating from Version 6.0 to 6.1 71Symbolic Links in Configuration Files (UNIX and Linux)Symbo

Overview of Changes in Sun ONE Web Server 6.172 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004<param-name>reapInterval&l

Overview of Changes in Sun ONE Web Server 6.1Chapter 5 Migrating from Version 6.0 to 6.1 73For more information on the WebDAV feature, see the Sun ONE

Overview of Changes in Sun ONE Web Server 6.174 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004

75Chapter 6Migrating from Version 4.1 to 6.1This chapter contains migration information to help you understand the changes that take place when you mi

Migrating Settings and Data76 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004• Simple Session Manager and JDBC Session Manager

Migrating Settings and DataChapter 6 Migrating from Version 4.1 to 6.1 772. Click Migrate Server.Migrate Server Page3. Enter the server root of the se

Migrating Settings and Data78 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 20044. Choose a server from the drop-down list and cli

Migrating Settings and DataChapter 6 Migrating from Version 4.1 to 6.1 795. In the new Migration parameters window that is launched, specify the migra

Document Conventions8 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004Document ConventionsThis guide uses the following conventi

Migrating Settings and Data80 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004❍ Document Root❍ JavaFor more information, see The

Migrating Settings and DataChapter 6 Migrating from Version 4.1 to 6.1 816. Click Migrate.The Migrate server_name page appears. It shows the results o

Migrating Settings and Data82 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 20047. Click Configure Migrated Server to configure yo

Migrating Settings and DataChapter 6 Migrating from Version 4.1 to 6.1 83• If your iPlanet Web Server 4.1 hardware virtual servers were created using

What Does Not Get Migrated84 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004Custom NSAPI plug-ins are not automatically copied

Summary of Migration-Related ChangesChapter 6 Migrating from Version 4.1 to 6.1 85Summary of Migration-Related ChangesWhen you migrate information fro

Summary of Migration-Related Changes86 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004Java Server PagesiPlanet Web Server 4.0 J

Summary of Migration-Related ChangesChapter 6 Migrating from Version 4.1 to 6.1 87Cron ControlCron file names have been changed in Sun ONE Web Server

Summary of Migration-Related Changes88 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004Virtual ServersIn iPlanet Web Server 4.1,

Summary of Migration-Related ChangesChapter 6 Migrating from Version 4.1 to 6.1 89See the Sun ONE Web Server 6.1 Programmer’s Guide to Web Application

Using the DocumentationAbout This Guide 9•The italic font is used in code to represent placeholder parameters that should be replaced with an actual v

Summary of Migration-Related Changes90 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004

91IndexNUMERICS4.x-style legacy servlets 60AACLs, migrating 83Administration interfacemore information about 10authentication 69Authorization 69Ccerti

Section I92 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004Iinstall.inf 38installinga downloaded server 27across multiple machi

Section NIndex 93symbolic links 71, 88WAI 84Web Publishing 84web publishing 88what does not get migrated 84from iPlanet Web Server 6.0overview 55searc

Section T94 Sun ONE Web Server 6.1 • Installation and Migration Guide • April 2004Sun ONE ASP support 16Sun ONE Studio plug-in support 15sun-web.xml 7