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 mijuarez.juarez.gob.mx /etc/tclhttpd/virtuals/mijuarez.rc dnsbl.juarez.gob.mx /etc/tclhttpd/virtuals/dnsbl.rc www.juarez.gob.mx /etc/tclhttpd/virtuals/www.rc api.juarez.gob.mx /etc/tclhttpd/virtuals/api.rc css.juarez.gob.mx /etc/tclhttpd/virtuals/css.rc img.juarez.gob.mx /etc/tclhttpd/virtuals/img.rc js.juarez.gob.mx /etc/tclhttpd/virtuals/js.rc wstransito.juarez.gob.mx /etc/tclhttpd/virtuals/wstransito.rc Virtual host config list

-config /etc/tclhttpd/tclhttpd.rc Configuration File

-main /usr/lib/tclhttpd3.5.1/httpdthread.tcl Per-Thread Tcl script

-docRoot /usr/htdocs Root directory for documents

-port 80 Port number server is to listen on

-host server4.mpio Server name, should be fully qualified

-ipaddr 10.236.0.149 Interface server should bind to

-https_port 443 SSL Port number

-https_host server4.mpio SSL Server name, should be fully qualified

-https_ipaddr 10.236.0.149 Interface SSL server should bind to

-webmaster webmaster@juarez.gob.mx E-mail address for errors

-uid tclhttpd User Id that server runs under

-gid tclhttpd 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 /usr/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 localhost Mail Servers for sending email from tclhttpd

-daemon 0 Run in the background as a daemon process. Requires either the 'Tclx' or 'Expect' package.

option	default	description
-virtual	mijuarez.juarez.gob.mx /etc/tclhttpd/virtuals/mijuarez.rc dnsbl.juarez.gob.mx /etc/tclhttpd/virtuals/dnsbl.rc www.juarez.gob.mx /etc/tclhttpd/virtuals/www.rc api.juarez.gob.mx /etc/tclhttpd/virtuals/api.rc css.juarez.gob.mx /etc/tclhttpd/virtuals/css.rc img.juarez.gob.mx /etc/tclhttpd/virtuals/img.rc js.juarez.gob.mx /etc/tclhttpd/virtuals/js.rc wstransito.juarez.gob.mx /etc/tclhttpd/virtuals/wstransito.rc	Virtual host config list
-config	/etc/tclhttpd/tclhttpd.rc	Configuration File
-main	/usr/lib/tclhttpd3.5.1/httpdthread.tcl	Per-Thread Tcl script
-docRoot	/usr/htdocs	Root directory for documents
-port	80	Port number server is to listen on
-host	server4.mpio	Server name, should be fully qualified
-ipaddr	10.236.0.149	Interface server should bind to
-https_port	443	SSL Port number
-https_host	server4.mpio	SSL Server name, should be fully qualified
-https_ipaddr	10.236.0.149	Interface SSL server should bind to
-webmaster	webmaster@juarez.gob.mx	E-mail address for errors
-uid	tclhttpd	User Id that server runs under
-gid	tclhttpd	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	/usr/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	localhost	Mail Servers for sending email from tclhttpd
-daemon	0	Run in the background as a daemon process. Requires either the 'Tclx' or 'Expect' package.

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