Chapter 2 Installing Netscape Enterprise Server

This chapter tells you how to install Netscape Enterprise Server. It contains the following sections:

• Installation Overview
• Installing Netscape Communicator
• Installing Netscape Directory Server
• Installing Netscape Console
• Installing a Java Developer's Kit
• Installing Enterprise Server for Unix
• Installing Enterprise Server for Windows NT
• Using Uninstall for Unix
• Using Uninstall for Windows NT
• Installing ValiCert Web Server Validator

1. If you have an existing Enterprise Server or FastTrack Server already installed, shut it down and save a backup copy of the server's files.
2. If you do not already have either Communicator 4.5 or Internet Explorer 4.01 installed, install the version of Communicator provided on your Enterprise Server CD.
3. If you are planning to use users and groups, and you do not have a Directory Server installed, install it from the Netscape Directory Server CD included with your Enterprise Server. 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 Netscape Enterprise Server.

1. Put the Netscape Enterprise Server CD-ROM in the drive and change to the directory for the Unix operating system that your computer uses.

For example, if you are using a Solaris system, type cd solaris.

2. Change to the comm45 directory on the CD-ROM.
3. Copy the comm45.tar file from the CD-ROM to a temporary directory on your local disk.
4. Change to the staging directory on your local disk and untar the comm45.tar file by typing tar -xvf comm45.tar.
5. At the command line, type ./setup to start the Communicator installation.
6. Follow the onscreen instructions.

1. Put the Netscape Enterprise Server CD-ROM in the drive and double-click the ntx86 folder.
2. Double-click to the comm45 folder.
3. Double-click setup.exe.
4. Follow the onscreen instructions.

Note. Because the copy of Directory Server that is bundled with Enterprise Server contains a limited license, any support contract you purchase for Enterprise Server is limited in Directory Server coverage to usage allowed by the license.

• Java servlets
• server-side JavaScript database connectivity (LiveWire)

You need a JDK to run the following feature (it will not run with a JRE):

• Java Server Pages (JSPs)

• Enterprise Server on Sun Solaris requires JDK 1.2 or higher. Download a JDK at:

http://java.sun.com/products/OV_jdkProduct.html

• Enterprise Server on HP-UX requires JDK 1.1. (C.01.17.01 or any higher 1.1 version). Download a JDK at:

http://www.hp.com/go/java

• Enterprise Server on IBM AIX requires JDK 1.1.6. Download a JDK at:

http://www.ibm.com/java/jdk/download/index.html

• Enterprise Server on Compaq Tru64 UNIX requires JDK 1.2.1. Download a JDK at:

http://www.compaq.com/java

• Enterprise Server on Windows NT requires a JDK of 1.2.2 or higher. Download a JDK at:

http://java.sun.com/products/OV_jdkProduct.html

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 you non-root login.

Unpacking the Files
To get the Netscape Enterprise Server files and unpack them, follow these steps:

1. Put the CD-ROM in the drive.
2. Change to the Enterprise Server CD in the CD-ROM directory.
3. Change to the directory on the CD-ROM labeled with the Unix operating system that your computer uses (for example, type cd solaris)
4. Type cd entprise to change to the installation directory.
5. Copy the entprise.tar file from the CD-ROM directory to your home directory or a temporary directory.

Copying the file may take a little time.

6. Change to the directory on your Unix machine where you copied the file.
7. Untar the file by typing tar -xvf entprise.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, setup, and setup.inf.

1. Download the file from the Netscape web site http://home.netscape.com and save it in a temporary directory.
2. Change to the directory on your Unix machine where you copied the file.

Unpack the .gz file by typing gunzip filename.tar.gz. The file name is in the format:

enterprise-4.0-security-internationalization.platform.tar.gz

For example:

enterprise-4.0-export-us.hppa1.1-hp-hpux11.00.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, setup, and setup.inf.

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

Typical or Custom Installation
Most users should install the typical or custom installation.

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. Choose whether you accepts the software license agreement by typing Yes to accept, or No to decline.
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.

If you already have other Netscape 4.x servers installed, and you want to register Enterprise Server with Netscape Console, install all 4.x servers into the same directory.

7. Choose Netscape Enterprise Server.

Press Enter.

8. Choose the Enterprise Server components to install.

If you do not install a component and later decide you want to use it, you can run the installer again to install just the missing component. However, you cannot uninstall individual components once they are installed.

By default, all components except WAI support are installed.

1. Netscape Enterprise Server Core

Installs Enterprise Administration Server and the first instance of Enterprise Server.

The seven components you can choose to install are described in the following numbered sections.

Warning.

You must install the Netscape Enterprise Server Core component the first time you install Enterprise Server. If you install additional components later, you are not required to reinstall the Core component.

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

Warning.

If you are using HP-UX, you must install the JRE or supply a JDK. Without one or the other, the HP-UX Enterprise Server won't run.

3. Netscape Enterprise Server Java Support

Install this component if you are planning to use Java servlets.

