Sun Microsystems iPlanet Web Server User manual

Installation Guide
iPlanet Web Server, FastTrack Edition
Version4.1
June 2000

Copyright © 2000 Sun Microsystems, Inc. Some preexisting portions Copyright © 2000 Netscape
Communications Corporation. All rights reserved.
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.
________________________________________________________________________________________
Copyright © 2000 Sun Microsystems, Inc. Pour certaines parties préexistantes, Copyright © 2000
Netscape Communication Corp. Tous droits réservés.
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.

3
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

5
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

9
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.

Supported Platforms
Chapter 1 Before You Install iPlanet Web Server, FastTrack Edition 11
More Information
For a full description of the iPlanet Web Server, Enterprise Edition, see:
http://www.iplanet.com/products/infrastructure/web_servers/index.html
Supported Platforms
iPlanet Web Server, FastTrack Edition runs on these platforms:
Required Patches
For the latest information on required patches and service packs, see the release
notes at http://docs.iplanet.com/docs/manuals/enterprise.html.
Table 1-1 Supported Platforms
Operating System Architecture Required
Memory Required Disk Space
Compaq Tru64 UNIX 4.0d;
4.0e and 4.0f supported
through binary
compatibility.
Alpha 64 MB
minimum 110 MB minimum
Hewlett-Packard HP-UX
11.0; 11.0 64 supported
through binary
compatibility.
PA-RISC 64 MB
minimum 110 MB minimum
IBM AIX 4.3.3 Power PC 64 MB
minimum 110 MB minimum
Sun Solaris 8; Solaris 2.6 and
Solaris 7 supported through
binary compatibility
SPARC 64 MB
minimum 110 MB minimum
Microsoft Windows NT
version 4.0 with Service Pack
5 or greater.
Intel Pentium 64 MB
minimum 110 MB minimum
Red Hat Linux 6.1, based on
kernel 2.2.12 with glibc 2.1.2 x86 64 MB minimum 110 MB minimum

Hardware and Software Requirements
12 iPlanet Web Server, FastTrack Edition Installation Guide • June 2000
Hardware and Software Requirements
In addition to the Unix, Linux, or Windows NT operation system. memory and
disk space requirements listed above, your computer must have the following
hardware and software:
Unix
• Swap space at least as large as the amount of RAM on your system (twice the
amount of RAM is recommended).
• 10 MB of disk space for log files.
• Netscape Communicator 4.61 or higher, or Microsoft Internet Explorer 4.01.
• Java, JavaScript, and cookies enabled in your browser.
• If you are using Internet Explorer, you need to set your browser to check for a
new version of a page every time you access it. To configure this setting, from
the View menu, choose Internet Options. On the General tab, in the Temporary
Internet Files section, click Settings. Click the radio button to check for newer
versions of stored pages every visit to the page.
• A Unix user and group that have the appropriate permissions for running
iPlanet Web Server. This user is different from the user that runs the
Administration Server. Often people use the user nobody and group nobody
for this purpose, but you can also create a specific user and group.
• A Java Development Kit (JDK) installed on your system if you plan to use Java
Server Pages (JSPs). For more information on the required version and where
to obtain it, see “Installing a Java Developer’s Kit,” on page 18.
Windows NT
• If you plan on running more than two separate instances of iPlanet Web Server
on your system, an additional 16 MB RAM for each server instance.
• Paging space at least as large as the amount of RAM on your system (twice the
amount of RAM is recommended).
• 10 MB of disk space for log files.
• Netscape Communicator 4.61 or higher or Microsoft Internet Explorer 4.01 or
higher

