Sun Microsystems Server iPlanet Web Server User Manual

Installation Guide  
iPlanet Web Server, FastTrack Edition  
Version4.1  
June 2000  
 
Contents  
What You Need to Know . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5  
Whats 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  
Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17  
Installing Netscape Communicator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17  
Installing Netscape Directory Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18  
Installing Netscape Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18  
Installing a Java Developers Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18  
Accessing iPlanet Web Server from the Netscape Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20  
3
 
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  
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  
4
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
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  
Whats 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.  
5
 
     
What’s in This Guide  
What’s in This Guide  
The iPlanet Web Server Installation Guide covers the information you need to install  
iPlanet Web Server on your system.  
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  
Web Server, FastTrack Edition”  
Get step by step instructions for installing  
and uninstalling the server on Unix  
Get step by step instructions for installing  
and uninstalling the server on NT  
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  
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.”).  
6
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
       
Where to Find This Guide Online  
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:  
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  
windows 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 youre 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 dont 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:  
About This Guide  
7
 
           
Where to Find Related Information  
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  
8
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
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 Developers 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.  
9
 
           
iPlanet Web Server, FastTrack Edition Overview  
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 Editions 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.  
10  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
 
Supported Platforms  
More Information  
For a full description of the iPlanet Web Server, Enterprise Edition, see:  
Supported Platforms  
iPlanet Web Server, FastTrack Edition runs on these platforms:  
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  
Alpha  
64 MB  
minimum  
110 MB  
minimum  
compatibility.  
Hewlett-Packard HP-UX  
11.0; 11.0 64 supported  
through binary  
PA-RISC  
64 MB  
minimum  
110 MB  
minimum  
compatibility.  
IBM AIX 4.3.3  
Power PC  
64 MB  
110 MB  
minimum  
minimum  
Sun Solaris 8; Solaris 2.6 and SPARC  
Solaris 7 supported through  
binary compatibility  
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  
Required Patches  
For the latest information on required patches and service packs, see the release  
Chapter  
1
Before You Install iPlanet Web Server, FastTrack Edition  
11  
 
                     
Hardware and Software Requirements  
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  
Administration Server. Often people use the user nobodyand 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 Developers 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  
12  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
           
Hardware and Software Requirements  
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 Developers 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  
Administration Server. Often people use the user nobodyand 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 Developers Kit,” on page 18.  
Chapter  
1
Before You Install iPlanet Web Server, FastTrack Edition  
13  
 
   
Other Technical Requirements  
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.comand 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 shouldnt have write permissions  
to some of the configuration files, though some, such as the access control files,  
should be group writable.  
14  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
               
Other Technical Requirements  
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 dont 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 nobodypermissions for running the iPlanet Web Server. In  
addition, the user nobodymight 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/passwdfile to see if the uidfor nobodyexists, and  
make sure it is greater than 0.  
NOTE  
It’s strongly recommended that you use a dedicated account for the  
server.  
The Administration Server can also run with a user account that has write  
permissions to the configuration files for all installed servers. However, its much  
easier to run the Administration Server as rootbecause 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).  
CAUTION If you plan to use SNMP, you must run both the iPlanet Web Server  
instance and the Administration Server as 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.  
Chapter  
1
Before You Install iPlanet Web Server, FastTrack Edition  
15  
 
       
Other Technical Requirements  
During installation, the server uses the LocalSystemaccount, 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.  
NOTE  
It’s strongly recommended that you use a dedicated account for the  
server.  
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 servers URL will be  
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 Servers port number. For example, for server mozilla.com,  
the servers URL could be  
Make sure the port you choose isnt already in use. On Unix and Linux systems,  
you can check the file /etc/serviceson the server machine to make sure you  
dont 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.  
16  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
     
Installation Overview  
NOTE  
If you use Unix or Linux, and you choose a server port number  
lower than 1024, you must be logged in as rootto 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 dont have to be the rootuser to  
start the server.  
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  
Chapter  
1
Before You Install iPlanet Web Server, FastTrack Edition  
17  
 
       
Installing Netscape Directory Server  
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/.  
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.  
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 Developers 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:  
18  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
           
Installing a Java Developer’s Kit  
Java servlets  
server-side JavaScript database connectivity (LiveWire)  
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 wont run.  
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:  
HP-UX requires JDK 1.2.2_02 or higher. Download a JDK at:  
IBM AIX requires JDK 1.2.2_01 or higher. Download a JDK at:  
Compaq Tru64 UNIX requires JDK 1.2.2-3 or higher. Download a JDK at:  
Windows NT requires a JDK of 1.2.2_01 or higher. Download a JDK at:  
Linux requires a JDK of 1.2.2 or higher, release candidate 4 or later. Download  
a JDK at:  
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 youve 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.  
Chapter  
1
Before You Install iPlanet Web Server, FastTrack Edition  
19  
 
 
Accessing iPlanet Web Server from the Netscape Console  
NOTE  
Though you can use the JRE with servlets on Solaris, using the JDK  
instead improves performance.  
Accessing iPlanet Web Server from the Netscape  
Console  
If you want to be able to access the iPlanet Web Server from the Netscape Console,  
run the installMCCscript after you install iPlanet Web Server and the Netscape  
Console. installMCCis a perl script found in server_root/bin/https/bin.  
To run the script, follow these steps:  
1. Copy installMCCfrom the server_root/bin/https/bindirectory to your  
Directory Server machine at Directory_Server_Root/shared/bin.  
2. At the command prompt, run the installMCCscript using the following  
syntax:  
perl installMCC -root server_root -hosthostname -portweb_admin_port  
-ldaphost hostname -ldapportldap_port -basednbasedn -binddnbinddn  
-bindpwdbind_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” -bindpwdpassword  
3. Copy the files entserve41.jarand entserv41_en.jarfrom  
server_root/bin/https/jarto 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.  
20  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
     
Chapter 2  
Installing iPlanet Web Server,  
FastTrack Edition on Unix  
This chapter tells you how to install iPlanet Web Server on Unix systems. It  
contains the following sections:  
Installing on Unix Platforms  
Using Silent Installation  
Using Uninstall on Unix  
Installing on Unix Platforms  
The following sections describe the installation of the iPlanet Web Server.  
CAUTION You must install your version 4.x servers in a server root directory  
separate from the server root directory that contains previous  
versions of the Web Server. Do not install iPlanet Web Server on an  
NFS-mounted drive due to potential security and file locking  
restrictions on remote partitions.  
Installing from a CD Shipped With Solaris 8  
If you are installing iPlanet Web Server, FastTrack edition from the iPlanet  
Advantage Software CD shipped with Solaris 8, the installer is different from the  
one described in this Guide. For installation information, see the notes on the  
iPlanet Advantage Software CD.  
21  
 
           
Installing on Unix Platforms  
Logging In as the Correct User  
Before you install iPlanet Web Server, you must log in as root, unless you meet the  
following conditions:  
You plan to install the iPlanet Web Server on a port higher than 1024.  
The location where you plan to install the server (the server root directory) is  
writable with your non-root login.  
You are not planning to use Express installation.  
If you meet these conditions, you do not need to log in as rootto install the server;  
instead log in as the user account that the Administration Server will use.  
However, you may still prefer to log in as root, even though you meet the  
conditions.  
Unpacking the Files  
To get the iPlanet Web Server files and unpack them, follow these steps:  
1. Download the file from http://www.iplanet.comand save it in a temporary  
directory.  
2. Change to the directory on your Unix machine where you copied the file.  
Unpack the .gzfile by typing gunzipfilename.tar.gz. The file name is in the  
format:  
fasttrack-4.1-security-internationalization.platform.tar.gz  
For example:  
fasttrack-4.1-export-us.hppa1.1-hp-hpux11.tar.gz.  
3. Untar the unzipped file by typing tar -xvffilename.tar.  
This command unpacks the server files and creates a temporary directory  
structure under the current directory. Unpacking the file may take a little time.  
When the files are unpacked, you see a WebServer directory, and three files:  
LICENSE.txt, README.txt, setup, and setup.inf.  
22  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
     