You also need a JRE or JDK to use Enterprise Server's Java support. Install the JRE provided with Enterprise Server (see the previous component) or install a JDK.

4. Netscape Enterprise Server SSJS Database Support

Install this component if you are planning to use server-side JavaScript database connectivity (LiveWire). If you plan to use this feature, you also need to install Netscape Enterprise Server Java Support (item 3), and either install the JRE (item 2) or supply a JDK.

5. Netscape Enterprise Server WebPub Support

Install this component if you are planning to use the Web Publishing, Netshare, or search features.

6. Netscape Enterprise Server SNMP Support

Install this component if you are planning to use SNMP.

7. Netscape Enterprise Server WAI Support

Install this component if you are planning to run Web Application Interface programs. If you are using WAI, you must also have an ORB. You will have to provide the installation program with the path to the ORB on your system later in the installation process.

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 Enterprise Server.

The default user is nobody.

11. Enter the Unix user name to use when running the Enterprise Administration Server.

In most cases this user is root.

12. Enter the Enterprise 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 Enterprise 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 Enterprise Administration Server port number or accept the default of 8888.

Make sure you remember the port number for the Enterprise 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 Enterprise Administration Server, you must be logged on as root to start the server.

This Enterprise Administration Server is not the same as the Netscape Console.

14. Type the port number of Enterprise Server. The default is 80. This port should be different than the Enterprise Administration Server port. The suggested range of ports (1024 to 65535) only applies if you are not installing as root.

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.mozilla.com and you choose port 9753, your server's URL will be
http://www.mozilla.com:9753/

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 in Enterprise Server.

If you use an LDAP directory server, enter following:

• The LDAP URL in the format ldap://hotname:port/base DN. For example, ldap://mozilla.com:389/o=airius.com.
• The bind DN (for example, cn=Directory Manager) and the directory server password.
16. Type the root directory where your server's content files 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 component or use a JDK already installed on your system. For more information, see "Installing a Java Developer's Kit."

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.

19. If you chose to install WAI, you must give the path to the directory where your Object Request Broker (ORB) is stored. To get the Visibroker 3.3 ORB, contact Inprise at http://www.inprise.com.
20. After the installation program extracts and installs the Enterprise Server components, press Enter.
21. Go to the https-admserv directory under your server root directory and start the Enterprise Administration Server by typing ./start. You can also type ./startconsole in the server root directory.

If you have a Netscape console installed, startconsole starts the console. If you do not have a console installed, it starts Enterprise Administration Server and launches a browser to the Enterprise Administration Server administration pages.

22. To configure your Enterprise Server, use the Enterprise Administration URL: http://server_name:administration_port

For example: http://mozilla:8888

Enter your administration user name and password.

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.

A welcome screen appears.

3. Press Enter to continue with the installation.
4. Choose whether you accepts the software license agreement by entering Yes to accept, or No to decline.
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 a user that has write access to this directory, for example, the directory owner.

If you already have other Netscape 4.x servers installed, and you want to register Enterprise Server with Netscape Console, install all 4.x servers into the same directory.

7. Choose Netscape Enterprise Server.

Press Enter.

8. Enter the Unix user and group names to use when running the default instance of Enterprise Server.

For Express installation, this user must be root. The group must be the group to which root belongs.

9. Enter the Unix user name to use when running the Enterprise Administration Server.

In most cases, this user is root.

10. Enter the Enterprise 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 set up in the Netscape environment.

11. After the installation program extracts and installs the Enterprise Server components, press Enter.
12. Go to the https-adminserv directory under your server root directory and start Enterprise Administration Server by typing ./start. You can also type ./startconsole in the server root directory.
13. To configure your Enterprise Server, use the Enterprise Administration URL: http://server_name:administration_port

For example: http://mozilla:8888

Enter your administration user name and password.

• You must install your Netscape version 4.0 servers in a separate server root directory from the server root that contains your 3.x servers.
• If you have beta versions of Netscape 4.0 servers installed, uninstall them before installing the final version.
• Because of DLL conflicts, if you install Enterprise Server 4.0 and Enterprise Server 3.6 on the same machine, Netscape recommends that you uninstall Enterprise Server 3.6 after you migrate it.
• Do not install Enterprise Server on an NFS-mounted drive due to potential security and file locking restrictions on remote partitions.

Installing from a CD-ROM

1. Put the CD-ROM in the drive. Click the icon representing your CD-ROM drive.
2. Double-click the ntx86 folder.
3. Double-click the entprise folder.

The setup.exe file is inside this folder.

1. Download the file e40diu.exe (U.S. domestic) or e40eiu.exe (export) and save it in a temporary directory.
2. Unzip the file to extract the files.

The setup.exe file is inside this folder.

1. Double-click the setup.exe 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.

Table 2.2 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 Enterprise Server

Click Next.

5. The Choose Installation Directory 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. Click Next.

If you want to install Enterprise Server in a non-default location, use Browse to navigate to the folder you want.

