[Inso Home Page] [Home] [Collection] [Book] [Expand] [Collapse] [Search Forms] [Previous Section with Hits] [Next Section with Hits] [Clear Search] [Preferences] [Print] [Help]

 inside  Expand Search


   Introduction to The DynaWeb Internet Server   [Table of Contents]    Setting Authentication on the DynaWeb Internet Server

DynaWeb Publishers Guide

[-] Appendix B: The DynaWeb Internet Server
[-] Controlling the Server

Controlling the Server

UNIX Platforms

The DynaWeb Internet Server is controlled by a set of commands located in the {platform}/bin directory of the server installation. {platform} stands for the current platform DynaWeb is running on.

There are three commands that are used to control the state of the server. The commands are: start, stop, and restart.

To be certain that you are running the scripts located in {platform}/bin, change directories to the {platform}/bin directory and use the syntax "./{command}" when running any of the server commands.

Start

The start command creates two or more processes, the server-controller process and a process specific to each port where the server will be listening for requests. The process ids (pids) for the processes created are recorded in a log called the pid.log.

Stop

The stop command sends a kill request to the server-controller, causing the server-controller and any port-specific processes to end. The pid log must be present in order for the stop command to take effect.

If for some reason the pid log is missing or erased, you must manually find the processes labeled dwhttpd and send a kill -3 <pid> command to them. This will stop the server and remove the processes.

Restart

The restart command causes the server-controller to restart all of the protocol modules it is currently running. This causes any changes to the nsapi.cfg file or any plugin-related configuration files to be recognized. For changes to the dwhttpd.cfg file to be recognized, the server controller must be stopped, either with the stop command or with a kill -3 command, and then started again.

Windows 95

When the server is installed on Windows 95, a Program Group is created named DynaWeb. There are two icons in this group: an UnInstall option and a program called the DynaWeb Internet Server Controller.

The Server Controller brings up a small dialog box with three buttons, Start, Stop, and Restart. The Controller pings the port specified by the dwhttpd.cfg file and, depending on the current state of the server, dims some of the buttons on the Controller. When the server is running, the title bar of the window also displays the word "(running)".

Start

The Start button starts the server running on the port specified by the dwhttpd.cfg. Once the server is running, the button dims and cannot be selected again until the server has stopped.

Stop

The Stop button kills the server. If the server is not running, this button is dimmed.

Restart

When the Restart button is selected, the Controller kills the server and immediately starts it again. If the server is not running, this button is dimmed.

Windows NT

The DynaWeb Internet Server runs as a service under Windows NT. This allows the server to start automatically on boot, without requiring a particular user to be logged in. As a service, the server is started and stopped through the Services Control Panel applet.

In order to serve books that exist on networked drives, any servers running as services that are configured to run the DynaWeb plug-in must be set to 'log on as' a user that has access to the networked drives. This is because the services can start without anybody logged into the system. To configure a service to 'log on as' a particular user:

  1. In the Services Control Panel, select the service that you want to change, e.g. the DynaWeb Internet Server, the Netscape FastTrack server, or the Netscape Enterprise server.
  2. Click the Startup button.
  3. Select the "This Account" radio button, and enter an account name (user name) that has access to the network drives that contain the books. Also, be sure to enter and confirm the password for that user.
  4. Click the OK button, then stop and start the service to complete the changes.

    Note that collections in your collects.dwc file may require fully qualified path names for networked drives rather than mapped drive letters in order for the DynaWeb plug-in to access them over your network.

    The install program creates a Program Group called 'DynaWeb' by default. In this group is a single file: an Uninstall option.


       Introduction to The DynaWeb Internet Server   [Table of Contents]    Setting Authentication on the DynaWeb Internet Server