Installing on Unix Platforms  
NOTE  
Untarring the file will cause the permissions of the destination  
directory to be modified so that applications can no longer write  
files to it. To avoid this problem, untar the file in a directory where  
you can modify the permissions. For example, instead of /tmp, use  
a subdirectory under /tmp, for example, /tmp/iwsinstall.  
Running Setup  
You run the setup program to install iPlanet Web Server.  
During the installation process, you have the choice of three kinds of installation:  
Express, Typical, or Custom. Most users should choose Typical or Custom (they  
are identical). Typical or Custom gives you more flexibility in the components you  
can install and the settings you can configure.  
Express installation is for users who have little experience or are evaluating the  
product. It makes assumptions about such things as port number and which  
components to install.  
When running the installer, you can use the following commands:  
Press the Enter key to accept defaults specified in brackets (for example [All]).  
Press CTRL+b to return to a previous screen (note that this sequence does not  
work on all screens).  
Press CTRL+c to cancel the installation program.  
Enter comma-separated lists of numbers when you want to select multiple  
items (for example, 1, 2, 3).  
NOTE  
For Express installation, you must be logged in as rootwhen  
running setup.  
Typical or Custom Installation  
Most users should install the Typical or Custom installation.  
Chapter  
2
Installing iPlanet Web Server, FastTrack Edition on Unix  
23  
 
     
Installing on Unix Platforms  
To run setup, follow these steps:  
1. If you are not in the directory already, change to the directory where you  
unpacked the file.  
2. Type ./setupto start the server installation.  
If you arent logged in as the rootuser (superuser), or if you dont have  
sufficient write permissions, youll get one or more error messages.  
A welcome screen appears.  
3. Press Enter to continue with the installation.  
4. Choose whether you accept the software license agreement by typing Yes to  
accept, or No to decline. If you have not yet read the license agreement, cancel  
out of the installation and read the file LICENSE.txtthat is in the same  
directory as the setupprogram.  
5. Choose Typical or Custom.  
Press Enter.  
6. Type a server root directory or accept the default (/usr/netscape/server4).  
This directory is where the server files and directory structure will be installed.  
You need to run the server as a user that has write access to this directory, for  
example, the directory owner.  
7. Choose all components.  
Press Enter.  
8. Choose the iPlanet Web Server subcomponents to install.  
If you do not install a subcomponent and later decide you want to use it, you  
can run the installer again to install just the missing subcomponent. However,  
you cannot uninstall individual subcomponents once they are installed.  
By default, all subcomponents are installed.  
The subcomponents you can choose to install are described in the following  
numbered sections.  
1. Server Core  
Installs the Administration Server and the first instance of iPlanet Web  
Server.  
24  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
Installing on Unix Platforms  
CAUTION You must install the Server Core subcomponent the first time you  
install iPlanet Web Server. If you install additional subcomponents  
later, you are not required to reinstall the Core subcomponent.  
2. Java Runtime Environment  
If you are planning to use Java, you must have a Java Runtime  
Environment (JRE) or a Java Developer’s Kit (JDK). You can install the  
provided JRE, or supply your own JDK. For more information, see  
“Installing a Java Developers Kit,” on page 18.  
CAUTION If you are using HP-UX, even if you are not installing Java you must  
install the JRE or supply a JRE or JDK. Without one or the other, the  
HP-UX iPlanet Web Server wont run.  
3. Java Support  
Install this subcomponent if you are planning to use Java servlets.  
You also need a JRE or JDK to use iPlanet Web Servers Java support.  
Install the JRE provided with iPlanet Web Server (see the previous  
subcomponent) or install a JDK.  
9. Enter the machine name or accept the default.  
10. Enter the Unix user and group names to use when running the default instance  
of iPlanet Web Server.  
The default user and group is nobody.  
11. Enter the Unix user name to use when running the Administration Server.  
In most cases this user is root.  
12. Enter the Administration Server user name and password to use for  
authentication. You are asked to enter your password twice.  
This user is not a Unix user, but a user name and password in the Directory  
Server. You must make sure that the Administration Server user exists in the  
Directory Server, and that it has access permissions to the Directory Server to  
perform user and group management tasks.  
Chapter  
2
Installing iPlanet Web Server, FastTrack Edition on Unix  
25  
 
   
Installing on Unix Platforms  
13. Type the Administration Server port number or accept the default of 8888.  
Make sure you remember the port number for the Administration Server.  
For the most flexibility, choose a port number above 1024. If you want to use a  
port number lower than 1024 for your Administration Server, you must be  
logged on as rootto start the server. Do not use a port that is already in use.  
This iPlanet Web Server Administration Server is not the same as the Netscape  
Console, or the Administration Server shipped with other iPlanet/ Netscape  
servers.  
For more information on ports, see “Choosing Unique Port Numbers” on  
page 16.  
14. Type the port number of iPlanet Web Server. The default is 80. This port  
should be different than the Administration Server port. Unless you are  
installing as root, the port must be within the stated range (1024 to 65535). If  
you are installing as rootyou can use port numbers below 1024.  
If you use a port other than the default port (port 80), the URL used to gain  
access to your home page will change. For example, if your computer is called  
www.iplanet.comand you choose port 9753, your servers URL will be  
For more information on ports, see “Choosing Unique Port Numbers” on  
page 16.  
15. Specify whether you are using an LDAP-based directory server (enter Yes or  
No).  
You must use an LDAP directory server if you want to use user and group  
functionality for access control in iPlanet Web Server.  
If you use an LDAP directory server, enter following:  
The LDAP URL in the format ldap://hostname:port/base DN. For example,  
ldap://iplanet.com:389/o=siroe.com.  
The bind DN (for example, cn=Directory Manager) and the directory  
server password.  
16. Type the root directory where your servers content files (the images, HTML  
documents and data you want to present to users accessing the server) will  
reside. The default is server_root/ docs.  
17. If you want to use your own JDK, enter Yes.  
26  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
Installing on Unix Platforms  
If you are installing Java support, you must have a JRE or a JDK. You can  
install the supplied JRE subcomponent or use a JDK already installed on your  
system. For more information, see “Installing a Java Developers Kit,” on page  
18.  
18. If you are installing Java support, and you either did not choose to install the  
provided JRE, or you chose to use your own JDK, enter the absolute path to the  
directory where you installed the JDK on your system.  
The JDK must already exist in the specified directory.  
If the JDK libraries and CLASSPATH are stored in the default directories below  
the JDK directory (/ jre/ lib and / lib, respectively), press Enter at the JDK  
LIBPATH and JDK CLASSPATH prompts. If the libraries and CLASSPATH  
are stored in a different place on your system, enter the pathnames. On most  
systems you will not have to enter pathnames at these prompts.  
19. After the installation program extracts and installs the iPlanet Web Server  
components, press Enter.  
20. Go to the https-admservdirectory under your server root directory (for  
example /usr/netscape/server4) and start the Administration Server by  
typing ./start. You can also type ./startconsolein the server root  
startconsolestarts the Administration Server and launches a browser to the  
Administration Server administration pages. Later, if you have a Netscape  
Console installed and have registered the server with it, startconsole starts the  
Netscape Console. For more information, see “Accessing iPlanet Web Server  
from the Netscape Console,” on page 20.  
21. To configure your iPlanet Web Server, use the URL:  
http://server_name:administration_port  
Enter your administration user name and password.  
You can now configure your iPlanet Web Server. For more information, see the  
iPlanet Web Server Administrator’s Guide.  
Express Installation  
Express installation is for users who have little experience or are evaluating the  
product. It makes assumptions about such things as port number and which  
components to install.  
Chapter  
2
Installing iPlanet Web Server, FastTrack Edition on Unix  
27  
 
   
Installing on Unix Platforms  
The following table lists the assumptions made by the Express installation. If you  
would like to use different installation settings, use Typical or Custom installation.  
Table 2-1 Express installation settings  
Installation Setting  
administration port  
administration URL  
HTTP port number  
document root  
Value  
8888  
http:/ / machine name:adminisration port  
80  
server_root/ doc  
Unix user to run server  
LDAP users and groups  
JDK  
root  
not using  
none  
JRE  
default JRE shipped with iPlanet Web Server  
All default subcomponents installed  
subcomponents  
After installing, you can configure the server to use LDAP users and groups, and to  
use a JDK. For more information on how to make these changes, see the iPlanet Web  
Server Administrator’s Guide.  
CAUTION You must log in as rootto use Express installation.  
To run setup, follow these steps:  
1. If you are not in the directory already, change to the directory where you  
unpacked the file.  
2. Type ./setupto start the server installation.  
A welcome screen appears.  
3. Press Enter to continue with the installation.  
4. Choose whether you accept the software license agreement by entering Yes to  
accept, or No to decline. If you have not yet read the license agreement, cancel  
out of the installation and read the file LICENSE.txtthat is in the same  
directory as the setupprogram  
28  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
Installing on Unix Platforms  
5. Choose Express and press Enter.  
6. Type a server root directory or accept the default (/usr/netscape/server4).  
This directory is where the server files and directory structure will be installed.  
rootmust have write access to this directory.  
7. Choose all components.  
Press Enter.  
8. Enter the Unix user and group names to use when running the default instance  
of iPlanet Web Server.  
For Express installation, this user must be root. The group must be the group  
to which rootbelongs.  
9. Enter the Unix user name to use when running the Administration Server.  
In most cases, this user is root.  
10. Enter the Administration Server user name and password to use for  
authentication. You are asked to enter your password twice.  
If you are using a Netscape Directory Server, you must make sure that the  
Administration Server user exists in the Directory Server, and that it has access  
permissions to the Directory Server to perform user and group management  
tasks.  
11. After the installation program extracts and installs the iPlanet Web Server  
components, press Enter.  
12. Go to the https-adminserv directory under your server root directory (for  
example /usr/netscape/server4) and start Administration Server by typing  
startconsolestarts the Administration Server and launches a browser to the  
Administration Server administration pages. Later, if you have a Netscape  
Console installed and have registered the server with it, startconsole starts the  
Netscape Console. For more information, see “Accessing iPlanet Web Server  
from the Netscape Console,” on page 20.  
13. To configure your iPlanet Web Server, use the URL:  
http://server_name:administration_port  
Enter your administration user name and password.  
Chapter  
2
Installing iPlanet Web Server, FastTrack Edition on Unix  
29  
 
