Sun Microsystems IPlanet Web Server User manual

Installation Guide

iPlanet Web Server, FastTrack Edition

Version4.1

June 2000

Sun, Sun Microsystems, and the Sun logo, iPlanet, and the iPlanet logo are trademarks or registered

trademarks of Sun Microsystems, Inc. in the United States and other countries. Netscape and the

Netscape N logo are registered trademarks of Netscape Communications Corporation in the U.S.

and other countries. Other Netscape logos, product names, and service names are also trademarks

of Netscape Communications Corporation, which may be registered in other countries.

Federal Acquisitions: Commercial Software—Government Users Subject to Standard License Terms

and Conditions

The product described in this document is distributed under licenses restricting its use, copying,

distribution, and decompilation. No part of the product or this document may be reproduced in any

form by any means without prior written authorization of the Sun-Netscape Alliance and its

licensors, if any.

THIS DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED

CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED

WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR

NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH

DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.

________________________________________________________________________________________

Sun, Sun Microsystems, et the Sun logo, iPlanet, and the iPlanet logo sont des marques de fabrique

ou des marques déposées de Sun Microsystems, Inc. aux Etats-Unis et d’autre pays. Netscape et the

Netscape N logo sont des marques déposées de Netscape Communications Corporation aux

Etats-Unis et d’autre pays. Les autres logos, les noms de produit, et les noms de service de Netscape

sont des marques déposées de Netscape Communications Corporation dans certains autres pays.

Le produit décrit dans ce document est distribué selon des conditions de licence qui en restreignent

l'utilisation, la copie, la distribution et la décompilation. Aucune partie de ce produit ni de ce

document ne peut être reproduite sous quelque forme ou par quelque moyen que ce soit sans

l’autorisation écrite préalable de l’Alliance Sun-Netscape et, le cas échéant, de ses bailleurs de

licence.

CETTE DOCUMENTATION EST FOURNIE “EN L'ÉTAT”, ET TOUTES CONDITIONS EXPRESSES

OU IMPLICITES, TOUTES REPRÉSENTATIONS ET TOUTES GARANTIES, Y COMPRIS TOUTE

GARANTIE IMPLICITE D'APTITUDE À LA VENTE, OU À UN BUT PARTICULIER OU DE NON

CONTREFAÇON SONT EXCLUES, EXCEPTÉ DANS LA MESURE OÙ DE TELLES EXCLUSIONS

SERAIENT CONTRAIRES À LA LOI.

Contents

About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

What You Need to Know . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

What’s in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Where to Find This Guide Online . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

How to Use Online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Where to Find Related Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Chapter 1 Before You Install iPlanet Web Server, FastTrack Edition . . . . . . . . . . . . . . . . . . . 9

iPlanet Web Server, FastTrack Edition Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Differences Between FastTrack Edition and Enterprise Edition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

More Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Supported Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Required Patches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Hardware and Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Unix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Windows NT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Other Technical Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Creating a DNS Alias for the Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Unix and Linux User Accounts for the Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Windows NT User Accounts for the Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Choosing Unique Port Numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Installing Netscape Communicator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Installing Netscape Directory Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Installing Netscape Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Installing a Java Developer’s Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Accessing iPlanet Web Server from the Netscape Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

4 iPlanet Web Server, FastTrack Edition Installation Guide • June 2000

Chapter 2 Installing iPlanet Web Server, FastTrack Edition on Unix . . . . . . . . . . . . . . . . . . 21

Installing on Unix Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Installing from a CD Shipped With Solaris 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Logging In as the Correct User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Unpacking the Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Running Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Typical or Custom Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Express Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Using Silent Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Using Uninstall on Unix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Chapter 3 Installing iPlanet Web Server, FastTrack Edition on Windows NT . . . . . . . . . . . 35

Installing on Windows NT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Unpacking the Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Running setup.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Using Uninstall on Windows NT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Chapter 4 Installing iPlanet Web Server, FastTrack Edition on Linux . . . . . . . . . . . . . . . . . 43

Installing on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Logging In as the Correct User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Unpacking the Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Running Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Typical or Custom Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Express Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Using Silent Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Using Uninstall on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Chapter 5 Troubleshooting Your Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Troubleshooting All Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Troubleshooting Unix and Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Troubleshooting Windows NT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . 61

About This Guide

This guide explains how to install iPlanet™ Web Server, FastTrack Edition.

This preface contains the following sections:

• What You Need to Know

• What’s in This Guide

• Document Conventions

• Where to Find This Guide Online

• How to Use Online Help

• Where to Find Related Information

What You Need to Know

The guide assumes that you are a server administrator with a general

understanding of the following:

• The Internet and the World Wide Web

• The iPlanet Web Server architecture, as explained in the iPlanet Web Server

Administrator’s Guide.

What’s in This Guide

6 iPlanet Web Server, FastTrack Edition Installation Guide • June 2000

What’s in This Guide

The iPlanet Web Server Installation Guide covers the information you need to install

iPlanet Web Server on your system.

Document Conventions

This guide uses the following conventions:

• When this document refers to iPlanet Web Server, it refers to the FastTrack

Edition.

•The

monospace font is used for sample code and code listings, API and

language elements (such as method names and property names), filenames,

path names, directory names, HTML tags, and any text that must be typed on

the screen.

• The monospace italic font is used in code to represent placeholder parameters

that should be replaced with an actual value.

• Standard Italic type is used for book titles, emphasis, letters as letters (for

example, “Spell it with a T.”), and words as words (for example, “The word

server is in every product name.”).

If you want to do this: See this chapter:

Find out what you need to do before

installing the server, including installing

other products required by the server

Chapter 1, “Before You Install iPlanet

Web Server, FastTrack Edition”

Get step by step instructions for installing

and uninstalling the server on Unix Chapter 2, “Installing iPlanet Web

Server, FastTrack Edition on Unix”

Get step by step instructions for installing

and uninstalling the server on NT Chapter 3, “Installing iPlanet Web

Server, FastTrack Edition on Windows

NT”

Get step by step instructions for installing

and uninstalling the server on Linux Chapter 4, “Installing iPlanet Web

Server, FastTrack Edition on Linux”

Troubleshoot your installation Chapter 5, “Troubleshooting Your

Installation”

Find information in the guide Index

Where to Find This Guide Online

About This Guide 7

• Brackets ([]) are used to enclose parameters that are optional.

• A slash (/) is used to separate directories in a path. (Windows NT supports

both the slash and the backslash.)

Where to Find This Guide Online

You can find the iPlanet Web Server Installation Guide online in PDF and HTML

formats. To find these files, use this URL:

http://docs.iplanet.com/docs/manuals/enterprise.html

The information in this guide is also part of the help system for iPlanet Web Server.

See “How to Use Online Help.”

How to Use Online Help

When you are using iPlanet Web Server, you can click Help in any iPlanet Web

Server window to open a web browser window showing explanations of all of the

window’s user interface fields. You can then navigate to other parts of the help

document, as well as the entire documentation set. The installation programs do

not have online help, but some migration screens do.

To move to the top of whatever major part of online help you’re in and gain access

to navigational buttons and to a Contents, Index, and DocHome list of resources,

click the arrow button to the left of a heading. (If you don’t see an arrow button,

scroll until you do.)

Where to Find Related Information

In addition to this guide, iPlanet Web Server comes with supplementary

information for administrators as well as documentation for end users and

developers. These documents are available through your online help system, from

the Bookshelf button.

In addition, all documents are available online. Use the following URL to see all the

iPlanet Web Server documentation:

http://docs.iplanet.com/docs/manuals/enterprise.html

Where to Find Related Information

8 iPlanet Web Server, FastTrack Edition Installation Guide • June 2000

These are the iPlanet Web Server, FastTrack Edition documents that are available:

• iPlanet Web Server Administrator’s Guide

• Programmer’s Guide for iPlanet Web Server

• NSAPI Programmer’s Guide

• Programmer’s Guide to Servlets in iPlanet Web Server

• Release Notes

Chapter 1

Before You Install iPlanet Web

Server, FastTrack Edition

The following sections discuss the information you need to know before you install

iPlanet Web Server, FastTrack Edition.

This chapter contains the following sections:

• iPlanet Web Server, FastTrack Edition Overview

• Supported Platforms

• Required Patches

• Hardware and Software Requirements

• Other Technical Requirements

• Installation Overview

• Installing Netscape Communicator

• Installing Netscape Directory Server

• Installing Netscape Console

• Installing a Java Developer’s Kit

• Accessing iPlanet Web Server from the Netscape Console

iPlanet Web Server, FastTrack Edition Overview

iPlanet Web Server, FastTrack Edition is the perfect web server for developing and

testing Java applications and deploying low traffic web sites.

iPlanet Web Server, FastTrack Edition Overview

10 iPlanet Web Server, FastTrack Edition Installation Guide • June 2000

iPlanet Web Server, FastTrack Edition is easy to use, and comes with built-in

support for Java, SSL, and LDAP. Because it shares a common code base with

iPlanet Web Server, Enterprise Edition, applications developed for it can be run on

the Enterprise Edition without requiring changes.

