Configuring and managing your server

his chapter describes how to configure and manage your Netscape web server. During installation, you specified a port number for the administration server, which allows you to manage your Netscape web server from a single interface--the Server Selector. The administration server must be running before you can configure a specific server using the Server Manager.

This chapter contains sections on using the Server Selector and Server Manager.

Using the Server Selector

The Server Selector is the interface that lets you select a server to configure. Using the Server Selector, you can manage one web server, multiple web servers, or multiple Netscape servers (such as the News, Proxy, and Mail servers) that are installed on different ports on one machine, and multiple servers that answer to different domains.

You can perform the following tasks from the Server Selector:

Accessing the Server Selector

If you stopped the administration server after installation, you must start the administration server before you can configure your server. Go to the server root directory and type ./start-admin. This starts the administration server using the port number you specified during installation.

To access the Server Selector,

  1. Using a browser that supports frames and JavaScript, such as Netscape Navigator 2.0, enter the URL for the administration server:
              http://[servername].[your_domain].[domain]:[port_number]/
    
    For example, http://atomic.acmecorp.com:1357

    Use the port number for the administration server that you specified during installation; this is not the port number for the web server.

  2. You'll be prompted for a username and password. Type the administration server username and password you specified during the installation. The Server Selector appears, as shown in Figure 3.1.
The Server Selector lets you manage multiple servers.

The Server Selector lists all the servers you've installed on this system. Click the name of the server you want to configure.

Shutting down the administration server

To minimize security risks, you should shut down the administration server when you are finished using it unless you are using the Server Manager to rotate your log files with the timing utility. In this case, leave your administration server running. You can shut down the administration server by doing one of the following:

Installing multiple web servers

You can install another web server on your current machine without going through the installation program. Your new web server can share its configuration with an existing web server on your system, or it can use its own separate configuration files.

Each web server you have installed can run on any TCP/IP port on your system, but you cannot run two web servers on the same port at the same time. If your system is configured to listen to more than one IP address, two or more web servers can share the same port as long as they use different IP addresses. (You should contact your system's vendor for information on how to configure your system to respond to different IP addresses.) Your web server software license allows you to have as many web server inst ances as you want on one system. If your system is not listening to multiple IP addresses, you don't need to enter an IP address for each server. If your system is configured to listen to multiple IP addresses, enter one of the IP addresses your system is hosting for each server you're installing. You must have a separate server process running for each of your IP addresses. You now have several subdirectories in your ns-home directory; each of these servers can be managed from the Server Selector.

To set up a new web server on your system and have it share its configuration with an existing web server on your system, see "Setting up software virtual servers" in Chapter 4. When web servers share the same configuration files, they will either all be unsecure or secure. (For more information about security and servers, see Chapter 7.) They will also all use the same port number, so sharing con figuration files is only useful if you are setting up web servers to handle several domains on your system.

To set up multiple servers that respond to different IP addresses, install separate instances of the server into the same directory by clicking Install a new Netscape Enterprise Server from the Server Selector.

If you installed your server before configuring your system to host multiple IP addresses, configure your system to respond to different IP addresses, change the server's bind address using the Server Manager (see "Configuring network settings" in Chapter 5), and install separate instances of the server for each IP address.

To install another web server with its own separate configuration files,

  1. Click Install another server to this machine from the Server Selector.
  2. Enter values for the following:
  3. Click OK.

Removing a server from your system

You can remove a server from your system using the Server Selector. Be sure that you will not need the server anymore.

To remove a server from your machine,

  1. Shut down the server before removing it by clicking the on/off icon to the left of the server name in the Server Selector.
  2. Click on the Remove a server from the list button from the Server Selector.
  3. Select the server you want to remove.
  4. Select whether you want to remove the administration binaries, which includes the server's configuration files and the server's binaries.
    Caution!
    Do not remove the administration binaries if there is more than one server installed on your system.

  5. Verify that you want to remove the server and the administration binaries.
  6. Click OK.

Configuring your administration server

You can use the Server Selector to configure these administration server items:

Starting and stopping a web server

You can start and stop any of servers listed in the Server Selector by clicking the On icon located left of the server's name. If the server is on, you'll see a green light under the icon. Click on the icon to turn the server off. To turn the server back on, click on the icon again.

Using the Server Manager

After you install the server, the server should run smoothly. However, you'll need to perform periodic maintenance, such as changing the server's name and port number, or adding, changing, and removing users in user database files).

The Server Manager is the collection of forms you use to change options that control your server. From the Server Selector, which lists all the servers installed on your machine according to identifier, select the server to be configured. The Server Manager appears. (You can use the Server Manager from any remote machine as long as the system you're working on is one of the hosts that can access the administration server; you don't need to use the machine the server is installed on.)

Note
You must save and apply your changes in order for your changes to take place. After you submit a form, you get a pointer to a script that allows you to save and apply your changes.

You can return to the Server Selector by clicking Choose in the upper left corner of the Server Manager. The Server Manager is shown in Figure 3.2.

You use the Server Manager forms to configure the web server.

Use the server configuration buttons to configure the server. After clicking a button, you'll see a list of links on the left. Click one of these links; the corresponding form comes up in the main frame. Most of the Server Manager forms configure the entire server. Some forms can configure the entire server or files or directories the server maintains. These forms have the Resource Picker, shown in Figure 3.3, at the top. The Resource Picker lets you specify what resource to configure.

Resource Picker

Pick a resource from the drop-down list for configuration. Click Browse to browse your primary document directory; clicking on Options allows you to choose other directories. Click Wildcard to configure files with a specific extension.

The following forms use the Resource Picker:

Understanding wildcard patterns

In many parts of the server configuration, you specify wildcard patterns to represent one or more items to configure.

Wildcard patterns use special characters. If you want to use one of these characters without the special meaning, precede it with a backslash () character.

* matches zero or more characters.

? matches exactly one character, and it can be any character.

| is an or expression. The substrings can contain other special characters such as * or $. The substrings must be enclosed in parentheses (for example, (a|b|c)), but the parentheses cannot be nested.

$ matches the end of the string. This is useful in or expressions.

[abc] matches one occurrence of the characters a, b, or c. Within these expressions, the only character that needs to be escaped in this is ], all others are not special.

[a-z] matches one occurrence of a character between a and z.

[^az] matches any character except a or z.

*~ followed by another expression removes any pattern matching the expression.

Examples

*.netscape.com matches any string ending with the characters .netscape.com.

(quark|energy).netscape.com matches either quark.netscape.com or energy.netscape.com.

198.93.9[23].??? matches a numeric string starting with either 198.93.92 or 198.93.93 and ending with any 3 characters.

*.* matches any string with a period in it.

*~netscape-* matches any string except those starting with netscape-.

*.netscape.com~quark.netscape.com matches any host from domain netscape.com except for a single host quark.netscape.com.

*.netscape.com~(quark|energy|neutrino).netscape.com matches any host from domain netscape.com except for hosts quark.netscape.com, energy.netscape.com, and neutrino.netscape.com.

*.com~*.netscape.com matches any host from domain com except for hosts from subdomain netscape.com.