Using Silent Installation  
You can now configure your iPlanet Web Server. For more information, see the  
iPlanet Web Server Administrator’s Guide.  
Using Silent Installation  
If you want to install several iPlanet Web Servers, you can use silent installation to  
create a file of responses to the setup programs prompts. You can then edit the file,  
install.inf, and use it to install future iPlanet Web Server installations.  
Silent installation works best when you use the Typical installation and your  
installations are all similar.  
CAUTION The install.inffile contains the password used to log on to the  
Administration Server. The password is not encrypted; it is in plain  
text. If you use silent installation, be sure and delete the  
install.inffile once you are through with it.  
To use silent installation, follow these steps:  
1. Run setup with the -k option, which creates a file called install.infthat  
contains all your responses to the installers prompts. At the command prompt,  
type:  
./setup -k  
2. Answer the installer prompts and install iPlanet Web Server.  
3. When the server is installed, go to the server_root/setupdirectory, where youll  
find the install.inffile.  
4. Copy the install.inffile to the directory where you will run setup to install  
your next iPlanet Web Serve.  
5. Edit the values in the install.inffile to match the values of the next server  
you want to install.  
For example, change the machine name, port number, installation directory,  
etc.  
6. Run setup using the install.inffile for input. For example:  
./setup -s -f install.inf  
7. The server is installed.  
30  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
   
Using Silent Installation  
The following is an example of an install.inffile.  
[General]  
FullMachineName= austen.iplanet.com  
SuiteSpotUserID= annh  
SuitespotGroup= staff  
SecurityCheck= False  
RequireDomain= False  
ServerRoot= /usr/netscape/server4  
Components= WebServer  
[WebServer]  
Upgrade= False  
Reinstall= False  
AdminPort= 8888  
HttpPort= 1888  
HttpDocRoot= /usr/netscape/server4/docs  
AdminSysUser= annh  
AdminName= admin  
AdminPassword= password  
UgLdapUse= Yes  
UgLdapUrl= ldap://test:389/o=siroe.com  
UgLdapName= cn=Directory Manager  
UgLdapPassword= password  
JRE_DIR= /usr/netscape/server4/bin/https/jre  
USE_JDK= No  
CompVersions= 2:2:1:2:0:0:0:0:0:  
Components= nescore,JRE,java,cleanup  
[cleanup]  
Archive= cleanup.zip  
The following table shows some useful install.inf parameters to edit. For best  
results, do not edit any parameters except those listed in the table.  
Table 2-2 Silent Installation Parameters  
Parameter Name  
Use  
FullMachineName  
The machine name.  
Chapter  
2
Installing iPlanet Web Server, FastTrack Edition on Unix  
31  
 
Using Uninstall on Unix  
Table 2-2 Silent Installation Parameters  
Parameter Name  
Use  
SuiteSpotUserID  
The user ID used when running the default instance of the  
iPlanet Web Server.  
SuiteSpotGroup  
The group the user running the default instance of the iPlanet  
Web Server belongs to.  
ServerRoot  
AdminPort  
HttpPort  
The directory where you install the server.  
The Administration Server port.  
The port of the default iPlanet Web Server instance.  
The document root of the iPlanet Web Server instance.  
The user ID used when running the Administration Server.  
HttpDocRoot  
AdminSysUser  
AdminName  
The user name used to access to the Administration Servers  
administration screens.  
AdminPassword  
UgLdapUse  
The password used to access to the Administration Servers  
administration screens.  
Yes and No indicate whether you are using the LDAP  
Directory Server.  
UgLdapUrl  
The LDAP URL of the Directory Server you are using.  
The Bind DN of the Directory Server you are using.  
The Directory Server password.  
UgLdapName  
UgLdapPassword  
JRE_Dir  
If you are installing the JRE shipped with the iPlanet Web  
Server, the directory where it is installed.  
USE_JDK  
JDK_DIR  
Yes and No indicate whether you are using a JDK.  
The directory where your JDK is installed.  
Using Uninstall on Unix  
You can remove iPlanet Web Server from your computer by using the uninstall  
application.  
32  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
   
