SCO OpenServer Handbook
Chapter 26, Configuring Internet services

Web

Web

When you click on the Web button, the Internet Manager displays a list of Web servers you have installed.

Clicking on a server enables you to configure it using the Netscape administration utility for that server. This utility prompts you for a user name and password, which are initially set to be the same as that for the Internet Manager (the user name is always admin and the password is initially set to the first eight characters of the root password set during the initial system load).


NOTE: If you change the password for the Internet Manager, the passwords for the Netscape administration utilities are not changed. To change the passwords for the Netscape administration utilities, you must change them from within those utilities.

The Netscape administration utilities enable you to change many attributes of your servers' behavior. Some attributes, however, should not be changed, or the Internet Manager might not work properly. Specifically, these attributes are:

See also:



Netscape Web server installation defaults

The installation of the SCO OpenServer Netscape Web servers uses the following default values. You can alter these values once you complete the installation.


Server name
The string returned by hostname.
Do not change unless you change the system name (or are configuring multiple servers).

Server IP address
The first (non-loopback) returned by netstat -in, or 127.0.0.1 if TCP/IP is not configured.
Do not change unless you change the system's IP address.

Server port
Netscape FastTrack Server listens on port 80, is administered on port 620.

Netscape Proxy Server listens on port 8080, is administered on port 446.

Server home


Netscape FastTrack Server:
/usr/internet/ns_httpd

Netscape Proxy Server:
/usr/internet/ns_proxy

Server document root


Netscape FastTrack Server:
/usr/internet/ns_httpd/docs

Server processes
Number of server processes:
 Minimum        2
 Maximum   32 (25 for Netscape Proxy Server)

Home page


Netscape FastTrack Server:
/usr/internet/ns_httpd/docs/index.html

Index files
index.html or home.html recorded in the server's root (rather than syslog).

administration username
Set to admin.

administration password
Set to the root user's password at installation of server product.

The Netscape Proxy Server is set to the following additional defaults: 



Starting and restarting Netscape servers

Once installed, the Netscape FastTrack and Netscape Proxy Servers start automatically on reboot.


NOTE: If you have configured a secure server, starting the server requires a password, and therefore must be done manually.

If you have configured virtual domains, see ``Configuring interfaces''.


To stop and restart the Netscape servers, use the following commands as root:

Netscape FastTrack Server


/usr/internet/ns_httpd/httpd-80/stop and
/usr/internet/ns_httpd/httpd-80/start

If a secure server is configured:

/usr/internet/ns_https/https-443/stop and
/usr/internet/ns_https/https-443/start

Netscape Proxy Server


/usr/internet/ns_proxy/proxy-8080/stop and
/usr/internet/ns_proxy/proxy-8080/start

For more information, see the Netscape FastTrack Server documentation (but note that the server files are installed in /usr/internet/ns-httpd on SCO OpenServer). 

Deferring or reconfiguring network configuration

During SCO OpenServer installation, Netscape servers are configured with settings for Server Name, Hosts, and Addresses by default. If you defer TCP/IP configuration during initial system installation or you reconfigure TCP/IP, any Netscape servers installed on your system might be improperly configured.

To configure your Netscape server after deferring or reconfiguring networking configuration, edit the following files:

Netscape FastTrack Server:

Netscape Proxy Server:
In /usr/internet/ns_proxy/proxy-8080/config/magnus.conf set ``ServerName'' to the string returned by hostname. Then copy this file to /usr/internet/ns_proxy/admserv/proxy-8080/magnus.conf. The timestamp on the former file must be the same or earlier than that on the latter.



Manually configuring Netscape servers




NOTE: Configuring new servers directly with the FastTrack Administration Server might cause them not to be seen by the Internet Manager.

To configure Netscape servers manually without using the Internet Manager:

  1. Start the appropriate administration server by entering one of these commands as root:

    Netscape FastTrack Server
    /usr/internet/ns_httpd/start-admin

    Netscape Proxy Server
    /usr/internet/ns_proxy/start-admin

  2. Access the administration server by opening one of these URLs, on the server being configured, with any forms-capable Web browser:

    Netscape FastTrack Server
    http://localhost:620/

    Netscape Proxy Server
    http://localhost:446/

  3. Log into the administration server as user admin.

    At installation, the admin password was set to the first eight characters of the root password.

  4. Select the server to administer.

  5. When you are finished, stop the administration server by entering:

    Netscape FastTrack Server
    /usr/internet/ns_httpd/stop-admin

    Netscape Proxy Server
    /usr/internet/ns_proxy/stop-admin


Improving Internet server performance

You can improve the performance of your Netscape FastTrack Internet server by increasing the values of:

These variables are tuned with the Hardware/Kernel Manager or the configure(ADM) command; see the Performance Guide for more information.

NSTRPAGES is particularly important if failures are reported by the netstat -m command. Increasing NSTRPAGES until the failures no longer occur is usually appropriate; see ``Tuning STREAMS usage'' in the ``Tuning networking resources'' chapter of the Performance Guide. Remember that increasing NSTRPAGES also affects memory usage.

If you are running a multi-processor system, it might also be helpful to increase the value of the str_pool_size variable by editing the /etc/conf/pack.d/str/space.c file. Make a back-up copy of this file before making any changes. You must relink the kernel before modifications to space.c files take effect. Tuning this variable does not appreciably affect performance on single-processor systems.


NOTE: Determining specific values for these parameters depends on your system hardware, configuration, and usage. We recommend that you experiment with these values according to the suggestions in the Performance Guide.