Installation Guide iPlanet Web Server, FastTrack Edition Version 4.
Copyright © 2000 Sun Microsystems, Inc. Some preexisting portions Copyright © 2000 Netscape Communications Corporation. All rights reserved. Sun, Sun Microsystems, and the Sun logo, iPlanet, and the iPlanet logo are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. Netscape and the Netscape N logo are registered trademarks of Netscape Communications Corporation in the U.S. and other countries.
Contents About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 What You Need to Know . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 What’s in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Document Conventions . . . . . . . . . . .
Chapter 2 Installing iPlanet Web Server, FastTrack Edition on Unix . . . . . . . . . . . . . . . . . . Installing on Unix Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing from a CD Shipped With Solaris 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Logging In as the Correct User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
About This Guide This guide explains how to install iPlanet™ Web Server, FastTrack Edition.
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.
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: http://docs.iplanet.com/docs/manuals/enterprise.html The information in this guide is also part of the help system for iPlanet Web Server.
Where to Find Related Information These are the iPlanet Web Server, FastTrack Edition documents that are available: 8 • 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 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.
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.
Supported Platforms 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 Architecture Required Memory Required Disk Space Compaq Tru64 UNIX 4.0d; 4.0e and 4.0f supported through binary compatibility. Alpha 64 MB minimum 110 MB minimum Hewlett-Packard HP-UX 11.
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.
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.
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.
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 don’t create a dedicated user account for iPlanet Web Server, on many platforms you can use the account with the name nobody, but you might not want to give the user nobody permissions for running the iPlanet Web Server. In addition, the user nobody might not work on some systems.
Other Technical Requirements During installation, the server uses the LocalSystem account, not the user account you created. Once you start and run the server, you should use the user account you created. You can change the user account for the server after the installation process. You can configure that user account so that it has permissions to get files on another computer, so that your server can serve files that are mounted from another computer.
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 root to start the server. After the server binds to the port, the server changes from the root user account to the user account you specify. If you choose a port number higher than 1024, you don’t have to be the root user to start the server. Installation Overview You can install iPlanet Web Server by downloading it off the iPlanet web site.
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/.
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 won’t run.
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 installMCC script after you install iPlanet Web Server and the Netscape Console. installMCC is a perl script found in server_root/bin/https/bin. To run the script, follow these steps: 1.
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.
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.
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.
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 ./setup to start the server installation. If you aren’t logged in as the root user (superuser), or if you don’t have sufficient write permissions, you’ll get one or more error messages. A welcome screen appears. 3. Press Enter to continue with the installation. 4.
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 Developer’s Kit,” on page 18.
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 root to start the server. Do not use a port that is already in use.
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 Developer’s 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.
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.
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. root must 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.
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, and use it to install future iPlanet Web Server installations.
Using Silent Installation The following is an example of an install.inf file. [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.
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 The directory where you install the server. AdminPort The Administration Server port. HttpPort The port of the default iPlanet Web Server instance.
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.
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.
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 TEMP environment variable. Make sure there is enough room on the device TEMP points 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.exe and save it in a temporary directory.
Installing on Windows NT Table 3-1 Express installation settings CAUTION Installation Setting Vales administration port 8888 administration URL http://machine name:adminisration port HTTP port number 80 document root server_root/doc LDAP users and groups not using JDK none JRE default JRE shipped with iPlanet Web Server subcomponents All default subcomponents installed Do not use Express Installation if you already have another web server running on port 80. Click Next. 5.
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 you’ve 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.
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.
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.
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 For example: http://iplanet:8888 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 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 don’t 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.
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.
Installing on Linux If you meet both conditions, you do not need to log in as root to 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 root if 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.
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.
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.txt that is in the same directory as the setup program 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.
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 Server’s 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.
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.com and you choose port 9753, your server’s URL will be http://www.iplanet.com:9753/ 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.
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.
Installing on Linux Table 4-1 Express installation settings Installation Setting Value administration port 8888 administration URL http://machine name:adminisration port HTTP port number 80 document root server_root/doc Linux user to run server root LDAP users and groups not using JDK none JRE default JRE shipped with iPlanet Web Server subcomponents All subcomponents installed After installing, you can configure the server to use LDAP users and groups, and to use a JDK.
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.txt that is in the same directory as the setup program 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.
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 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.
Using Silent Installation 5. Edit the values in the install.inf file 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.inf file for input. For example: ./setup -s -f install.inf 7. The server is installed. The following is an example of an install.inf file. [General] FullMachineName= austen.iplanet.
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 The machine name. 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.
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.
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 can’t locate the server.
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. I’ve installed iPlanet Web Server, but the configuration pages do not have all the tabs and configuration pages shown in the documentation.
Troubleshooting Windows NT Troubleshooting Windows NT This section describes troubleshooting problems that are Windows NT specific. The installation could not proceed. Error: Can’t open file for writing. Can’t write to file filename. The error was error code 32 Make sure you don’t 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 you’re trying to install the server again.
Troubleshooting Windows NT 60 iPlanet Web Server, FastTrack Edition Installation Guide • June 2000
Index C Communicator, 17 core component, 25, 46 Directory Server, 18 from a script, 30, 52 JDK, 18 JRE, 25, 38, 46 Linux, 43 express, 49 typical or custom, 45 uninstall, 54 Netscape Console, 18 preparation for, 9 Unix, 21 express, 27 typical or custom, 23 uninstall, 32 user account needed for, 22, 43 Windows NT, 35 uninstall, 41 CNAME, DNS and, 14 Communicator, installing, 17 Compaq Tru64 Unix, version, 11 Console, iPlanet Web Server integration with, 20 core component, 25, 46 D Directory Server install
L S Linux installation, 43 Linux user accounts, 14 Linux, version, 11 LocalSystem user account, 16 server name aliases, 14 changing, 14 CNAME and, 14 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 Sun Solaris, version, 11 M manual conventions, 6 manuals, online versions, 7 T N technical requirements, 14 Netscape Communicator, 17 nobody user account, 15 U O online help, 7 online versions of manuals, 7
