Chapter 2 Administering Sun Java System Web Proxy Server

This chapter introduces the basics of administering Sun Java System 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

• From the command line, go to server_root/proxy-admserv and type ./start to start the Administration Server (or ./restart to restart the Administration Server).

To start the Administration Server on Windows

• Use Start > Programs > Sun Microsystems > Sun Java System Web Proxy Server version > Start Admin

  -or-

  Use Control Panel > Administrative Tools > Services > Sun Java System Web Proxy Server 4.0 > Start

  -or-

• 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, it can be accessed by launching a browser and entering 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

• Access the Administration Server, click the Preferences tab, click the Shutdown Server link, and then click OK.

  -or-

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

To stop the Administration Server on Windows

• Use the Sun Java System Proxy Server 4.0 Administration Server service in the Services window: Control Panel > Administrative Tools > Services

  -or-

• 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

Steps

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 displays, and is used 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

Steps

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. To proceed with removal, select the Confirming Server Removal checkbox and click OK.

Migrating from Proxy Server 3.6

Sun^TM One Web Proxy Server 3.6 (also known as iPlanet^TM Web Proxy Server) can be migrated to Sun Java System 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 the Proxy Server 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 in this guide.