Chapter 2   Installing iPlanet Web Proxy Server


This chapter tells you how to install your iPlanet Web Proxy Server. It also explains how to migrate from a previous version of the proxy server and to install multiple proxy servers.

Installing iPlanet Web Proxy Server

---

After you've installed the required software, you can install iPlanet Web Proxy Server. You can install a new proxy, replace an existing proxy server, or install more than one proxy.

---

Note	While it is possible to install your proxy server on the same machine as another iPlanet server, it is not recommended that you do so. Running two or more iPlanet servers on the same machine will cause a significant impact on the servers' performance.

---

If you're already running a proxy server, you must install the new proxy server to a different port. For example, if you are replacing a proxy that listens to port 8080, you might first install the new proxy server on port 8081, assuming that port is available. After the new proxy server is properly configured, shut down the old proxy server and then change the new proxy to use port 8080.

To install iPlanet Web Proxy Server,

1. Put the CD-ROM in the drive.

2. Choose Run from the Start Menu.

3. In the dialog box that appears, type the path to the setup.exe file.

4. Press Enter.

   The iPlanet Web Proxy Server Installation dialog box appears.

5. Click Yes to continue. This unpacks all the files and runs the Installation Wizard, which takes you through the installation process. During this process you need to specify the following items:

   
   

   ---

   Note	If you already have a SuiteSpot 3.x server installed on your machine, the installation wizard will not prompt you for the destination directory, directory service, administrator's username and password, or administration server port.

   ---

   
   
   • Destination Directory—This is the directory into which the proxy server will be installed. You can either choose the default directory, C:\Netscape\SuiteSpot, or browse for another directory.

   • Directory Service—This is the service you will use to store user and group information. You can use either an LDAP-based service, such as iPlanet Directory Server, or you can use the local directory service. If you choose an LDAP-based service, you need to enter the directory server's name, its port, and its Base Distinguished Name. (The Base Distinguished Name is the directory under which all relevant user and group information is stored. It has the form o=organization, c=country. For instance, o=iPlanet, c=US.)

   • Administrator's Username and Password—These are the username and password you will need to access the administration server.

   • Administration Server Port—This is the port address that the administration server will use.

   • Cache Partition Root—This is the location of your proxy server's cache. You can choose either the default directory, D:\Netscape\SuiteSpot\Proxy, or browse for another directory.

   • Proxy Server Port—This is the port address that the proxy server will use. The standard proxy port is 8080.

Migrating from a Previous Version of the Proxy Server

---

This section tells you how to migrate from an earlier version of iPlanet Web Proxy Server. The migration process supports migration from Netscape Proxy Server 2.5 and 3.5 releases to iPlanet Web Proxy Server 3.6.

To migrate from an earlier version of the proxy server,

1. Shut down your server.

2. Follow the directions in "Installing iPlanet Web Proxy Server" to install the new 3.6 server into a separate directory.

3. Start the administration server.

4. On the Server Administration page, click the "Migrate from previous version" button.

5. Type the absolute path to the directory where the older version of the server is installed.

6. Click the Find Servers button.

7. Select the checkbox next to the server for which you want to import the configuration.

8. Click OK.

   The installation program transfers the configuration information from the old server to the new one. This process can take a few minutes depending on the complexity of your configuration.

After this process, you will have two working servers (the old server will be turned off).

---

Caution

If you are migrating a Netscape Proxy Server 3.5 to iPlanet Web Proxy Server 3.6, refer to the release notes for important information on the migration process.

---

Installing Multiple Proxy Servers

---

Once you have one proxy server running on your computer, you can install another proxy server without going through the installation program.

Each proxy server you have installed can run on any TCP/IP port on your system, but you cannot run two servers on the same port at the same time. Your proxy server software license allows you to have as many proxy servers as you want on one computer. With multiple servers on your computer, you will see several subdirectories in your server root directory; each of these servers can be managed from the Server Administration page.

To install another proxy server,

1. On the Server Administration page, click the "Create New iPlanet Web Proxy Server 3.6" link. The iPlanet Web Proxy Server Installation form appears.

2. Enter values for the following:
   • Server name—Type the fully qualified domain name for your server. If you are installing a second server for a different domain, enter the domain here.

   • Server port—Type the port number to which you want this server to listen.

   • Server identifier—Type the server identification the administration server will use for your server. This is the name that appears in the Server Selector and becomes part of the name for the main directory for this new server. All server instances on the same machine must have a unique server identifier.

   • DNS behavior—Select whether you want the proxy server always to resolve host names, to resolve them for access control, or never to resolve them.

   • Log format—Select whether you want to use common, extended, or extended-2 log format. For more information on these formats, see the Administrator's Guide.

   • Proxied protocols—Select which protocols (HTTP, FTP, Gopher) your proxy will service.

   • SSL tunneled protocols—Select which secure protocols (HTTPS, NNTP) your proxy server will tunnel.

   • Caching behavior—Specify whether caching is enabled for your proxy server. If you do enable caching, specify the directory where cached files will be stored. For more information on caching, see the Administrator's Guide.

   • Cache size—Select the size of your cache. For more information on cache size, see the Administrator's Guide.

   • Cache sections—Select the number of sections that will be in your cache. Fore more information on cache sections, see the Administrator's Guide.

   • Cache directories per section—Select the number of subdirectories that will be within each section in your cache. For more information on cache directories, see the Administrator's Guide.

   • HTTP caching behavior—Select whether you want your proxy server to cache HTTP documents. If so, specify the refresh and expiration policies. For more information on caching HTTP, see the Administrator's Guide.

   • FTP caching behavior—Select whether you want your proxy server to cache FTP documents. If so, specify the FTP refresh policy. For more information on caching FTP, see the Administrator's Guide.

   • Gopher caching behavior—Select whether you want your proxy server to cache Gopher documents. If so, specify the Gopher refresh policy. For more information on caching Gopher, see the Administrator's Guide.

3. Click OK.