Toadhttpd

Artifact Content
Login

Artifact 9cb52e9c50de2f09f33b694f336c953c79188aaa184ec85d97427e63ffe8f2b0:

Wiki page [Deploying] by hypnotoad 2018-05-03 20:50:58.
D 2018-05-03T20:50:58.102
L Deploying
P 68797befed5d2f931a24d13193857ca8edf88d72de5bc2b841194645bee50976
U hypnotoad
W 2717
Deploying | [Configuration] | [Customizing]
<h1>Deploying Toadhttpd</h1>

Toadhttpd distributes with a tcl based build tool that can perform local installations or shrink wrap all of the critical pieces into a self-contained executable. Toadhttpd prefers to maintain its own copies of modules, rather than rely on packages managed by teapot or the local operating system. This means that two independent copies of toadhttpd can be resident on the same server at the same time.
<p>
These instructions will become more elaborate as we move out of the design phase and into the <i>this is production software!</i> phase.
<p>
For now the instructions to set up toadhttpd are to unpack the fossil repository into a folder. (Not the folder you are going to install to!). And then use the make.tcl script to have toadhttpd assemble everything it will need.
<p>
Toadhttpd depends on the following external projects:

<h2>tcllib</h2>
Official: <a href="https://core.tcl-lang.org/tcllib">https://core.tcl-lang.org/tcllib</a><br>
Mirror: <a href="/fossil/tcllib">http://fossil.etoyoc.com/fossil/tcllib</a>
<p>
Tcl Standard Library. NOTE: You will need to check out the <i>hypnotoad</i> branch. It has the most up-to-date implementation of the httpd module.

<h2>Taolib</h2>
Official: <a href="/fossil/taolib">http://fossil.etoyoc.com/fossil/taolib</a>
<p>
The Tcl Architecture of objects. Basically, a big reusable framework for TclOO code.

<h2>Toadhttpd</h2>
Official: <a href="/fossil/toadhttpd">http://fossil.etoyoc.com/fossil/toadhttpd</a>
<p>
This project
<hr>

When I got to set things up, here are the steps:

<verbatim>
mkdir -p ~/tcl/download
fossil clone http://fossil.etoyoc.com/fossil/tcllib ~/tcl/download/tcllib.fossil
fossil clone http://fossil.etoyoc.com/fossil/taolib ~/tcl/download/taolib.fossil
fossil clone http://fossil.etoyoc.com/fossil/toadhttpd ~/tcl/download/toadhttpd.fossil
mkdir -p ~/tcl/sandbox/tcllib
cd ~/tcl/sandbox/tcllib
fossil open ~/tcl/download/tcllib.fossil hypnotoad
mkdir -p ~/tcl/sandbox/taolib
cd ~/tcl/sandbox/taolib
fossil open ~/tcl/download/taolib.fossil trunk
mkdir -p ~/tcl/sandbox/toadhttpd
cd ~/tcl/sandbox/toadhttpd
fossil open ~/tcl/download/toadhttpd.fossil trunk

tclsh make.tcl install ~/www/mynewsite
</verbatim >

This will install all of the code needed to run toadhttpd in the directory <b>~/www/mysite</b>. Change that to whatever suits for your needs.

To run toadhttpd:

<verbatim>
cd ~/www/mysite
tclsh httpd.tcl
</verbatim>

The stock server will serve up content from the <b>htdocs</b> directory inside of wherever toadhttpd was installed.

For more on customizing your installation see [Configuration].
Z f6ee0f5c0c48da13259945b28d943cc3