Sun Java System Web Proxy Server 4.0.2 2005Q4 Administration Guide

Restarting the Proxy Server

This section describes the various methods to restart the Proxy Server on different platforms.

Restarting the Server (UNIX or Linux)

You can restart the server using one of the following methods:

Because the installation scripts cannot edit the /etc/rc.local or /etc/inittab files, you must edit those files with a text editor. If you do not know how to edit these files, consult your system administrator or system documentation.

ProcedureTo restart the Proxy Server from the command line

Steps
  1. Log in as root if the server runs on ports with numbers lower than 1024; otherwise, log in as root or with the servers user account.

  2. At the command-line prompt, type the following line and press Enter:

    server_root/proxy-serverid/restart

    where server_root is the directory where you installed the server.

    • You can use the optional parameter -i at the end of the line. The -i option runs the server in inittab mode, so that if the server process is ever killed or crashed, inittab will restart the server for you. This option also prevents the server from putting itself in a background process.

To restart the server using inittab

Add the following text on one line in the /etc/inittab file:

prxy:23:respawn:server_root/proxy-serverid/start -start -i

where server_root is the directory where you installed the server, and proxy-serverid is the server’s directory.

The -i option prevents the server from putting itself in a background process.

You must remove this line before you stop the server.

To restart the server using System RC Scripts

If you use /etc/rc.local, or your system’s equivalent, place the following line in /etc/rc.local:

server_root/proxy-serverid/start

Replace server_root with the directory where you installed the server.

Restarting the Server (Windows)

You can restart the server by

ProcedureTo restart the server on Windows

Steps
  1. Use Control Panel > Administrative Tools > Services >

  2. Select Sun Java System Web Proxy Server 4.0 (proxy-serverid) from the list of services.

  3. Change the Startup type to Automatic in the Properties window to have your system start the server each time the computer starts or reboots.

  4. Click OK.

Setting the Termination Timeout

When the server is off, it stops accepting new connections. Then it waits for all outstanding connections to complete. The time the server waits before timing out is configurable in the magnus.conf file. By default it is set to 30 seconds. To change the value, add the following line to magnus.conf file:

TerminateTimeout seconds

where seconds represents the number of seconds the server will wait before timing out.

The advantages to configuring this value is that the server will wait longer for connections to complete. However, because servers often have connections open from nonresponsive clients, increasing the termination timeout may increase the time it takes for the server to shut down.