Chapter 3
Installing iPlanet Web Server, Enterprise Edition on Windows NT
This chapter tells you how to install iPlanet Web Server on Windows NT. It contains the following sections:
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 beta versions of iPlanet servers installed, uninstall them before installing the final version.
Because of DLL conflicts, if you install iPlanet Web Server 6.0 and iPlanet Web Server 4.x on the same machine, uninstall 4.x after you migrate it to iPlanet Web Server 6.0. When you uninstall iPlanet Web Server 4.x, don't delete any shared dll files (when asked, choose "No to All"). If not, you will have trouble uninstalling iPlanet Web Server 6.0 later.
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 6.0.
If you install both iPlanet 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.
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:
Installing from an iPlanet Web Server, Enterprise Edition CD
Put the iPlanet Web Server, Enterprise Edition CD in the drive. Click the icon representing your CD-ROM drive.
Double-click the ntx86 folder.
Double-click the enterprise folder.
- The setup.exe file is inside this folder.
Installing a Downloaded Server
Download the file ee60nt.exe and save it in a temporary directory.
Double-click the file to extract the files and launch the installation program.
Running setup.exe
Run the setup.exe program to install iPlanet Web Server.
Double-click the setup.exe file (if you downloaded the file, this happens automatically when you double-click the downloaded file).
The Welcome screen appears. After reading the Welcome screen, click Next.
The Software License Agreement appears. Click Yes to accept the license.
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.
Table 3-1 Express installation settings
|
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
|
|
Caution
|
Do not use Express Installation if you already have another web server running on port 80.
|
- Click Next.
The Location of Installation dialog box appears. The default location for the server files is C:\iplanet\servers, 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.
The Components to Install dialog box appears. Select iPlanet Web Server, Enterprise 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.
|
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.
- If you are migrating from iPlanet Web Server 4.x, when you install subcomponents, you must install all the subcomponents you installed for 4.x, otherwise they may not work. You can install additional subcomponents as well.
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).
|
Caution
|
You must install the Server Core and Java Support subcomponents the first time you install iPlanet Web Server. If you install additional subcomponents later, you are not required to reinstall the Core subcomponent.
|
- Server Core. Install this subcomponent to install the Administration Server and the first instance of iPlanet Web Server.
- Java Runtime Environment. If you are planning to use the Administration Server and/or 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, you'll need to supply the path to it later in the installation. For more information, see Installing a Java Developer's Kit.
- Java Support. Install this subcomponent if you are planning to use the Administration Server and/or Java and servlets.
- Search and Indexing Support. Install this subcomponent to search the contents and attributes of documents on the server. As the server administrator, you can create a customized text search interface tailored to your user community.
- SNMP Support. Install this subcomponent if you are planning to use SNMP to monitor your servers.
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 12.
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.
- If iPlanet Web Server 4.x is installed on your system, do not use the same Administration Server port number for iPlanet Web Server 6.0 as you used for iPlanet Web Server 4.x.
- For more information on ports, see Choosing Unique Port Numbers.
- Click Next.
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 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.
- Type the path for the default server's primary document 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 C:/server_root/docs. Click Browse to navigate your file system.
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 or SDK) 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. For example, D:\jdk1.2\.
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 Panel's 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.
|
Click Finish.
Restart your machine or use the Services Control Panel to start the iPlanet Web Server.
To configure your iPlanet Web Server, use the URL:
http://server_name:administration_port
- For example: http://www.iplanet:8888
- Enter your administration user name and password to administer the server.
You can now configure your server. For more information, see the 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 for 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.
|
Because iPlanet Web Server, Enterprise Edition is downloaded as a self-extracting .exe file, you must first extract the files before running setup.exe. To extract the files, follow these steps:
Double-click the self-extracting .exe file to start the installer.
When you launch the installer, it unpacks the files to your TEMP directory. Without exiting the installer, go to the TEMP directory and copy the installation files to another location.
Once the files are copied, exit the installer.
You now have a copy of setup.exe that you can use for creating the install.inf file.
To use silent installation, follow these steps:
From the command line, 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.exe -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 Server.
Edit the values in the install.inf file to match the values of the next server you want to install.
- For example, change the port number, installation directory, etc.
Run setup using the install.inf file for input. For example:
- setup.exe -s -f install.inf
The server is installed.
The following is an example of an install.inf file.
|
[General]
Components=svrcore,WebServer
ServerRoot=D:\iplanet\Servers
[WebServer]
Components=NESCore,JRE,Java,Cleanup
AdminPort=8888
HttpPort=80
HttpDocRoot=D:\iplanet\Servers\docs
AdminName=admin
AdminPassword=admin
[Java]
JRE_DIR=D:/iplanet/servers/bin/https/jre
[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 3-2 Silent Installation Parameters
|
Parameter Name
|
Use
|
|
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.
|
|
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.
|
|
JRE_Dir
|
If you are installing the JRE shipped with the iPlanet Web Server, the directory where it is installed.
|
|
JDK_DIR
|
The directory where your JDK is installed.
|
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:
Go to your server root and double-click on the program uninst.exe.
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, Enterprise Edition and click Uninstall. Note that uninstalling iPlanet Web Server automatically uninstalls the Administration Server, since it is an instance of iPlanet Web Server.
The uninstall program uninstalls the server. You see a window showing the progress of the uninstall.
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.
- 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.
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 a 4.x server (for example, iPlanet 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:
Copy NSLDAP32V50.DLL to a temporary directory.
Uninstall iPlanet Web Server.
Copy NSLDAP32V50.DLL back to the directory where Directory Server is installed.
Uninstall Directory Server.