Differences Between FastTrack Edition and

Enterprise Edition

iPlanet Web Server, FastTrack edition has many of the same features as Enterprise

Edition; however, some features have been removed from FastTrack Edition. There

were no previous versions of iPlanet Web Server, FastTrack Edition 4.1. However,

features were removed from the iPlanet Web Server, Enterprise Edition 4.1 to

create the FastTrack Edition feature set. Some of the features removed are:

Scalability. FastTrack Edition has a limit of 5 concurrent threads, which limits use

to low traffic environments or development.

Security. The FastTrack Edition SSL encryption level is only 56-bit, making it less

functional for highly secure environments.

High Availability . FastTrack Edition’s multiprocess mode has been disabled, so

process failover on Unix is not an option, as it is in Enterprise Edition. The

Intelligent Load Balancing Plug-in is also not available for FastTrack Edition.

Manageability. FastTrack Edition is limited to five virtual servers, as opposed to

256 in Enterprise Edition. FastTrack Edition does not support distributed

administration, cluster management, and SNMP monitoring.

LDAP is still required for user authentication, and the FastTrack Edition includes

license for use of Netscape Directory Server for development purposes.

Applications. FastTrack Edition servlets and JSPs do not run in multiprocess

mode. Because FastTrack Edition does not include the JavaScript environment,

there is no LiveWire native database access. Perl and NSAPI are still supported, as

are CGIs.

Content Management. FastTrack Edition does not include Web Publishing and

search have been removed.

Table of contents

Other Sun Microsystems Server manuals

Sun Microsystems

Sun Microsystems Fire V210 User manual

Sun Microsystems

Sun Microsystems Sun Fire X2200 M2 Installation and operating manual

Sun Microsystems

Sun Microsystems Fire 880 Instruction Manual

Sun Microsystems

Sun Microsystems SUN FIRE 280R User manual

Sun Microsystems

Sun Microsystems Ultra Enterprise 6000 Systems User guide

Sun Microsystems

Sun Microsystems Sun Ultra 450 User manual

Sun Microsystems

Sun Microsystems Sun Fire X4170 User manual

Sun Microsystems

Sun Microsystems Sun SPARC Enterprise M3000 User manual

Sun Microsystems

Sun Microsystems Sun SPARC Enterprise M8000 User manual

Sun Microsystems

Sun Microsystems Sun Fire X4250 Installation and operating manual

Sun Microsystems

Sun Microsystems V250 Use and care manual

Sun Microsystems

Sun Microsystems Sun Fire V445 Instruction Manual

Sun Microsystems

Sun Microsystems Sun Fire T1000 User manual

Sun Microsystems

Sun Microsystems Netra User manual

Sun Microsystems

Sun Microsystems Sun Fire 15K Manual

Sun Microsystems

Sun Microsystems Sun Fire X4440 Installation and operating manual

Sun Microsystems

Sun Microsystems Enterprise 250 Installation and operation manual

Sun Microsystems

Sun Microsystems Sun SPARC Enterprise M4000 User manual

Sun Microsystems

Sun Microsystems Sun Fire V890 Installation instructions manual

Sun Microsystems

Sun Microsystems Sun StorEdge Switch-8 Installation instructions manual

Sun Microsystems

Sun Microsystems Netra T2000 User manual

Sun Microsystems

Sun Microsystems Sun Netra CP3260 User manual

Sun Microsystems

Sun Microsystems Sun Fire V60x User manual

Sun Microsystems

Sun Microsystems Netra 150 Quick start guide

Popular Server manuals by other brands

HP AlphaServer ES47 Cli reference manual

Dell

Dell PowerEdge R410 Getting started

PowerNAS

PowerNAS CMA quick start guide

Supero

Supero FatTwin F617R3-FT user manual

MSI

MSI P1-109N-L70 user manual

Dell

Dell PowerEdge XE9640 Installation and service manual

Dell

Dell PS4100 Hardware

EtroVISION

EtroVISION EV3151 user manual

NEC

NEC Express5800/T110j System configuration guide

HP ProLiant Gen9 user guide

Compaq

Compaq ProLiant 3000 Maintenance and service guide

Dell

Dell PowerEdge 3YPMN Getting started guide

iRobo

iRobo IPC2U user manual

Nortel

Nortel 1000 Con?guration guide user manual

Asus

Asus AP7500 Hardware reference guide

Avid Technology

Avid Technology AirSpeed 5000 manual

HP Integrity rx2600 overview

Milestone

Milestone Husky IVO 350T Getting started

Sun Microsystems iPlanet Web Server User manual

Popular Server manuals by other brands