Hardware and Software Requirements
Chapter 1 Before You Install iPlanet Web Server, FastTrack Edition 13
• If you are using Internet Explorer, you need to set your browser to check for a
new version of a page every time you access it. To configure this setting, from
the View menu, choose Internet Options. On the General tab, in the Temporary
Internet Files section, click Settings. Click the radio button to check for newer
versions of stored pages every visit to the page.
• Java, JavaScript, and cookies enabled in your browser.
• If you intend to use hostnames during the iPlanet Web Server installation, DNS
properly configured with an entry for your server in a DNS server.
• A static IP address on your machine.
• A Java Development Kit (JDK) installed on your system if you plan to use Java
Server Pages (JSPs). iPlanet Web Server for Windows NT requires JDK 1.2.2 or
higher.For more information, see “Installing a Java Developer’s Kit,” on page
18.
Linux
• 256 MB swap space.
• 10 MB of disk space for log files.
• Netscape Communicator 4.61 or higher or Microsoft Internet Explorer 4.01.
• Java, JavaScript, and cookies enabled in your browser.
• If you are using Internet Explorer, you need to set your browser to check for a
new version of a page every time you access it. To configure this setting, from
the View menu, choose Internet Options. On the General tab, in the Temporary
Internet Files section, click Settings. Click the radio button to check for newer
versions of stored pages every visit to the page.
• A Linux user and group that have the appropriate permissions for running
iPlanet Web Server. This user is different from the user that runs the
Administration Server. Often people use the user nobody and group nobody
for this purpose, but you can also create a specific user and group.
• A Java Development Kit (JDK) installed on your system if you plan to use Java
Server Pages (JSPs). For more information on the required version and where
to obtain it, see “Installing a Java Developer’s Kit,” on page 18.

Other Technical Requirements
14 iPlanet Web Server, FastTrack Edition Installation Guide • June 2000
Other Technical Requirements
Once you have the proper hardware and software necessary to install iPlanet Web
Server, you should make sure that you meet the following requirements:
• You know the host name and IP address of your server computer.
• Your server has a DNS alias. For information on creating a DNS alias for your
server, see “Creating a DNS Alias for the Server” on page 14.
• Your server has a user account on Unix, Linux, or NT. See “Unix and Linux
User Accounts for the Server” on page 14 or “Windows NT User Accounts for
the Server” on page 15 for more information.
• You have two port numbers - one for the Administration Server and the other
for the first iPlanet Web Server server instance. For information on choosing
port numbers for your server, see “Choosing Unique Port Numbers” on
page 16.
Creating a DNS Alias for the Server
If your server will run on one machine among many in a network, you or your
system administrator should set up a DNS CNAME record or an alias that points to
the actual server machine. Later, you can change the actual hostname or IP address
of the server machine without having to change all URLs that point to the server
machine.
For example, you might call the server my_server.my_company.com and then use an
alias like www.my_company.com. So the URLs to documents on your server would
always use the www alias instead of my_server.
Unix and Linux User Accounts for the Server
When the iPlanet Web Server starts, it runs with a Unix or Linux user account that
you specify during installation. Any child processes of the server are created with
this account as the owner. It is best to create a Unix or Linux account for the server
that has restricted access to your system resources. The account needs read
permissions for the configuration files and write permissions for the logs
directory. For security reasons, the user account shouldn’t have write permissions
to some of the configuration files, though some, such as the access control files,
should be group writable.

Other Technical Requirements
Chapter 1 Before You Install iPlanet Web Server, FastTrack Edition 15
In addition, the user account you create for the server should belong to a group
that contains the server users for all iPlanet servers so that multiple servers can
have access to shared files.
If you don’t create a dedicated user account for iPlanet Web Server, on many
platforms you can use the account with the name nobody, but you might not want
to give the user nobody permissions for running the iPlanet Web Server. In
addition, the user nobody might not work on some systems. Some systems assign a
user ID of -2 for the user nobody. A user ID of less than 0 generates an error during
installation. Check the /etc/passwd file to see if the uid for nobody exists, and
make sure it is greater than 0.
The Administration Server can also run with a user account that has write
permissions to the configuration files for all installed servers. However, it’s much
easier to run the Administration Server as root because then the Administration
Server user can start and stop servers with port numbers less than 1024. (Port
numbers greater than 1024 can be started by any user).
The user you use to run the iPlanet Web Server (often nobody) must be in the same
group as the user you use to run the Administration Server (often root).
Windows NT User Accounts for the Server
You should create a Windows NT user account for your iPlanet Web Server. It
should have restricted access to your system resources and run under a
nonprivileged system user account (one that has a limited set of system
permissions to your system). When the server starts, it runs with this user account.
Any server extension modules the server uses are created with this user account as
the owner.
NOTE It’s strongly recommended that you use a dedicated account for the
server.
CAUTION If you plan to use SNMP, you must run both the iPlanet Web Server
instance and the Administration Server as root.