Using Uninstall on Unix  
CAUTION Though you can select individual subcomponents to uninstall, it is  
not recommended. The uninstaller only removes the parts of the  
code pertaining to the selected subcomponent, but does not update  
configuration files. Your server may not run if you uninstall  
individual subcomponents.  
To remove your iPlanet Web Server:  
1. Go to your server root and type ./uninstall.  
A list of iPlanet and Netscape servers currently installed in this location  
appears.  
2. Find iPlanet Web Server in the list and type the number next to it at the  
prompt.  
Note that uninstalling iPlanet Web Server automatically uninstalls the  
Administration Server, since it is an instance of iPlanet Web Server.  
A list of installed iPlanet Web Server subcomponents appears.  
3. Select all subcomponents and press Return.  
The subcomponents are uninstalled and you return to the command prompt.  
NOTE  
The uninstall program does not remove every server file. For  
example, it does not remove keys and certificates, configuration  
files, logs, ACL files or the document root.  
If you installed another 4.x server (for example, Netscape Directory Server or  
Messaging Server) in the same directory as iPlanet Web Server, follow these steps  
when uninstalling:  
1. Copy the uninstall script (uninstall) to another file, for example,  
uninstslapd.  
2. Use uninstallto uninstall iPlanet Web Server.  
3. Rename uninstslapdto uninstall.  
4. Use uninstallto uninstall Directory Server 4.1.  
Chapter  
2
Installing iPlanet Web Server, FastTrack Edition on Unix  
33  
 
Using Uninstall on Unix  
34  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
Chapter 3  
Installing iPlanet Web Server,  
FastTrack Edition on Windows NT  
This chapter tells you how to install iPlanet Web Server. It contains the following  
sections:  
Installing on Windows NT  
Using Uninstall on Windows NT  
Installing on Windows NT  
The following sections describe the installation of the iPlanet Web Server.  
Any errors that occur when the server starts are logged in the Event Viewer. Once  
started, the server logs errors to the normal error log file.  
Please keep the following warnings in mind:  
If you have previous versions of Netscape or iPlanet web servers installed, you  
must install your 4.x iPlanet Web Server in a different server root directory.  
If you have an iPlanet Web Server 4.1, Enterprise Edition installed, you must  
uninstall it before you can install the FastTrack Edition.  
If you have previous versions of Netscape or iPlanet web servers installed,  
shut down the Administration Server and Enterprise Server instances before  
installing iPlanet Web Server 4.1.  
If you install both Netscape Directory or Messaging Server and iPlanet Web  
Server on the same machine, during the web server installation when you are  
asked which version of libraries to install, always select those which have the  
most recent release dates, except for system32\libplc.dll.  
35  
 
         
Installing on Windows NT  
Do not install iPlanet Web Server on an NFS-mounted drive due to potential  
security and file locking restrictions on remote partitions.  
The server will unpack onto the drive designated by the TEMPenvironment  
variable. Make sure there is enough room on the device TEMPpoints to before  
starting the installation.  
Unpacking the Files  
To get the iPlanet Web Server files and unpack them, follow these steps:  
1. Download the file f41eiu.exeand save it in a temporary directory.  
2. Double-click the file to extract the files and launch the installation program.  
Running setup.exe  
Run the setup.exeprogram to install iPlanet Web Server.  
1. Double-click the setup.exefile (if you downloaded the file, this happens  
automatically when you double-click the downloaded file).  
2. The Welcome screen appears. After reading the Welcome screen, click Next.  
3. The Software License Agreement appears. Click Yes to accept the license.  
4. The Select Installation Type screen appears. Choose the kind of installation you  
want: Express, Typical or Custom.  
Express installation is for users who have little experience or are evaluating the  
product. It makes assumptions about such things as port number and which  
components to install. This option is not recommended if you are using your  
server in a production environment.  
Typical and Custom installation give you more options, and for this release do  
the same thing.  
If you chose Express installation, the following settings are set automatically  
for you. If you want to have different values for these settings, choose Typical  
or Custom installation.  
36  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
   
Installing on Windows NT  
Table 3-1 Express installation settings  
Installation Setting  
administration port  
administration URL  
HTTP port number  
document root  
LDAP users and groups  
JDK  
Vales  
8888  
http:/ / machine name:adminisration port  
80  
server_root/ doc  
not using  
none  
JRE  
default JRE shipped with iPlanet Web Server  
All default subcomponents installed  
subcomponents  
CAUTION Do not use Express Installation if you already have another web  
server running on port 80.  
Click Next.  
5. The Location of Installation dialog box appears. The default location for the  
server files is C:\Netscape\Server4, where C: is the letter of the drive on  
which you are installing the server.  
If you want to install iPlanet Web Server in a non-default location, use Browse  
to navigate to the folder you want, or type the name in the field. If you choose a  
folder that does not exist, the installation program asks if you want to create  
the folder.  
Click Next.  
6. The Components to Install dialog box appears. Select iPlanet Web Server,  
FastTrack Edition from the list. Note that because the Administration Server is  
now an iPlanet Web Server instance, it is installed automatically when you  
install iPlanet Web Server, and is not a choice on this product list.  
Chapter  
3
Installing iPlanet Web Server, FastTrack Edition on Windows NT  
37  
 
 
Installing on Windows NT  
NOTE  
By default, the installer installs a default set of subcomponents. If  
you want to change the subcomponents you install, click Change  
and continue to Step 7.  
If you did not change subcomponents or if youve completed your  
subcomponent selections, click Next to continue to Step 8.  
7. If you clicked Change on the previous screen, the Select Sub-Components  
dialog box appears. You can select a subcomponent for installation by checking  
the box next to it. You can decline to install it by unchecking the box. If you  
later decide you want to install subcomponents you did not check, you can run  
the installer again and choose to install only the missing subcomponents.  
However, you cannot uninstall separate subcomponents once they are  
installed.  
Click Continue when you are through choosing subcomponents.  
By default, all subcomponents are installed. When you complete your  
selections, you return to the Components to Install dialog box (Step 6).  
Server Core. Install this subcomponent to install the Administration Server  
and the first instance of iPlanet Web Server.  
CAUTION You must install the Server Core subcomponent the first time you  
install iPlanet Web Server. If you install additional subcomponents  
later, you are not required to reinstall the Core subcomponent.  
Java Runtime Environment. If you are installing Java and servlets support,  
you must have a JRE or a JDK. You can install the supplied JRE subcomponent  
or use a JDK already installed on your system. If you want to use your own  
JDK, youll need to supply the path to it later in the installation. For more  
information, see “Installing a Java Developers Kit,” on page 18.  
Java and Servlets. Install this subcomponent if you are planning to use Java  
and servlets.  
You need a JRE or JDK to use iPlanet Web Servers Java support. If you do not  
have one installed on your system, you should install the JRE provided with  
iPlanet Web Server (see the previous subcomponent) or install a JDK.  
38  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
   
