AOLserver Administration Technical Overview

$Header: /cvsroot/aolserver/aolserver.com/docs/admin/tech.html,v 1.2 2002/09/26 19:51:32 kriston Exp $

AOLserver Command Line

bin/nsd [ -i | -f ] [-s servername] [ -d ] [ -k | -K ] [ -V ] [ -r root ] {-c | -t} config

Description: Start up AOLserver

Option:

Description:

-i

Run AOLserver from /etc/inittab. This option is similar to -f except that stdout goes to the server.log file.

-f

Run AOLserver in the foreground.

-s servername

Specify the server to run, if the configuration file defines multiple servers. The Server1 server will be run by default.

-d

Run AOLserver in the debugger (ignore SIGINT).

-k

Kill the running AOLserver (based on pidfile) and continue.

-K

Kill the running AOLserver (based on pidfile) and terminate.

-V

Print the version number of AOLserver.

-r root

Perform chroot to a new root directory.

{-c|-t} config

Required. Specify -c if the configuration file is in the .ini format from previous AOLserver versions or -t if the configuration file is in .tcl format. Specify the path to the configuration file.

SGI Irix 6.2 Platform:

Execute nsdp instead of nsd to use the Posix Threads interface for SGI Irix 6.2. All command line options remain the same.

Examples

Command Line:

Description: nsd -t nsd.tcl

This is the simplest form of the command line. nsd -ft nsd.tcl

AOLserver will be run in the foreground. nsd -fkt nsd.tcl -r /newroot

AOLserver will be run in a chroot environment, and any currently-running server will be killed.

Directory Map

This table describes all of the directories that are created under the AOLserver installation directory when you install AOLserver. It lists the files or types of files that are stored in each directory, the configuration parameters that affect the directory or the files in the directory, and references to where you can find more information on the associated AOLserver features.

Directory

Description

/bin

Directory containing the AOLserver binary and the default directory for any dynamically-loadable C modules.

Files:

.so files nsd translate-ini

/examples

Directory containg C and Tcl examples, each in a separate subdirectory.

/include

Directory containing header files for AOLserver.

Files:

.h files

/lib

Directory containing static libraries used for building customized components to AOLserver. This directory currently only includes the libnspd.a file that can be used to build database proxy daemons (external database drivers).

Files:

libnspd.a

See Appendix B of the AOLserver C Developer's Guide for information on building external database drivers.

/log

Directory containing log files and the server pid file.

Files:

server.log nspid.port

/modules

Contains directories for each configured module that operates across servers, such as the tcl module.

See page 62 for information on configuring AOLserver modules.

/modules/nscp

Directory containing files related to control port interface.

Files:

tcsh.inputrc

/modules/tcl

Default directory for shared Tcl script library. Also contains subdirectories containing Tcl examples and Tcl scripts for various modules.

Files:

.tcl files

/modules/tcl/nsperm

Directory containing user, group, and permissions files, plus Tcl scripts for the nsperm module, which is used to provide access control for AOLserver.

Files:

passwd file group file hosts.allow file hosts.deny file perms file .tcl files

/modules/nsunix

Contains socket file for the nsunix module.

/servers

Contains directories for each server.

/servers/servername

Contains server-specific directories, including modules and pages.

/servers/servername/modules

Contains directories for server-specific modules, including nsftp, nslog, nsperm, nsservlet, and tcl.

/servers/servername/modules/nslog

Default directory where the server's access log is stored.

Files:

access.log

/servers/servername/modules/nsperm

Default directory where access control files are stored. The access control features are enabled by the nsperm module.

Files:

.dat files passwd group hosts.allow hosts.deny perms

/servers/servername/modules/tcl

Default directory for private Tcl script library for this server.

Files:

.tcl files

/servers/servername/pages

Default directory where pages and graphics for the server are stored. Users can optionally have individual subdirectories of this directory (see UserDir, below).

Files:

typically, .htm, .html, .shtml, and .adp files