Other Technical Requirements
16 iPlanet Web Server, FastTrack Edition Installation Guide • June 2000
During installation, the server uses the LocalSystem account, not the user account
you created. Once you start and run the server, you should use the user account
you created. You can change the user account for the server after the installation
process. You can configure that user account so that it has permissions to get files
on another computer, so that your server can serve files that are mounted from
another computer.
In addition, the user account you create for the server should belong to a group
that contains the server users for all iPlanet servers so that multiple servers can
have access to shared files.
Choosing Unique Port Numbers
You need multiple port numbers: one for the Administration Server and one for
each instance of iPlanet Web Server. The Administration Server is a special instance
of the iPlanet Web Server that you use to manage your iPlanet Web Server. This
Administration Server is not the same as the Netscape Administration Server
shipped with the Netscape Console.
The standard web server port number is 80 and the standard SSL-enabled web
server port number is 443, but you can install iPlanet Web Server to use any port. If
you use a port other than the default port (port 80), the URL used to gain access to
your home page changes. For example, if your computer is called www.siroe.com
and you choose port 9753, your server’s URL will be
http://www.siroe.com:9753/.
You should choose a random number for the Administration Server to make it
harder for anyone to breach your server. When you configure your server, you use
the Administration Server’s port number. For example, for server mozilla.com,
the server’s URL could be
http://www.mozilla.com:2634/.
Make sure the port you choose isn’t already in use. On Unix and Linux systems,
you can check the file /etc/services on the server machine to make sure you
don’t assign a port number that is reserved for another service. If you choose a port
that is currently being used by another service, the installation program prompts
you for another port.
NOTE It’s strongly recommended that you use a dedicated account for the
server.

Installation Overview
Chapter 1 Before You Install iPlanet Web Server, FastTrack Edition 17
Installation Overview
You can install iPlanet Web Server by downloading it off the iPlanet web site.
When you install iPlanet Web Server, you follow these basic steps:
1. If you have an existing iPlanet Web Server, Netscape Enterprise Server, or
Netscape FastTrack Server already installed, shut it down and save a back up
of all the files in the server root. On Windows NT you may also want to save
copies of files added to Winnt/Sytem32 during server installation, and copies
of the registry as well. For more information on saving copies of the registry,
see your operating system documentation.
2. If you do not already have either Communicator 4.61 or higher or Internet
Explorer 4.01 or higher installed, install one.
3. If you are planning to use users and groups for access control, and you do not
have a Directory Server installed, install it. When you install Directory Server,
you also install Netscape Console.
4. Make a note of the LDAP URL associated with your Directory Server, because
you will need it during the installation process.
5. Install and configure iPlanet Web Server.
Installing Netscape Communicator
Because you need a web browser such as Netscape Communicator to administer
your server, you must install Communicator or another browser onto your
machine before installing iPlanet Web Server. You can download the software from
http://home.netscape.com.
NOTE If you use Unix or Linux, and you choose a server port number
lower than 1024, you must be logged in as root to start the server.
After the server binds to the port, the server changes from the root
user account to the user account you specify. If you choose a port
number higher than 1024, you don’t have to be the root user to
start the server.