If you have other Netscape 4.x servers installed, and you want to register Enterprise Server with Netscape Console, install all 4.x servers into the same directory.

Warning.

You cannot install Enterprise Server on the same machine as Directory Server.

6. The Select Products dialog box appears. Select Enterprise Server from the list. Note that because the administration server is now an Enterprise Server instance, it is installed automatically when you install Enterprise Server, and is not a choice on this product list.

By default, the installer installs a default set of components. If you want to change the components you install, click Change and continue to Step 7.

If you did not change components, continue to Step 8.

7. The Select Sub-Components dialog box appears. You can select a component 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 components you did not check, you can run the installer again and choose to install only the missing components. However, you cannot uninstall separate components once they are installed.

By default, all components except WAI are installed.

Netscape Enterprise Server Core. Install this component to install Enterprise Administration Server and the first instance of Enterprise Server.

Warning.

You must install the Netscape Enterprise Server Core component the first time you install Enterprise Server. If you install additional components later, you are not required to reinstall the Core component.

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 component or use a JDK already installed on your system. If you want to use your own JDK, enter Yes. For more information, see "Installing a Java Developer's Kit."

Java and Servlets. Install this component if you are planning to use Java servlets.

You need a JRE or JDK to use Enterprise Server's Java support. If you do not have one installed on your system, you should install the JRE provided with Enterprise Server (see the previous component) or install a JDK.

Server Side JavaScript Database Connectors. Install this component if you are planning to use server-side JavaScript database connectivity (LiveWire). If you plan to use this feature, you also need to install Java and Servlets (see the previous component) as well. You also need to install the JRE or supply a JDK.

Web Publishing. Install this component if you are planning to use the Web Publishing, Netshare, or search features.

WAI. Install this component if you are planning to run Web Application Interface programs. If you are using WAI, you must also have an ORB. You will have to provide the installation program with the path to the ORB on your system later in the installation process.

SNMP. Install this component if you are planning to use SNMP.

8. The Enterprise Administration Server Authentication dialog box appears. Type the user name for Enterprise 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 14.

9. The Enterprise Administration Server Port Selection dialog box appears. Type the port number the Enterprise 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 Enterprise Server 3.6 is installed on your system, do not use the same Enterprise Administration Server port number for Enterprise Server 4.0 as you used for Enterprise Server 3.6.

Click Next.

10. The Default HTTP Server dialog box appears. A default instance of Enterprise Server is installed automatically.

Type a port number for the default instance of your Enterprise Server. This port should be different than the Enterprise 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.mozilla.com and you choose port 9753, your server's URL will be
http://www.mozilla.com:9753/

Type the path for the default server's primary document directory, where the server's content files will be stored. The default is C:\Netscape\Server4\docs. Click Browse to navigate your file system.

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://mozilla.com:389/o=airius.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 Java and Servlets, the JRE Selection dialog box appears.If you are using Java on your Enterprise Server, you must have a Java Runtime Environment (JRE) or a Java Development Kit (JDK). You can use the JRE included with Enterprise 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 path to the folder where you installed the JDK on your system.

13. If you are installing WAI, the ORB Selection dialog box appears. Enter the path to the directory where your Object Request Broker (ORB) is installed. To get the Visibroker 3.3 ORB, contact Inprise at http://www.inprise.com.
14. The Configuration Summary dialog box appears. This dialog box contains information about the settings for your Netscape Enterprise Server and Enterprise Administration Server. It also contains a list of the Enterprise 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 Next.

The server files are installed. The Setup Complete dialog box appears. You must reboot your computer to complete the installation before you can use the server.

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 Enterprise Server exists, use it to uninstall the portion of Enterprise Server you installed. If the uninstaller does not exist, manually delete all the files that in the server root.
15. Click Finish.
16. To configure your Enterprise Server, use the Enterprise Administration URL: http://server_name:administration_port

For example: http://mozilla:8888

Enter your administration user name and password to administer the server.

To remove your Netscape Enterprise Server:

1. Go to your server root and type ./uninstall.

A list of Netscape servers currently installed in this location appears.

2. Find Netscape Enterprise Server in the list and type the number next to it at the prompt.

Note that uninstalling Enterprise Server automatically uninstalls the administration server, since it is an instance of Enterprise Server.

A list of installed Enterprise Server components appears.

3. Select all components and press Return.

The components are uninstalled and you return to the command prompt.

To remove your Netscape Enterprise Server:

1. Go to your server root and double-click on the program unist.exe.
2. The Netscape Uninstall window appears. This window lists all the Netscape Servers installed in this directory. Click the checkbox next to Netscape Enterprise Server and click Uninstall. Note that uninstalling Enterprise Server automatically uninstalls the administration server, since it is an instance of Enterprise 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 config 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.

5. A dialog box appears informing you that you need to restart your system in order to remove the files marked for deletion. Click Yes to reboot immediately. You must reboot before reinstalling Enterprise Server.