Chapter 4   Starting, Restarting, and Stopping iDAR


This chapter describes how to start, stop, and restart iPlanet Directory Access Router (iDAR) and how to check its current status.

The chapter has the following sections:

• Starting and Stopping iDAR

• Restarting iDAR

• Checking iDAR System Status

  
  

  ---

  Note

  You can use the iDAR consoles only when the appropriate Directory Server (identified as the configuration directory) and Administration Server are running. Be sure to start Administration Server at the port you specified during iDAR installation. To minimize security risks, shut down Administration Server when you have finished using the iPlanet Console. For instructions on starting and shutting down Administration Server, see iPlanet Administration Server.

  ---

  
  

Starting and Stopping iDAR

---

Once iDAR is installed, it runs constantly, listening for and accepting requests; it runs as a UNIX daemon process or a Windows NT service normally started during system boot time.

You can start and stop iDAR in several ways:

• From the iPlanet Console (locally and remotely)

• From the command line (locally only)

• On a Windows NT system, from the Windows NT Services panel

Note that stopping iDAR shuts down all its components completely, interrupting service until the server is started again. If the host machine crashes or is taken off line, the server stops, and any requests it was servicing are lost. You need to start the server again to restore the service.

Starting and Stopping iDAR From iPlanet Console

You can use the iPlanet Console to start and stop iDAR installed on a local or remote host. To start or stop iDAR:

1. Log in to the iPlanet Console (see Step 1. Log In to the iPlanet Console).

2. In the "Servers and Applications" tab, expand the hostname and then the Server Group that contains the iDAR instance you want to start.

3. In the navigation tree, locate the iDAR instance you want to start or stop, select the corresponding entry, and click Open.

   
   
   

   The iDAR Server Console opens.

4. In the Tasks tab, click Start Directory Access Router to start the server or Stop Directory Access Router to stop the server.

   
   
   

Starting and Stopping iDAR From Command Line

To start or stop iDAR from the command line:

1. Open a terminal window to your server.

2. In a UNIX system, log in as root if the server runs on ports less than 1024; otherwise, log in either as root or with the server's user account. (By default, if iDAR is run by root, it changes its user ID to nobody.)

3. At the command-line prompt, enter either of the following lines:

   To start iDAR: <server-root>/idar-<hostname>/start-idar[.exe]

   To stop iDAR: <server-root>/idar-<hostname>/stop-idar[.exe]

   <server-root> is the directory where the iDAR binaries are kept. You first specified this directory during installation.

   <hostname> is the name of the host on which this instance of iDAR is installed.

   .exe specifies the file extension; this is required only when running the utility on a Windows NT system.

   
   

   ---

   Note	If iDAR is already running, the start-up command fails. Stop the server first using the stop-idar command, then use the start-idar command.

   ---

   
   

Starting and Stopping iDAR From Windows NT Services Panel

If you have installed iDAR on a Windows NT system, you can start and stop the server (as a service) from the Windows NT Services panel (see Figure 4-1). The iDAR service has the following name: iPlanet Directory Access Router.

Figure 4-1    iDAR Service Highlighted in the Windows NT Services Panel

To start or stop iDAR from the Windows NT Services panel:

1. On your desktop, select Start > Settings > Control Panel.

2. In the Control Panel window that appears, double-click Services.

3. Scroll through the list of services, and locate the service that corresponds to the iDAR instance.

4. To start the service, select the iDAR instance, and click Start. To stop the service, select the iDAR instance, and click Stop.

Restarting iDAR

---

Whenever you change the iDAR configuration, you must save your changes for them to be stored in the configuration directory. All configuration changes require that you restart iDAR after you save the changes. If restarting is required, the console prompts you accordingly.

During restart, iDAR re-reads its configuration and uses the new configuration for future connections. Client connections that are already established continue to use the old configuration until the clients disconnect. The restart function is only available on UNIX platforms. On Windows NT, restarting iDAR is equivalent to stopping and starting iDAR.

Note that changes to certain configuration parameters require that you stop iDAR and start it again; for instructions, see Starting and Stopping iDAR. Table 4-1 lists these configuration parameters.

Table 4-1    Configuration Changes That Require iDAR Startup  

UI Elements	Attributes
The Host field in the Settings tab of the System Configuration window; see Configuring System Settings.	ids-proxy-con-listen-host
The Port field in the Settings tab of the System Configuration window; see Configuring System Settings.	ids-proxy-con-listen-port
The "SSL port" field in the Settings tab of the System Configuration window; see Configuring System Settings.	ids-proxy-con-ldaps-port
The "CA signed certificate file" field in the Encryption tab of System Configuration; see Configuring System Settings.	ids-proxy-con-ssl-cert
The "Private key file" field in the Encryption tab of System Configuration; see Configuring System Settings.	ids-proxy-con-ssl-key
The "Connection backlog" field in the Connections tab of the System Configuration window; see Configuring System Settings.	ids-proxy-con-listen-backlog

You can restart iDAR in two ways:

• From the iDAR Server Console (locally and remotely)

• From the command line (locally only)

Restarting iDAR From iPlanet Console

You can use the iDAR Server Console to restart an instance of iDAR installed on a local or remote host.

To restart iDAR from the iDAR Server Console:

1. If you're not already viewing the iDAR Server Console, log in to the iPlanet Console (see Step 1. Log In to the iPlanet Console).

2. In the "Servers and Applications" tab, expand the hostname and then the Server Group that contains the iDAR instance you want to restart.

3. In the navigation tree, locate the iDAR instance you want to start or stop, select the corresponding entry, and click Open.

   
   
   

   The iDAR Server Console opens.

4. In the Tasks tab, click Restart Directory Access Router to restart the server.

   
   
   

Restarting iDAR From Command Line

To restart iDAR from the command line:

1. Open a terminal window to your server.

2. In a UNIX system, log in either as root or using the server's user account (if that is how you started the server).

3. At the command-line prompt, enter the following line:

   <server-root>/idar-<hostname>/restart-idar[.exe]

Checking iDAR System Status

---

You can check whether a particular instance of iDAR is started or stopped in two ways:

• From the iPlanet Console (locally and remotely)

• From the command line (locally only)

Checking iDAR Status From iPlanet Console

You can use the iPlanet Console to find out whether a particular iDAR instance is running.

1. Log in to the iPlanet Console (see Step 1. Log In to the iPlanet Console).

2. In the Servers and Applications tab, select the entry that corresponds to the iDAR instance you want to check.

   
   
   

3. In the right pane, check the Server Status field.

   If the selected instance of iDAR is running, the status will be Started. Otherwise it will be Stopped or Unknown.

Checking iDAR Status From Command Line

To find out whether a particular iDAR instance is running from the command line:

1. Open a terminal window to your server.

2. In a UNIX system, log in either as root or using the server's user account (if that is how you started the server).

3. At the command-line prompt, enter the following line:

   <server-root>/idar-<hostname>/status-idar[.exe]