Installing Netscape Directory Server
18 iPlanet Web Server, FastTrack Edition Installation Guide • June 2000
Installing Netscape Directory Server
If you are planning to use users and groups (for example, for access control) with
your iPlanet Web Server, you need to install Netscape Directory Server before
installing the iPlanet Web Server, or use an exiting LDAP server installation.
For information on Directory Server see http://www.iplanet.com/.
Installing Netscape Console
When you install the Directory Server, you also install Netscape Console. Use
Netscape Console to manage your Directory Server. You can also access the iPlanet
Web Server from Netscape Console if you run a script after you install the iPlanet
Web Server. For more information, see “Accessing iPlanet Web Server from the
Netscape Console” on page 20.
If you are not planning to use Directory Server, you do not need to install Netscape
Console.
Installing a Java Developer’s Kit
If you are planning to use Java, you must install a Java Runtime Environment (JRE)
or a Java Developer’s Kit (JDK). iPlanet Web Server includes a JRE that you can
install during the installation process. However, you may prefer to install a JDK.
You need either a JRE or a JDK to use the following features:
NOTE You can install Netscape Directory Server and iPlanet Web Server
on the same Windows NT machine if you do the following:
•If during installation you are asked which version of libraries to install,
always select those which have the most recent release dates.
•If you need to uninstall either product, you must first make a copy of the
uninstall program (uninst.exe) since it will be removed during the
uninstall process. Also, you must uninstall iPlanet Web Server before you
uninstall Directory Server.

Installing a Java Developer’s Kit
Chapter 1 Before You Install iPlanet Web Server, FastTrack Edition 19
• Java servlets
• server-side JavaScript database connectivity (LiveWire)
You need a JDK to run the following feature (it will not run with a JRE):
• Java Server Pages (JSPs)
Because you need a JDK to use JSPs, JSPs are only turned on by default if you
provide a path to a JDK during installation.
Different platforms require different versions of the JDK:
• Sun Solaris requires JDK 1.2.2_01 or higher. Download a JDK at:
http://java.sun.com/jdk/
• HP-UX requires JDK 1.2.2_02 or higher. Download a JDK at:
http://www.hp.com/go/java
• IBM AIX requires JDK 1.2.2_01 or higher. Download a JDK at:
http://www.ibm.com/java/jdk/download/index.html
• Compaq Tru64 UNIX requires JDK 1.2.2-3 or higher. Download a JDK at:
http://www.compaq.com/java
• Windows NT requires a JDK of 1.2.2_01 or higher. Download a JDK at:
http://java.sun.com/jdk/
• Linux requires a JDK of 1.2.2 or higher, release candidate 4 or later. Download
a JDK at:
http://www.blackdown.org
You can install the JDK before you install iPlanet Web Server, and provide the path
to it during installation, or you can wait until after you’ve installed iPlanet Web
Server to install it.
After installation you can change the JRE or JDK iPlanet Web Server uses. In the
Administration Server, on the Global Settings tab, use the Configure JRE/JDK
Paths page. You can also change the path to the JRE/JDK in this page.
CAUTION If you are using HP-UX, you must install the JRE included with
iPlanet Web Server or supply a JDK. Without one or the other, the
HP-UX iPlanet Web Server won’t run.

Accessing iPlanet Web Server from the Netscape Console
20 iPlanet Web Server, FastTrack Edition Installation Guide • June 2000
Accessing iPlanet Web Server from the Netscape
ConsoleIf you want to be able to access the iPlanet Web Server from the Netscape Console,
run the installMCC script after you install iPlanet Web Server and the Netscape
Console. installMCC is a perl script found in server_root/bin/https/bin.
To run the script, follow these steps:
1. Copy installMCC from the server_root/bin/https/bin directory to your
Directory Server machine at Directory_Server_Root/shared/bin.
2. At the command prompt, run the installMCC script using the following
syntax:
perl installMCC -root server_root -host hostname -port web_admin_port
-ldaphost hostname -ldapport ldap_port -basedn basedn -binddn binddn
-bindpwd bind_password
For example:
perl installMCC -root /usr/netscape/server4 -host
austen.red.iplanet.com -port 8888 -ldaphost
siroe.red.iplanet.com -ldapport 389 -basedn siroe.com -binddn
“cn=Directory Manager” -bindpwd password
3. Copy the files entserve41.jar and entserv41_en.jar from
server_root/bin/https/jar to server_root/java/jars.
4. If you are using Unix or Linux, go to the server root and run
./startconsole. If you are using Windows NT, start the Netscape Console
from the Start menu.
Once you have run this script, your iPlanet Web Server appears in the Netscape
Console window. When you double-click on the icon in the Netscape Console, the
Console launches a web browser window and displays the iPlanet Web Server
Administration Server page.
NOTE Though you can use the JRE with servlets on Solaris, using the JDK
instead improves performance.