Sun Microsystems iPlanet Web Server Installation Manual
  1. Manuals
  2. Brands
  3. Sun Microsystems Manuals
  4. Server
  5. iPlanet Web Server
  6. Installation manual
Sun Microsystems iPlanet Web Server Installation Manual

Sun Microsystems iPlanet Web Server Installation Manual

Fasttrack edition
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual

Installation Guide

iPlanet Web Server, FastTrack Edition
Version 4.1
June 2000

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the iPlanet Web Server and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Sun Microsystems iPlanet Web Server

Summary of Contents for Sun Microsystems iPlanet Web Server

  • Page 1: Installation Guide

    Installation Guide iPlanet Web Server, FastTrack Edition Version 4.1 June 2000...
  • Page 2 Copyright © 2000 Sun Microsystems, Inc. Pour certaines parties préexistantes, Copyright © 2000 Netscape Communication Corp. Tous droits réservés. Sun, Sun Microsystems, et the Sun logo, iPlanet, and the iPlanet logo sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc. aux Etats-Unis et d’autre pays. Netscape et the Netscape N logo sont des marques déposées de Netscape Communications Corporation aux...

  • Page 3: Table Of Contents

    Accessing iPlanet Web Server from the Netscape Console ....... . .
  • Page 4 Chapter 2 Installing iPlanet Web Server, FastTrack Edition on Unix ....21 Installing on Unix Platforms ............. 21 Installing from a CD Shipped With Solaris 8 .

  • Page 5: About This Guide

    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. About This Guide...

  • Page 6: What's In This Guide

    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: Find out what you need to do before...

  • Page 7: Where To Find This Guide Online

    You can find the iPlanet Web Server Installation Guide online in PDF and HTML formats. To find these files, use this URL: http://docs.iplanet.com/docs/manuals/enterprise.html The information in this guide is also part of the help system for iPlanet Web Server. See “How to Use Online Help.” How to Use Online Help...
  • Page 8 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 •...

  • Page 9: Chapter 1 Before You Install Iplanet Web Server, Fasttrack Edition

    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. Before You Install iPlanet Web...

  • Page 10: Differences Between Fasttrack Edition And Enterprise Edition

    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.

  • Page 11: More Information

    More Information For a full description of the iPlanet Web Server, Enterprise Edition, see: http://www.iplanet.com/products/infrastructure/web_servers/index.html Supported Platforms iPlanet Web Server, FastTrack Edition runs on these platforms: Table 1-1 Supported Platforms Operating System Compaq Tru64 UNIX 4.0d; 4.0e and 4.0f supported through binary compatibility.

  • Page 12: Hardware And Software Requirements

    “Installing a Java Developer’s Kit,” on page 18. Windows NT • If you plan on running more than two separate instances of iPlanet Web Server on your system, an additional 16 MB RAM for each server instance. •...

  • Page 13: Linux

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

  • Page 14: Other Technical Requirements

    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.

  • Page 15: Windows Nt User Accounts For The Server

    If you don’t create a dedicated user account for iPlanet Web Server, on many platforms you can use the account with the name to give the user permissions for running the iPlanet Web Server.

  • Page 16: Choosing Unique Port Numbers

    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.

  • Page 17: Installation Overview

    NOTE 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: 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.

  • Page 18: Installing Netscape Directory Server

    If you are planning to use Java, you must install a Java Runtime Environment (JRE) or a Java Developer’s Kit (JDK). iPlanet Web Server includes a JRE that you can install during the installation process. However, you may prefer to install a JDK.
  • Page 19 Linux requires a JDK of 1.2.2 or higher, release candidate 4 or later. Download a JDK at: http://www.blackdown.org You can install the JDK before you install iPlanet Web Server, and provide the path to it during installation, or you can wait until after you’ve installed iPlanet Web Server to install it.

  • Page 20: Accessing Iplanet Web Server From The Netscape Console

    Accessing iPlanet Web Server from the Netscape Console NOTE 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 installMCC Console. installMCC To run the script, follow these steps:...

  • Page 21: 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.

  • Page 22: Logging In As The Correct User

    Before you install iPlanet Web Server, you must log in as 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.

  • Page 23: Running Setup

    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).
  • Page 24 1. Server Core Installs the Administration Server and the first instance of iPlanet Web Server. iPlanet Web Server, FastTrack Edition Installation Guide • June 2000 to start the server installation. user (superuser), or if you don’t have root LICENSE.txt...
  • Page 25 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 Server’s Java support. Install the JRE provided with iPlanet Web Server (see the previous subcomponent) or install a JDK.
  • Page 26 For more information on ports, see “Choosing Unique Port Numbers” on page 16. 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...

  • Page 27: Express Installation

    For example: http://iplanet:8888 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.
  • Page 28 No to decline. If you have not yet read the license agreement, cancel out of the installation and read the file directory as the iPlanet Web Server, FastTrack Edition Installation Guide • June 2000 Value 8888 http://machine name:adminisration port...
  • Page 29 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. After the installation program extracts and installs the iPlanet Web Server components, press Enter. Go to the...

  • Page 30: Using Silent Installation

    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 program’s prompts. You can then edit the file, install.inf...
  • Page 31 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 FullMachineName The machine name. file. install.inf Chapter 2 Installing iPlanet Web Server, FastTrack Edition on Unix Using Silent Installation...

  • Page 32: Using Uninstall On Unix

    USE_JDK JDK_DIR Using Uninstall on Unix You can remove iPlanet Web Server from your computer by using the uninstall application. iPlanet Web Server, FastTrack Edition Installation Guide • June 2000 The user ID used when running the default instance of the iPlanet Web Server.
  • Page 33 Go to your server root and type A list of iPlanet and Netscape servers currently installed in this location appears. 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.
  • Page 34 Using Uninstall on Unix iPlanet Web Server, FastTrack Edition Installation Guide • June 2000...

  • Page 35: Chapter 3 Installing Iplanet Web Server, Fasttrack Edition On Windows Nt

    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.

  • Page 36: Unpacking The Files

    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 variable. Make sure there is enough room on the device starting the installation.
  • Page 37 C:\Netscape\Server4 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.
  • Page 38 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 Server’s 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.
  • Page 39 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.
  • Page 40 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.

  • Page 41: Using Uninstall On Windows Nt

    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.
  • Page 42 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...

  • Page 43: 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.

  • Page 44: Unpacking The Files

    CAUTION You must log in as installation. Unpacking the Files To get the iPlanet Web Server files and unpack them, follow these steps: Download the file from directory. NOTE Change to the directory on your Linux machine where you copied the file.

  • Page 45: Running Setup

    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.
  • Page 46 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. You must install the Server Core subcomponent the first time you CAUTION install iPlanet Web Server.
  • Page 47 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 Server’s Java support. Install the JRE provided with iPlanet Web Server (see the previous subcomponent) or install a JDK.
  • Page 48 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. iPlanet Web Server, FastTrack Edition Installation Guide • June 2000 and you choose port 9753, your server’s URL will be...

  • Page 49: Express Installation

    For example: http://iplanet:8888 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.
  • Page 50 If you are not in the directory already, change to the directory where you unpacked the file. Type ./setup A welcome screen appears. Press Enter to continue with the installation. iPlanet Web Server, FastTrack Edition Installation Guide • June 2000 Value 8888 http://machine name:adminisration port server_root/doc root...
  • Page 51 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. After the installation program extracts and installs the iPlanet Web Server components, press Enter. Go to the...

  • Page 52: Using Silent Installation

    For example: 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 program’s prompts.
  • Page 53 UgLdapPassword= password JRE_DIR= /usr/netscape/server4/bin/https/jre USE_JDK= CompVersions= 2:2:1:2:0:0:0:0:0: Components= nescore,JRE,java,cleanup [cleanup] Archive= cleanup.zip Chapter 4 file to match the values of the next server file for input. For example: file. install.inf Installing iPlanet Web Server, FastTrack Edition on Linux Using Silent Installation...

  • Page 54: Using Uninstall On Linux

    JRE_Dir USE_JDK JDK_DIR Using Uninstall on Linux You can remove iPlanet Web Server from your computer by using the uninstall application. iPlanet Web Server, FastTrack Edition Installation Guide • June 2000 The machine name. The user ID used when running the default instance of the iPlanet Web Server.
  • Page 55 Go to your server root and type A list of iPlanet and Netscape servers currently installed in this location appears. 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.
  • Page 56 Using Uninstall on Linux iPlanet Web Server, FastTrack Edition Installation Guide • June 2000...

  • Page 57: Chapter 5 Troubleshooting Your Installation

    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.

  • Page 58: Troubleshooting Unix And Linux

    You should be able to access the Administration Server now. Be sure to create a new password for the Administration Server. I’ve 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.

  • Page 59: Troubleshooting Windows Nt

    I couldn’t 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.
  • Page 60 Troubleshooting Windows NT iPlanet Web Server, FastTrack Edition Installation Guide • June 2000...

  • Page 61: Index

    CNAME, DNS and, 14 Communicator, installing, 17 Compaq Tru64 Unix, version, 11 Console, iPlanet Web Server integration with, 20 core component, 25, 46 Directory Server installing, 18 documentation, related, 7 dynamic IP address, 59 hardware requirements Linux, 13 Unix, 12...

  • Page 62: Iplanet Web Server, Fasttrack Edition Installation Guide • June

    7 platform requirements, 11 port in use error message, 57 port numbers, 16 Red Hat Linux, version, 11 iPlanet Web Server, FastTrack Edition Installation Guide • June 2000 server name aliases, 14 changing, 14 CNAME and, 14...

Table of Contents