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:

• Restarting the servers manually.

• Automatically restart the server from the inittab file

  If you are using a version of UNIX or Linux not derived from System V (such as SunOS^TM 4.1.3), you will not be able to use the inittab file.

• Automatically restart the server with daemons in /etc/rc2.d when the system reboots.

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.

To Restart the Proxy Server From the Command Line

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 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 using the Services Control Panel or by completing the following task.

To Restart the Server on Windows

1. Use Control Panel > Administrative Tools > Services >

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

3. Change the Startup type to Automatic in the Properties window. Your system will 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 the server waits for all outstanding connections to complete. The time the server waits before timing out is configurable in the magnus.conf file. By default, this value 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 might increase the time necessary for the server to shut down.