/tcltk-aolserver

AOLserver Demo for Tcl/Tk 2008 Conference

Primary LanguageTcl

AOLserver Build for Tcl/Tk 2008 Conference
------------------------------------------
Copyright 2008 by Scott S. Goodwin

This distribution contains the sources and build scripts to compile and install
AOLserver and supporting software and modules on most Unix type systems (sorry,
no Windows here)..

All files and software reside in the directory you are currently in, so no
worry about files being installed all over your system. Still, you should *not*
be root when working here and am not liable for any problems you have with this
kit.

Four step process:

Create the sources.sh file in the top level directory and put in the versions
of the packages you want to build. Make sure those sources are located in
build/srcs as <NAME>-<VERSION>.tar.bz2 files. The sources.sh file is as follows:

SOURCES="
	tcl-8.5.18
	aolserver-8.5.18
"

If you don't create the sources.sh file, the build/build.sh file will create
one with specific versions of a few packages, and you can modify that file at
any time and re-run the build process. 

This is the build process:

./build/build.sh
./db start <sitename>
./db create <sitename>
./web start <sitename>

The sitename is optional -- if not specified, it will use the 'default' server
configuration that exists within this project. If you do specify a sitename,
there must be a directory of that name at the top level of this distribution
(where the default server config is) or one level up, as a sibling to this
distribution's top level directory.

If BUILD_DEBUG="yes" in config.sh then all of the build output will be captured
in logs/build.log file; set to anything else and build.sh doesn't bother
capturing the action.

If NS_DEBUG="yes" in config.sh then 'web start' will start nsd in the
foreground; anything else will cause it to start as a normal daemon.

Then connect to the IP address with your browser on ports 8000 (http) and 8001
(https). If you're on a Mac, 127.0.0.1 will be the server's address; otherwise
it should be the main interface's IP.

All of the binaries get installed under the 'exe' subdirectory. You can remove
the 'exe','logs' and 'var' directories and start over at any time.

Note that you'll likely see some compile or install errors for static libraries
for nsopenssl etc.




Ubuntu Requirements:
--------------------
libreadline5
libreadline5-dev
zlib1g
openssl
libssl-dev




Mac OS X 
--------

PostgreSQL won't normally start on a stock Leopard installation because the
shared memory requirements are bigger than the default OS X settings. To get it
working, run the following two commands as root:

# sysctl -w kern.sysv.shmall=65536
# sysctl -w kern.sysv.shmmax=16777216

(You can run this by sourcing config/pgshm.sh as root.)

Add the following lines to /etc/sysctl.conf (create it if it doesn't exist) if
you want these settings to take effect at boot time:

kern.sysv.shmall=65536
kern.sysv.shmmax=16777216