Lesson 1: Server Setup

	Lesson 1: Server Setup

Out of Box Startup

This page describes how to set up the server for a standard "web page server" and as a platform for web applications. You have probably started the server using this simple command:

tclsh8.6 bin/httpd.tcl -debug 1

This runs the server using a standard selection of features and displaying the documents stored under htdocs in the distribution. If you want an alternate document root, use the -docRoot directory command line option.

tclsh8.6 bin/httpd.tcl -docRoot directory

When you specify the -debug flag, you get additional information printed as different modules are loaded. You also get a Tcl command prompt that lets you poke around in the main Tcl interpreter used by TclHttpd.

Here are the command line options understood by this server:

option default description

-virtual Virtual host config list

-config STANDARD.rc Configuration File

-main /opt/htbase/KITBASE/SERVER/STANDARD.kit/bin/httpdthread.tcl Per-Thread Tcl script

-docRoot /opt/htbase/KITBASE/SERVER/STANDARD.kit/bin/../htdocs Root directory for documents

-port 80 Port number server is to listen on

-host standard.prd.co.uk Server name, should be fully qualified

-ipaddr standard.prd.co.uk Interface server should bind to

-https_port 443 SSL Port number

-https_host standard.prd.co.uk SSL Server name, should be fully qualified

-https_ipaddr standard.prd.co.uk Interface SSL server should bind to

-webmaster webmaster@prd.co.uk E-mail address for errors

-uid 50 User Id that server runs under

-gid 50 Group Id for caching templates

-secs 60 Seconds per "minute" for time-based histograms

-threads 4 Number of worker threads (zero for non-threaded)

-library /opt/htbase/KITBASE/SERVER/STANDARD.kit/bin/../custom Directory list where custom packages and auto loads are

-debug 0 If true, start interactive command loop

-compat 3.3 version compatibility to maintain

-gui 1 flag for launching the user interface

-mail viking.prd.co.uk Mail Servers for sending email from tclhttpd

option	default	description
-virtual		Virtual host config list
-config	STANDARD.rc	Configuration File
-main	/opt/htbase/KITBASE/SERVER/STANDARD.kit/bin/httpdthread.tcl	Per-Thread Tcl script
-docRoot	/opt/htbase/KITBASE/SERVER/STANDARD.kit/bin/../htdocs	Root directory for documents
-port	80	Port number server is to listen on
-host	standard.prd.co.uk	Server name, should be fully qualified
-ipaddr	standard.prd.co.uk	Interface server should bind to
-https_port	443	SSL Port number
-https_host	standard.prd.co.uk	SSL Server name, should be fully qualified
-https_ipaddr	standard.prd.co.uk	Interface SSL server should bind to
-webmaster	webmaster@prd.co.uk	E-mail address for errors
-uid	50	User Id that server runs under
-gid	50	Group Id for caching templates
-secs	60	Seconds per "minute" for time-based histograms
-threads	4	Number of worker threads (zero for non-threaded)
-library	/opt/htbase/KITBASE/SERVER/STANDARD.kit/bin/../custom	Directory list where custom packages and auto loads are
-debug	0	If true, start interactive command loop
-compat	3.3	version compatibility to maintain
-gui	1	flag for launching the user interface
-mail	viking.prd.co.uk	Mail Servers for sending email from tclhttpd

Adding Code

The server automatically sources the code in its custom code directory, which is specified by the -library command line argument. This feature allows you to "drop in" additional Tcl code without modifying the server. Your code can turn the basic server into a complete application.

The sampleapp directory of the distribution contains several examples contributed by TclHttpd users.

Home Status Learn CGI Tests Templates Access Control Reference Manual


Home	Status	Learn	CGI Tests	Templates	Access Control	Reference Manual