Installing on Windows NT  
8. The iPlanet Web Server Administration Server Authentication dialog box  
appears. Type the user name for Administration Server access; the default is  
admin. Type the Administration Server access password; type it again for  
verification. Click Next.  
If you are using LDAP-based authentication, you must make sure that this user  
has access permissions to the LDAP server to perform user/ group  
management tasks.  
If you chose Express Installation, skip to Step 13.  
9. The Web Server Administration Server Port Selection dialog box appears. Type  
the port number the Administration Server runs on. This can be any number  
from 1 to 65535. The URL for administration access is displayed. You might  
want to make a note of this URL. The default port is 8888.  
For more information on ports, see “Choosing Unique Port Numbers” on  
page 16.  
Click Next.  
10. The Default Web Server dialog box appears. A default instance of iPlanet Web  
Server is installed automatically.  
Type a port number for the default instance of your iPlanet Web Server. This  
port should be different than the Administration Server port. If you use a port  
other than the default port (port 80), the URL used to gain access to your home  
page will change. For example, if your computer is called www.iplanet.com  
and you choose port 9753, your servers URL will be  
CAUTION Do not use port 80 if you already have another web server running  
on port 80.  
For more information on ports, see “Choosing Unique Port Numbers” on  
page 16.  
Type the path for the default servers primary document directory, where your  
servers content files (the images, HTML documents and data you want to  
present to users accessing the server) will reside. The default is  
C:/server_root/docs. Click Browse to navigate your file system.  
Chapter  
3
Installing iPlanet Web Server, FastTrack Edition on Windows NT  
39  
 
 
Installing on Windows NT  
11. The Using LDAP for Users and Group Administration dialog box appears. If  
you want to use LDAP, click the checkbox and specify the LDAP URL in the  
format ldap:/ / hostname:port/base DN. For example,  
ldap://iplanet.com:389/o=siroe.com.  
You must also enter the bind DN (for example, cn=Directory Manager) and  
the directory server password.  
If you do not want to use LDAP, leave the checkbox unchecked.  
Click Next.  
12. If you are installing the Java and Servlets subcomponent (installed by default),  
the JDK Configuration dialog box appears. If you are using Java on your  
iPlanet Web Server, you must have a Java Runtime Environment (JRE) or a  
Java Development Kit (JDK) installed. You can use the JRE included with  
iPlanet Web Server (for more information see Step 7) or you can use a custom  
JDK that already resides on your system.  
To use your own JDK, click the Use Custom Java Development Kit checkbox  
and enter the absolute path to the folder where you installed the JDK on your  
system. If you want to use a Library path or Classpath that is different than the  
default for your JDK, enter a different path here.  
13. The Configuration Summary dialog box appears. This dialog box contains  
information about the settings for your iPlanet Web Server and Administration  
Server. It also contains a list of the iPlanet Web Server components you  
selected for installation.  
This dialog box gives you the opportunity to review your settings before the  
installation is complete. If they are correct, click Install. If you want to change  
some of the settings, click Back and correct the information.  
The server files are installed. The Setup Complete dialog box appears.  
Before you can use your administration and web servers, you must either start  
them from the Control Panels Services item, or reboot your machine to start  
them automatically.  
NOTE  
You should not cancel the installation process while the files are  
being copied. If you do, you will have a partial installation you  
need to clean up. If an uninstaller for iPlanet Web Server exists, use  
it to uninstall the portion of iPlanet Web Server you installed. If the  
uninstaller does not exist, manually delete all the files that are in the  
server root.  
40  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
 
Using Uninstall on Windows NT  
14. Click Finish.  
15. Restart your machine or use the Services Control Panel to start the iPlanet Web  
Server.  
16. To configure your iPlanet Web Server, use the URL:  
http://server_name:administration_port  
Enter your administration user name and password to administer the server.  
You can now configure your server. For more information, see the iPlanet Web  
Server Administrator’s Guide.  
Using Uninstall on Windows NT  
You can remove the iPlanet Web Server from your computer by using the uninstall  
application. The uninstall application determines which servers are installed on  
your machine and allows you to choose which of those servers you want to delete.  
CAUTION Though you can select individual subcomponents to uninstall, it is  
not recommended. The uninstaller only removes the parts of the  
code pertaining to the selected subcomponent, but does not update  
configuration files. Your server may not run if you uninstall  
individual subcomponents.  
To remove your iPlanet Web Server:  
1. Go to your server root and double-click on the program uninst.exe.  
2. The iPlanet Uninstall window appears. This window lists all the iPlanet and  
Netscape servers installed in this directory. Click the checkbox next to iPlanet  
Web Server, FastTrack Edition and click Uninstall. Note that uninstalling  
iPlanet Web Server automatically uninstalls the Administration Server, since it  
is an instance of iPlanet Web Server.  
3. The uninstall program uninstalls the server. You see a window showing the  
progress of the uninstall.  
4. When the uninstall is complete, a message appears saying that the  
configuration files have not been deleted, and that you should rename them  
before reinstalling the server. Click OK to continue.  
Chapter  
3
Installing iPlanet Web Server, FastTrack Edition on Windows NT  
41  
 
   
Using Uninstall on Windows NT  
If you have special settings in your configuration files, renaming the files is one  
way you can still access them after reinstalling the server. If you dont rename  
the files, you cannot reinstall the server.  
5. Restart your system. You must reboot before reinstalling iPlanet Web Server.  
During the uninstall, you may see an error “There was an internal error and one of  
the windows you were using has been closed. It is recommended that you save  
your work and close all your programs and then restart your computer.” If you  
receive this message, continue with the uninstall. Since you restart as part of the  
uninstall process, you do not need to do a separate restart.  
NOTE  
The uninstall program does not remove every server file. For  
example, it does not remove keys and certificates, configuration  
files, logs, ACL files or the document root.  
If you install another 4.x server (for example, Netscape Directory Server or  
Messaging Server) on the same machine as iPlanet Web Server, you should have no  
problems uninstalling any server if you install the servers in the same directory. If  
you install the servers in different directories, you need to uninstall iPlanet Web  
Server first, and preserve a copy of a DLL file before uninstalling, as shown in the  
following steps:  
1. Copy NSLDAP32V40.DLLto a temporary directory.  
2. Uninstall iPlanet Web Server.  
3. Copy NSLDAP32V40.DLLback to the directory where Directory Server is  
installed.  
4. Uninstall Directory Server.  
42  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
Chapter 4  
Installing iPlanet Web Server,  
FastTrack Edition on Linux  
This chapter tells you how to install iPlanet Web Server. It contains the following  
sections:  
Installing on Linux  
Using Silent Installation  
Using Uninstall on Linux  
Installing on Linux  
The following sections describe the installation of the iPlanet Web Server.  
CAUTION Do not install iPlanet Web Server on an NFS-mounted drive due to  
potential security and file locking restrictions on remote partitions.  
Logging In as the Correct User  
Before you install the server, you must log in as root, unless you meet both of  
these conditions:  
You plan to install the server on a port greater than 1024.  
The location where you plan to install the server (the server root directory) is  
writable with your non-root login.  
43  
 
             
Installing on Linux  
If you meet both conditions, you do not need to log in as rootto install the server;  
instead log in as the user account that the Administration Server will use.  
However, you may still prefer to log in as root, even though you meet the  
conditions.  
CAUTION You must log in as rootif you are planning to use Express  
installation.  
Unpacking the Files  
To get the iPlanet Web Server files and unpack them, follow these steps:  
1. Download the file from http://www.iplanet.comand save it in a temporary  
directory.  
NOTE  
Untarring the file will cause the permissions of the destination  
directory to be modified so that applications can no longer write  
files to it. To avoid this problem, untar the file in a directory where  
you can modify the permissions. For example, instead of /tmp, use  
a subdirectory under /tmp, for example, /tmp/iwsinstall.  
2. Change to the directory on your Linux machine where you copied the file.  
Unpack the .gzfile by typing gunzipfilename.tar.gz.The file name is in the  
format:  
fasttrack-4.1-security-internationalization.platform.tar.gz  
For example:  
fasttrack-4.1-domestic-us.i686-intel-linux.tar.gz  
3. Untar the unzipped file by typing tar -xvf filename.tar.  
This command unpacks the server files and creates a temporary directory  
structure under the current directory. Unpacking the file may take a little time.  
When the files are unpacked, you see an Enterprise directory, and three files  
LICENSE.txt, README.txt, setup, and setup.inf.  
44  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
 
