$Header: /cvsroot/aolserver/aolserver.com/docs/admin/tech.html,v 1.1 2002/03/07 19:15:34 kriston Exp $
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.
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