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.5 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.5 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 /home/obs-utl/999A-UTLS/WebServices/tclhttpd3.5.1/bin/tclhttpd.rc Configuration File

-main /home/obs-utl/999A-UTLS/WebServices/tclhttpd3.5.1/bin/httpdthread.tcl Per-Thread Tcl script

-docRoot /home/obs-utl/999A-UTLS/WebServices/tclhttpd3.5.1/bin/../htdocs Root directory for documents

-port 8015 Port number server is to listen on

-host superbean Server name, should be fully qualified

-ipaddr Interface server should bind to

-https_port 8016 SSL Port number

-https_host superbean SSL Server name, should be fully qualified

-https_ipaddr Interface SSL server should bind to

-webmaster dl@obs-now.com 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 0 Number of worker threads (zero for non-threaded)

-library /home/obs-utl/999A-UTLS/WebServices/tclhttpd3.5.1/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 Mail Servers for sending email from tclhttpd

option	default	description
-virtual		Virtual host config list
-config	/home/obs-utl/999A-UTLS/WebServices/tclhttpd3.5.1/bin/tclhttpd.rc	Configuration File
-main	/home/obs-utl/999A-UTLS/WebServices/tclhttpd3.5.1/bin/httpdthread.tcl	Per-Thread Tcl script
-docRoot	/home/obs-utl/999A-UTLS/WebServices/tclhttpd3.5.1/bin/../htdocs	Root directory for documents
-port	8015	Port number server is to listen on
-host	superbean	Server name, should be fully qualified
-ipaddr		Interface server should bind to
-https_port	8016	SSL Port number
-https_host	superbean	SSL Server name, should be fully qualified
-https_ipaddr		Interface SSL server should bind to
-webmaster	dl@obs-now.com	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	0	Number of worker threads (zero for non-threaded)
-library	/home/obs-utl/999A-UTLS/WebServices/tclhttpd3.5.1/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		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