Installation and Migration GuideSun™ ONE Web ServerVersion 6.1817-1830-10August 2003
Using the Documentation10 Sun ONE Web Server 6.1 • Installation and Migration Guide • August 2003Performing 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 • August 2003• Any error logs or core dumps
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 • August 2003• JDK 1.4.1_03 Support—Sun ONE Web Server 6.1 supports the Java Developer&ap
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 • August 2003For more information about Sun ONE Studio 5, visithttp://www.sun.com/softwar
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 • August 2003*Supported via binary compatibility. **As of iPlanet Web
Required PatchesChapter 2 Before You Install Sun ONE Web Server 19Required PatchesYou are recommended to update your operating system with the latest
Sun Microsystems, Inc.4150 Network CircleSanta Clara, CA 95054 U.S.A.Copyright 2003 Sun Microsystems, Inc. All rights reserved. Sun, Sun Microsystems,
Other Technical Requirements20 Sun ONE Web Server 6.1 • Installation and Migration Guide • August 2003• If you are using Internet Explorer, you need
Other Technical RequirementsChapter 2 Before You Install Sun ONE Web Server 21Creating a DNS Alias for the ServerIf your server will run on one machin
Other Technical Requirements22 Sun ONE Web Server 6.1 • Installation and Migration Guide • August 2003Windows User Accounts for the ServerYou should
Installation OverviewChapter 2 Before You Install Sun ONE Web Server 23You should choose a random number for the Administration Server to make it hard
Installation Overview24 Sun ONE Web Server 6.1 • Installation and Migration Guide • August 2003You must install Sun ONE Web Server 6.1 in a separate
25Chapter 3Installing Web Server on UNIXThis chapter tells you how to install Sun ONE Web Server on UNIX systems. It contains the following sections:•
Installing on UNIX Platforms26 Sun ONE Web Server 6.1 • Installation and Migration Guide • August 2003• You are not planning to use Express installati
Installing on UNIX PlatformsChapter 3 Installing Web Server on UNIX 277. Untar the file by typing tar -xvf filename. For example:tar -xvf sun-webserve
Installing on UNIX Platforms28 Sun ONE Web Server 6.1 • Installation and Migration Guide • August 2003❍ 3RD-PARTY-LICENSE.txt❍ LICENSE.txt❍ setup❍ ins
Installing on UNIX PlatformsChapter 3 Installing Web Server on UNIX 29Typical or Custom InstallationMost users should install the Typical or Custom in
3ContentsAbout This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installing on UNIX Platforms30 Sun ONE Web Server 6.1 • Installation and Migration Guide • August 20037. Specify the fully qualified domain name of th
Installing on UNIX PlatformsChapter 3 Installing Web Server on UNIX 3112. Type the port number of Sun ONE Web Server. The default is 80. This port sho
Installing on UNIX Platforms32 Sun ONE Web Server 6.1 • Installation and Migration Guide • August 200317. Go to the https-admserv directory under your
Installing on UNIX PlatformsChapter 3 Installing Web Server on UNIX 33To run setup, follow these steps:1. If you are not in the directory already, cha
Installing Across Multiple Machines34 Sun ONE Web Server 6.1 • Installation and Migration Guide • August 200313. To configure your Sun ONE Web Server,
Installing Across Multiple MachinesChapter 3 Installing Web Server on UNIX 351. In the /.rhosts directory of your local machine, create an entry for e
Installing Across Multiple Machines36 Sun ONE Web Server 6.1 • Installation and Migration Guide • August 2003❍ HostNames: the name of the host where t
Installing Across Multiple MachinesChapter 3 Installing Web Server on UNIX 379. Run the installation wrapper by typing the following command at the co
Installing Across Multiple Machines38 Sun ONE Web Server 6.1 • Installation and Migration Guide • August 2003Using Silent InstallationSilent installat
Installing Across Multiple MachinesChapter 3 Installing Web Server on UNIX 397. The server is installed.The following is an example of an install.inf
4 Sun ONE Web Server 6.1 • Installation and Migration Guide • August 2003Unpacking the Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Default Sun ONE Web Server Directories40 Sun ONE Web Server 6.1 • Installation and Migration Guide • August 2003Default Sun ONE Web Server Directories
Using Uninstall on UNIXChapter 3 Installing Web Server on UNIX 41To remove your Sun ONE Web Server:1. Go to your server root and type ./uninstall.A li
Using Uninstall on UNIX42 Sun ONE Web Server 6.1 • Installation and Migration Guide • August 2003
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 • August 2003• Because of DLL conflicts, if you install Sun ONE Web
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 • August 20035. 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 • August 200311. The JDK Configuration dialog box appears. You can u
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 • August 2003Because Sun ONE Web Server is downloaded as a self-
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 • August 2003Default Sun ONE Web Server Directories
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 • August 2003
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 • August 2003• Server Side HTML (SHTML)• Simple Network Manage
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 • August 20034. Choose a server from the drop-down list and cl
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 • August 2003
What Does Not Get Migrated60 Sun ONE Web Server 6.1 • Installation and Migration Guide • August 2003❍ 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 • August 2003Cgistub DirectoryThe migration
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 • August 2003magnus.conf •Location: server-i
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 • August 2003Configuration Files Removed in
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 • August 2003If 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 • August 2003• 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 • August 2003<param-name>reapInterval&
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 • August 2003
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 • August 2003• 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 • August 20034. Choose a server from the drop-down list and cl
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 • August 2003Document ConventionsThis guide uses the following convent
Migrating Settings and Data80 Sun ONE Web Server 6.1 • Installation and Migration Guide • August 2003❍ Document Root❍ JavaFor more information, see Th
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 • August 20037. Click Configure Migrated Server to configure y
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 • August 2003Custom 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 • August 2003Java Server PagesiPlanet Web Server 4.0
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 • August 2003Virtual 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 WebApplications
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 • August 2003
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 • August 2003Iinstall.inf 38installinga downloaded server 27across multiple mach
Section NIndex 93WAI 84Web Publishing 84web publishing 88what does not get migrated 84from iPlanet Web Server 6.0overview 55search collections and ind
Section T94 Sun ONE Web Server 6.1 • Installation and Migration Guide • August 2003symbolic links 71, 88Ttechnical requirements 20template.inf 34templ
Comentários a estes Manuais