Installing on Linux  
Running Setup  
You run the setup program to install iPlanet Web Server.  
During the installation process, you have the choice of three kinds of installation:  
Express, Typical, or Custom. Most users should choose Typical or Custom (they  
are identical). Typical or Custom gives you more flexibility in the components you  
can install and the settings you can configure.  
Express installation is for users who have little experience or are evaluating the  
product. It makes assumptions about such things as port number and which  
components to install.  
When running the installer, you can use the following commands:  
Press the Enter key to accept defaults specified in brackets (for example [All]).  
Press CTRL+b to return to a previous screen (note that this sequence does not  
work on all screens).  
Press CTRL+c to cancel the installation program.  
Enter comma-separated lists of numbers when you want to select multiple  
items (for example, 1, 2, 3).  
NOTE  
For Express installation, you must be logged in as root when  
running setup.  
Typical or Custom Installation  
Most users should install the Typical or Custom installation.  
To run setup, follow these steps:  
1. If you are not in the directory already, change to the directory where you  
unpacked the file.  
2. Type ./setupto start the server installation.  
If you arent logged in as the rootuser (superuser), or if you dont have  
sufficient write permissions, youll get one or more error messages.  
A welcome screen appears.  
3. Press Enter to continue with the installation.  
Chapter  
4
Installing iPlanet Web Server, FastTrack Edition on Linux 45  
 
     
Installing on Linux  
4. Choose whether you accept the software license agreement by typing Yes to  
accept, or No to decline. If you have not yet read the license agreement, cancel  
out of the installation and read the file LICENSE.txtthat is in the same  
directory as the setupprogram  
5. Choose Typical or Custom.  
Press Enter.  
6. Type a server root directory or accept the default (/usr/netscape/server4).  
This directory is where the server files and directory structure will be installed.  
You need to run the server as a user that has write access to this directory, for  
example, the directory owner.  
7. Choose all components.  
Press Enter.  
8. Choose the iPlanet Web Server subcomponents to install.  
If you do not install a subcomponent and later decide you want to use it, you  
can run the installer again to install just the missing subcomponent. However,  
you cannot uninstall individual subcomponents once they are installed.  
By default, all subcomponents are installed.  
The subcomponents you can choose to install are described in the following  
numbered sections.  
1. Server Core  
Installs Administration Server and the first instance of iPlanet Web Server.  
CAUTION You must install the Server Core subcomponent the first time you  
install iPlanet Web Server. If you install additional subcomponents  
later, you are not required to reinstall the Core subcomponent.  
2. Java Runtime Environment  
If you are planning to use Java, you must have a Java Runtime  
Environment (JRE) or a Java Developer’s Kit (JDK). You can install the  
provided JRE, or supply your own JDK. For more information, see  
“Installing a Java Developers Kit,” on page 18.  
46  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
   
Installing on Linux  
3. Java Support  
Install this subcomponent if you are planning to use Java servlets or JSPs.  
You also need a JRE or JDK to use iPlanet Web Servers Java support.  
Install the JRE provided with iPlanet Web Server (see the previous  
subcomponent) or install a JDK.  
9. Enter the machine name or accept the default.  
10. Enter the Linux user and group names to use when running the default  
instance of iPlanet Web Server.  
11. Enter the Linux user name to use when running the Administration Server.  
In most cases this user is root.  
12. Enter the Administration Server user name and password to use for  
authentication. You are asked to enter your password twice.  
This user is not a Linux user, but a user name and password in iPlanet Web  
Server. If you are using a Netscape Directory Server, you must make sure that  
the Administration Server user exists in the Directory Server, and that it has  
access permissions to the Directory Server to perform user and group  
management tasks.  
13. Type the Administration Server port number or accept the default of 8888.  
Make sure you remember the port number for the Administration Server.  
For the most flexibility, choose a port number above 1024. If you want to use a  
port number lower than 1024 for your Administration Server, you must be  
logged on as rootto start the server. Do not use a port that is already in use.  
This iPlanet Web Server Administration Server is not the same as the Netscape  
Console, or the Administration Server shipped with other iPlanet/ Netscape  
servers.  
For more information on ports, see “Choosing Unique Port Numbers” on  
page 16.  
14. Type the port number of iPlanet Web Server. The default is 80. This port  
should be different than the Administration Server port. Unless you are  
installing as root, the port must be within the stated range (1024 to 65535). If  
you are installing as rootyou can use port numbers below 1024.  
Chapter  
4
Installing iPlanet Web Server, FastTrack Edition on Linux 47  
 
Installing on Linux  
If you use a port other than the default port (port 80), the URL used to gain  
access to your home page will change. For example, if your computer is called  
www.iplanet.comand you choose port 9753, your servers URL will be  
CAUTION Do not use port 80 if you already have another web server running  
on port 80.  
For more information on ports, see “Choosing Unique Port Numbers” on  
page 16.  
15. Specify whether you are using an LDAP-based directory server (enter Yes or  
No).  
You must use an LDAP directory server if you want to use user and group  
functionality for access control in iPlanet Web Server.  
If you use an LDAP directory server, enter following:  
The LDAP URL in the format ldap:/ / hotname:port/ base DN. For example,  
ldap://iplanet.com:389/o=siroe.com.  
The bind DN (for example, cn=Directory Manager) and the directory  
server password.  
16. Type the root directory where your servers content files (the images, HTML  
documents and data you want to present to users accessing the server) will  
reside. The default is server_root/ docs.  
17. If you want to use your own JDK, enter Yes.  
If you are installing Java support, you must have a JRE or a JDK. You can  
install the supplied JRE subcomponent or use a JDK already installed on your  
system. For more information, see “Installing a Java Developers Kit,” on page  
18.  
18. If you are installing Java support, and you either did not choose to install the  
provided JRE, or you chose to use your own JDK, enter the absolute path to the  
directory where you installed the JDK on your system.  
The JDK must already exist in the specified directory.  
48  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
Installing on Linux  
If the JDK libraries and CLASSPATH are stored in the default directories below  
the JDK directory (/ jre/ lib and / lib, respectively), press Enter at the JDK  
LIBPATH and JDK CLASSPATH prompts. If the libraries and CLASSPATH  
are stored in a different place on your system, enter the pathnames. On most  
systems you will not have to enter pathnames at these prompts.  
19. After the installation program extracts and installs the iPlanet Web Server  
components, press Enter.  
20. Go to the https-adminserv directory under your server root directory (for  
example /usr/netscape/server4) and start the Administration Server by  
typing ./start. You can also type ./startconsolein the server root  
directory.  
If you do not have Netscape Console installed, startconsolestarts  
Administration Server and launches a browser to the Administration Server  
administration pages. If you have a Netscape Console installed, startconsole  
starts the console. For information about registering your iPlanet Web Server  
with the Netscape Console, see “Accessing iPlanet Web Server from the  
Netscape Console,” on page 20.  
21. To configure your iPlanet Web Server, use the URL:  
http://server_name:administration_port  
Enter your administration user name and password.  
You can now configure your iPlanet Web Server. For more information, see the  
iPlanet Web Server Administrator’s Guide.  
Express Installation  
Express installation is for users who have little experience or are evaluating the  
product. It makes assumptions about such things as port number and which  
components to install.  
The following table lists the assumptions made by the Express installation. If you  
would like to use different installation settings, use Typical or Custom installation.  
Chapter  
4
Installing iPlanet Web Server, FastTrack Edition on Linux 49  
 
   
Installing on Linux  
Table 4-1 Express installation settings  
Installation Setting  
administration port  
administration URL  
HTTP port number  
document root  
Value  
8888  
http:/ / machine name:adminisration port  
80  
server_root/ doc  
Linux user to run server  
LDAP users and groups  
JDK  
root  
not using  
none  
JRE  
default JRE shipped with iPlanet Web Server  
All subcomponents installed  
subcomponents  
After installing, you can configure the server to use LDAP users and groups, and to  
use a JDK. For more information on how to make these changes, see the iPlanet Web  
Server Administrator’s Guide.  
CAUTION Do not use Express Installation if you already have another web  
server running on port 80.  
CAUTION You must log in as rootto use Express installation.  
To run setup, follow these steps:  
1. If you are not in the directory already, change to the directory where you  
unpacked the file.  
2. Type ./setupto start the server installation.  
A welcome screen appears.  
3. Press Enter to continue with the installation.  
50  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
Installing on Linux  
4. Choose whether you accepts the software license agreement by entering Yes to  
accept, or No to decline. If you have not yet read the license agreement, cancel  
out of the installation and read the file LICENSE.txtthat is in the same  
directory as the setupprogram  
5. Choose Express and press Enter.  
6. Type a server root directory or accept the default (/usr/netscape/server4).  
This directory is where the server files and directory structure will be installed.  
You need to run the server as root, and rootmust have write access to this  
directory, for example, the directory owner.  
7. Choose all components.  
Press Enter.  
8. Enter the Linux user and group names to use when running the default  
instance of iPlanet Web Server.  
For Express installation, this user must be root. The group must be the group  
to which rootbelongs.  
9. Enter the Linux user name to use when running the Administration Server.  
In most cases, this user is root.  
10. Enter the Administration Server user name and password to use for  
authentication. You are asked to enter your password twice.  
This user is not a Linux user, but a user name and password in iPlanet Web  
Server. If you are using a Netscape Directory Server, you must make sure that  
the Administration Server user exists in the Directory Server, and that it has  
access permissions to the Directory Server to perform user and group  
management tasks.  
11. After the installation program extracts and installs the iPlanet Web Server  
components, press Enter.  
12. Go to the https-adminserv directory under your server root directory (for  
example /usr/netscape/server4) and start Administration Server by typing  
./start. You can also type ./startconsolein the server root directory.  
If you do not have Netscape Console installed, startconsolestarts  
Administration Server and launches a browser to the Administration Server  
administration pages. If you have a Netscape Console installed, startconsole  
Chapter  
4
Installing iPlanet Web Server, FastTrack Edition on Linux 51  
 
