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
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.
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:
Download the file from http://www.iplanet.com and 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.
|
Change to the directory on your Linux machine where you copied the file.
- Unpack the .gz file by typing gunzip filename.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
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.
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:
If you are not in the directory already, change to the directory where you unpacked the file.
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.
Press Enter to continue with the installation.
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
Choose Typical or Custom.
- Press Enter.
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.
Choose all components.
- Press Enter.
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 Developer's Kit."
- 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.
Enter the machine name or accept the default.
Enter the Linux user and group names to use when running the default instance of iPlanet Web Server.
Enter the Linux user name to use when running the Administration Server.
- In most cases this user is root.
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.
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.
- 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."
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 root you 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.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."
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.
Type the root directory where your server's 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.
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 Developer's Kit."
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.
After the installation program extracts and installs the iPlanet Web Server components, press Enter.
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 ./startconsole in the server root directory.
- If you do not have Netscape Console installed, startconsole starts 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".
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.
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.
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. 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 root to use Express installation.
|
To run setup, follow these steps:
If you are not in the directory already, change to the directory where you unpacked the file.
Type ./setup to start the server installation.
- A welcome screen appears.
Press Enter to continue with the installation.
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
Choose Express and press Enter.
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 root must have write access to this directory, for example, the directory owner.
Choose all components.
- Press Enter.
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 root belongs.
Enter the Linux user name to use when running the Administration Server.
- In most cases, this user is root.
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.
After the installation program extracts and installs the iPlanet Web Server components, press Enter.
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 ./startconsole in the server root directory.
- If you do not have Netscape Console installed, startconsole starts 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."
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
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.
Silent installation works best when you use the Typical installation and your installations are all similar.
|
Caution
|
The install.inf file 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.inf file once you are through with it.
|
To use silent installation, follow these steps:
Run setup with the -k option, which creates a file called install.inf that contains all your responses to the installer's prompts. At the command prompt, type:
- ./setup -k
Answer the installer prompts and install iPlanet Web Server.
When the server is installed, go to the server_root/setup directory, where you'll find the install.inf file.
Copy the install.inf file to the directory where you will run setup to install your next iPlanet Web Serve.
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.
Run setup using the install.inf file for input. For example:
- ./setup -s -f install.inf
The server is installed.
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.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 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.
|
|
ServerRoot
|
The directory where you install the server.
|
|
AdminPort
|
The Administration Server port.
|
|
HttpPort
|
The port of the default iPlanet Web Server instance.
|
|
HttpDocRoot
|
The document root of the iPlanet Web Server instance.
|
|
AdminSysUser
|
The user ID used when running the Administration Server.
|
|
AdminName
|
The user name used to access to the Administration Server's administration screens.
|
|
AdminPassword
|
The password used to access to the Administration Server's administration screens.
|
|
UgLdapUse
|
Yes and No indicate whether you are using the LDAP Directory Server.
|
|
UgLdapUrl
|
The LDAP URL of the Directory Server you are using.
|
|
UgLdapName
|
The Bind DN of the Directory Server you are using.
|
|
UgLdapPassword
|
The Directory Server password.
|
|
JRE_Dir
|
If you are installing the JRE shipped with the iPlanet Web Server, the directory where it is installed.
|
|
USE_JDK
|
Yes and No indicate whether you are using a JDK.
|
|
JDK_DIR
|
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.
|
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:
Go to your server root and type ./uninstall.
- 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.
- A list of installed iPlanet Web Server subcomponents appears.
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:
Copy the uninstall script (uninstall) to another file, for example, uninstslapd.
Use uninstall to uninstall iPlanet Web Server.
Rename uninstslapd to uninstall.
Use uninstall to uninstall Directory Server 4.1.