Chapter 2 Administering Proxy Server

This chapter introduces the basics of administering iPlanet Web Proxy Server using the Administration Server. The Administration Server is a web-based user interface used to manage, add, remove, and migrate servers.

This chapter contains the following sections:

• Starting the Administration Server

• Stopping the Administration Server

• Running Multiple Proxy Servers

• Removing a Server Instance

• Migrating From Proxy Server 3.6

For details about configuring Administration Server preferences, see Chapter 3, Setting Administration Preferences. For details about administering multiple Proxy Servers using server clusters, see Chapter 6, Managing Server Clusters.

Starting the Administration Server

This section describes how to start the Administration Server on different platforms. For information about stopping the Administration Server, see Stopping the Administration Server.

To Start the Administration Server on UNIX or Linux

1. From the command line, go to server-root/proxy-admserv and

2. Type ./start to start the Administration Server (or ./restart to restart the Administration Server).

To Start the Administration Server on Windows

You can start the Administration Server on Windows in any of the following ways:

• On the Start menu, select Programs ⇒ Oracle Corporation ⇒ Oracle iPlanet Proxy Server4 ⇒ Start Admin

• Use Control Panel ⇒ Administrative Tools ⇒ Services ⇒ Oracle iPlanet Proxy Server4 Administration Server ⇒ Start

• From a command prompt, go to server-root\proxy-admserv and type startsvr.bat to start the Administration Server (or ./restart to restart the Administration Server).

After the Administration Server has been started, you can access it by launching a browser and provding a URL that reflects the host name and port number specified for the Administration Server during installation, for example, http://myserver.mycorp.com:1234. You will be prompted for a user name and password, both of which were also specified during installation.

More than one administrator can be granted access to the Administration Server. For more information about distributed administration, see Allowing Multiple Administrators.

Stopping the Administration Server

This section describes how to stop the Administration Server on different platforms. For information about starting the Administration Server, see Starting the Administration Server.

To Stop the Administration Server on UNIX or Linux

You can stop the Administration Server on UNIX or Linux in either of the following ways:

• Using the administration interface:

  1. Access the Administration Server.

  2. Select the Preferences tab.

  3. Click the Shutdown Server link.

  4. Click OK.

• From the command line, go to server-root/proxy-admserv/ and type ./stop.

To Stop the Administration Server on Windows

You can stop the Administration Server on Windows in either of the following ways:

• Use the iPlanet Web Proxy Server 4.0 Administration Server service in the Services window: Control Panel->Administrative Tools->Services->iPlanet Web Proxy Server 4.0 Administration Server> Stop

• From the command prompt, go to server-root\proxy-admserv and type stopsvr.bat.

Running Multiple Proxy Servers

To run multiple Proxy Servers on your system multiple server instances must be installed and configured. The following procedure describes how to add server instances.

To Install multiple server instances

1. Access the Administration Server.

2. On the Servers tab, click Add Server.

3. Provide the requested information and click OK.

   For more information about specific fields, see the online Help.

4. If desired, click the Configure Your New Server link on the Success page that displays after successfully adding a new server instance.

   The Server Manager interface appears. You can use it to configure server instances.

Removing a Server Instance

The Administration Server can be used to remove Proxy Server instances. This process cannot be undone, so be sure you want to remove the server instance before performing the following procedure.

To Remove a Server Instance

1. Access the Administration Server.

2. On the Servers tab, click Remove Server.

3. From the drop-down list, select the server instance you want to remove.

4. Select the Confirming Server Removal checkbox and click OK.

Migrating From Proxy Server 3.6

Sun ONE Web Proxy Server 3.6 (also known as Sun iPlanet Web Proxy Server) can be migrated to iPlanet Web Proxy Server 4. The 3.6 server is preserved, and a new version 4 server with the same settings is created. For more information about migrating a server from version 3.6 to version 4, see Oracle iPlanet Web Proxy Server 4.0.14 Installation and Migration Guide. Also see the online help for migration-related pages in the Proxy Server user interface. For information about migrating certificates, see Migrating Certificates From Previous Versions in this guide.