Using Silent Installation  
starts the console. For information about registering your iPlanet Web Server  
with the Netscape Console, see “Accessing iPlanet Web Server from the  
Netscape Console,” on page 20.  
13. To configure your iPlanet Web Server, use the URL:  
http://server_name:administration_port  
Enter your administration user name and password.  
You can now configure your iPlanet Web Server. For more information, see the  
iPlanet Web Server Administrator’s Guide.  
Using Silent Installation  
If you want to install several iPlanet Web Servers, you can use silent installation to  
create a file of responses to the setup programs prompts. You can then edit the file,  
install.inf, and use it to install future iPlanet Web Server installations.  
Silent installation works best when you use the Typical installation and your  
installations are all similar.  
CAUTION The install.inffile contains the password used to log on to the  
Administration Server. The password is not encrypted; it is in plain  
text. If you use silent installation, be sure and delete the  
install.inffile once you are through with it.  
To use silent installation, follow these steps:  
1. Run setup with the -k option, which creates a file called install.infthat  
contains all your responses to the installers prompts. At the command prompt,  
type:  
./setup -k  
2. Answer the installer prompts and install iPlanet Web Server.  
3. When the server is installed, go to the server_root/setupdirectory, where youll  
find the install.inffile.  
4. Copy the install.inffile to the directory where you will run setup to install  
your next iPlanet Web Serve.  
52  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
   
Using Silent Installation  
5. Edit the values in the install.inffile to match the values of the next server  
you want to install.  
For example, change the machine name, port number, installation directory,  
etc.  
6. Run setup using the install.inffile for input. For example:  
./setup -s -f install.inf  
7. The server is installed.  
The following is an example of an install.inffile.  
[General]  
FullMachineName= austen.iplanet.com  
SuiteSpotUserID= annh  
SuitespotGroup= staff  
SecurityCheck= False  
RequireDomain= False  
ServerRoot= /usr/netscape/server4  
Components= WebServer  
[WebServer]  
Upgrade= False  
Reinstall= False  
AdminPort= 8888  
HttpPort= 1888  
HttpDocRoot= /usr/netscape/server4/docs  
AdminSysUser= annh  
AdminName= admin  
AdminPassword= password  
UgLdapUse= Yes  
UgLdapUrl= ldap://test:389/o=siroe.com  
UgLdapName= cn=Directory Manager  
UgLdapPassword= password  
JRE_DIR= /usr/netscape/server4/bin/https/jre  
USE_JDK= No  
CompVersions= 2:2:1:2:0:0:0:0:0:  
Components= nescore,JRE,java,cleanup  
[cleanup]  
Archive= cleanup.zip  
Chapter  
4
Installing iPlanet Web Server, FastTrack Edition on Linux 53  
 
Using Uninstall on Linux  
The following table shows some useful install.inf parameters to edit. For best  
results, do not edit any parameters except those listed in the table.  
Table 4-2 Silent Installation Parameters  
Parameter Name  
Use  
FullMachineName  
SuiteSpotUserID  
The machine name.  
The user ID used when running the default instance of the  
iPlanet Web Server.  
SuiteSpotGroup  
The group the user running the default instance of the iPlanet  
Web Server belongs to.  
ServerRoot  
AdminPort  
HttpPort  
The directory where you install the server.  
The Administration Server port.  
The port of the default iPlanet Web Server instance.  
The document root of the iPlanet Web Server instance.  
The user ID used when running the Administration Server.  
HttpDocRoot  
AdminSysUser  
AdminName  
The user name used to access to the Administration Servers  
administration screens.  
AdminPassword  
UgLdapUse  
The password used to access to the Administration Servers  
administration screens.  
Yes and No indicate whether you are using the LDAP  
Directory Server.  
UgLdapUrl  
The LDAP URL of the Directory Server you are using.  
The Bind DN of the Directory Server you are using.  
The Directory Server password.  
UgLdapName  
UgLdapPassword  
JRE_Dir  
If you are installing the JRE shipped with the iPlanet Web  
Server, the directory where it is installed.  
USE_JDK  
JDK_DIR  
Yes and No indicate whether you are using a JDK.  
The directory where your JDK is installed.  
Using Uninstall on Linux  
You can remove iPlanet Web Server from your computer by using the uninstall  
application.  
54  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
   
Using Uninstall on Linux  
CAUTION Though you can select individual subcomponents to uninstall, it is  
not recommended. The uninstaller only removes the parts of the  
code pertaining to the selected subcomponent, but does not update  
configuration files. Your server may not run if you uninstall  
individual subcomponents.  
To remove your iPlanet Web Server:  
1. Go to your server root and type ./uninstall.  
A list of iPlanet and Netscape servers currently installed in this location  
appears.  
2. Find iPlanet Web Server in the list and type the number next to it at the  
prompt.  
Note that uninstalling iPlanet Web Server automatically uninstalls the  
Administration Server, since it is an instance of iPlanet Web Server.  
A list of installed iPlanet Web Server subcomponents appears.  
3. Select all subcomponents and press Return.  
The subcomponents are uninstalled and you return to the command prompt.  
NOTE  
The uninstall program does not remove every server file. For  
example, it does not remove keys and certificates, configuration  
files, logs, ACL files or the document root.  
If you installed another 4.x server (for example, Netscape Directory Server or  
Messaging Server) in the same directory as iPlanet Web Server, follow these steps  
when uninstalling:  
1. Copy the uninstall script (uninstall) to another file, for example,  
uninstslapd.  
2. Use uninstallto uninstall iPlanet Web Server.  
3. Rename uninstslapdto uninstall.  
4. Use uninstallto uninstall Directory Server 4.1.  
Chapter  
4
Installing iPlanet Web Server, FastTrack Edition on Linux 55  
 
Using Uninstall on Linux  
56  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
Chapter 5  
Troubleshooting Your Installation  
This chapter contains information on troubleshooting Windows NT, Unix and  
Linux installations of iPlanet Web Server. It contains the following sections:  
Troubleshooting All Platforms  
Troubleshooting Unix and Linux  
Troubleshooting Windows NT  
Troubleshooting All Platforms  
This section describes the most common installation problems that occur across  
multiple platforms and explains how to solve them.  
Clients cant locate the server. First, try using the hostname. If that doesnt work,  
use the fully qualified name (such as www.machine_name.domain.com), and make  
sure the server is listed in DNS. If that doesnt work, use the IP address.  
The port is in use. Most likely, you didnt shut down a server before you migrated  
the settings from a previous version. Shut down the old server, then manually start  
the new one.  
The port might also be used by another installed server. Make sure the port youve  
chosen isnt already being used by another server.  
Ive forgotten the administration user name and password. In the  
https-adminserv/configdirectory in your server root directory, edit the admpw  
text file, which contains a line of text similar to the following:  
admin:lnOVeixulqkmU  
The text before the colon is the administration user name (in this case, admin); the  
text following the colon is the password, which is encrypted.  
57  
 
           
Troubleshooting Unix and Linux  
Delete everything after the colon and save the file. Shut down the Administration  
Server and restart it. When prompted for the administration password, leave the  
password field blank. You should be able to access the Administration Server now.  
Be sure to create a new password for the Administration Server.  
Ive installed iPlanet Web Server, but the configuration pages do not have all the  
tabs and configuration pages shown in the documentation. If you did not choose  
to install an iPlanet Web Server component, it will not appear in your Server  
Manager forms. For example, if you did not choose to install the Java component,  
the Servlets tab will not appear on the Server Manager page. If you did not install  
all the components you wanted during your initial installation, you can rerun the  
installer, choosing any components you didnt install already.  
for Java support to work, you must have a JRE or JDK installed. If not, your server  
may not start, or may start but generate errors when you try to run Java. To correct  
this problem, run the iPlanet Web Server installation program again, and choose to  
install the JRE, or install a JDK and point your server to it using the Configure  
JRE/ JDK Paths page on the Servlets tab. For more information on JRE and JDK, see  
“Installing a Java Developers Kit” on page 18.  
I received an error during installation and the installation did not complete.  
Sometimes this problem happens if you do not have enough disk space on your  
system. In that case, you simply need to free up more disk space and run the  
installer again. If this error occurred for other reasons you may have to clean up the  
partial installation before you can attempt to install again. Always run the uninstall  
program if the installer got far enough to produce one. After running the uninstall  
program, delete any server files that remain. On Windows NT you may also need  
to clean up the registry entries.  
Troubleshooting Unix and Linux  
This section describes troubleshooting problems that are Unix or Linux specific.  
The server is slow and transfers take too long. If you log accesses through SYSLOG,  
you might encounter reduced performance. Switch to using the servers error log  
files instead.  
The server machine might need more RAM. Also, other applications running on  
the computer might be using CPU cycles, degrading server performance.  
58  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
     
Troubleshooting Windows NT  
Troubleshooting Windows NT  
This section describes troubleshooting problems that are Windows NT specific.  
The installation could not proceed.  
Error: Cant open file for writing.  
Cant write to file filename. The error was error code 32  
Make sure you dont already have a web server running on your system.  
This error message might also appear if you partially completed the installation so  
that the executable was running and youre trying to install the server again. In the  
Control Panel Services dialog box, shut down all the web server services, uninstall  
as necessary, and reinstall the server.  
The following message appeared when installing iPlanet Web Server:  
confhttp: LODCTR returned error code 112. The LODCTR utility is used to set up  
performance monitoring-related keys in your Windows NT registry. Error 112  
means that it ran out of space either on your hard disk or in the registry. You  
should first make sure you have plenty of free space on your hard disk; if you do,  
then Windows NT may have filled up its registry. You can check this by going to  
your control panels, opening System, clicking the Performance tab, and clicking  
Change in the Virtual Memory section. The window that comes up shows the  
current registry size and the maximum registry size; if current is near maximum,  
then raise the maximum setting, reboot, and try installing iPlanet Web Server  
again.  
I couldnt access the server after installing it and restarting. You need to have a  
static IP address for iPlanet Web Server to work properly. If you are using DHCP,  
the installation process writes the IP address used by your system at the time of  
installation to magnus.conf. If your IP address changes, you will not be able to  
access your server. To get your server to work temporarily, edit magnus.conf so  
that the address specified is your current IP address. To find your IP address, type  
ipconfigat the command line. The permanent fix is to get a static IP address.  
Chapter  
5
Troubleshooting Your Installation  
59  
 
     
Troubleshooting Windows NT  
60  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 
Index  
JDK, 18  
C
CNAME, DNS and, 14  
Communicator, installing, 17  
Compaq Tru64 Unix, version, 11  
Console, iPlanet Web Server integration with, 20  
Unix, 21  
D
Directory Server installing, 18  
documentation, related, 7  
dynamic IP address, 59  
express, 27  
typical or custom, 23  
uninstall, 32  
user account needed for, 22, 43  
Windows NT, 35  
uninstall, 41  
H
hardware requirements  
Linux, 13  
J
Unix, 12  
Windows NT, 12  
JDK  
obtaining, 18  
required version, 19  
JRE component, 25, 38, 46  
I
IBM AIX, version, 11  
installing  
61  
 
   
L
S
Linux installation, 43  
Linux user accounts, 14  
Linux, version, 11  
server name  
server user account, 14  
servers, removing, 32, 41, 54  
silent installation, 30, 52  
slow performance on Unix, 58  
SNMP, Unix and Linux user for, 15  
M
manual conventions, 6  
T
N
Netscape Communicator, 17  
U
uninstall, 54  
O
Unix, 32  
online help, 7  
Unix installation, 21  
Unix user accounts, 14  
user accounts  
LocalSystem, 16  
nobody, 15  
P
platform requirements, 11  
port in use error message, 57  
W
Windows NT installation, 35  
R
Windows NT, version, 11  
Red Hat Linux, version, 11  
62  
iPlanet Web Server, FastTrack Edition Installation Guide • June 2000  
 

Sony Cell Phone T68i User Manual
Sony Headphones MDR D777LP User Manual
Sony Laptop P C G R 6 0 0 H M P User Manual
Sony Projector VPL VW85 User Manual
Soundstream Technologies Portable Speaker SPL 60 User Manual
Sub Zero Fryer IF15 S User Manual
Sub Zero Refrigerator ICBBI 30UG User Manual
Sunbeam Food Processor SM6200 User Manual
SVA Flat Panel Television VR2008W User Manual
Tannoy Portable Speaker DS15i User Manual