NeoWebScript Tcl scripting module for the Apache webserver at SourceForge

Home
Download
User Info
	New User FAQ
	Tutorials
	Demos
	Commands
	Variables
	Troubleshooting
	Code Examples
Sysop Info
	Sysop FAQ
	Theory
	Installation
	Management
	Tests
	Troubleshooting
FAQ
Feedback
Useful Links
Release Notes
Credits
Disclaimer

NeoWebScript™ Installation

These are instructions for installing NeoWebScript™, an extension of the fabulously popular Apache webserver. This is release 3.3, and is delivered along with Apache 1.3.12.

After you have unpacked this release, execute the following commands:

./configure ?options? If you run ./configure without options, you will be asked where
you want to install your Apache/NeoWebScript server. The
recommended location will already be selected.
You can choose the recommended location by pressing return. Options:

--prefix=[PREFIX]	 Where you want to install NeoWebScript.
			 Default is /usr/local/apache.

--with-tk=[yes|no]	 Build TK alongside Tcl and install it.
			 Default is no.

--enable-shared=[yes|no] Build Tcl as shared objects.
			 Default is yes.

--enable-gcc=[yes|no]	 Use gcc to build the installation.
			 Default is yes.

--link-statically	 Link mod_neoscript statically into Apache
			 instead of as a DSO (dynamic shared object).
			 Default is no.

--enable-module=[MODULE] Turn on other NeoWebScript modules and build
			 them with the server.
			 No modules are enabled by default.

	MODULES:
		auth_tcl	Tcl Authorization through .htaccess files
		log_neo		NeoWebScript logging module.
		neo_userdir	Modification of mod_userdir.

make
make install

If you are not installing this release as root, you will need to su to root or contact your administrator and chown the neowebscript/neoscript-data/ directory to the user you are going to run the webserver as. IE:

chown -R nobody /usr/local/apache/neowebscript/neoscript-data

If you run into any problems or errors during this install, please e-mail
info@neowebscript.com with as much detailed information as you can provide.

Once this is done, the server will be installed and ready to go with a few
configuration changes. The following directories are installed with your
server with the following purposes:

/usr/local/apache
        Server root.
/usr/local/apache/bin
	Location of the server binaries to start/restart/stop the server.
/usr/local/apache/cgi-bin
	The directory where cgi-bin files, if any, are stored.
/usr/local/apache/conf
	The main directory where all of Apache's configuration files are stored.
/usr/local/apache/htdocs
	The location of your document tree.  This is where all your html files
	should go.
/usr/local/apache/html
	The location of some Tcl documentation in html format.
/usr/local/apache/icons
	The default directory where icons for the server are stored.
/usr/local/apache/include
	A directory of include files for compiling new source.
/usr/local/apache/lib
	The directory where Tcl stores its necesary libraries.
/usr/local/apache/libexec
	Apache's directory for storing libraries.
/usr/local/apache/licenses
	Files containing the licenses for packages installed by NeoWebScript.
/usr/local/apache/logs
	The main directory where logs for the server are stored.
/usr/local/apache/man
	The directory where Tcl stores its manual pages.
/usr/local/apache/neowebscript
	The location of all the NeoWebScript Tcl source files.

Once the install has completed, you should be able to start your server by calling: /usr/local/apache/bin/apachectl start If the server doesn't start, see the Troubleshooting section of this documentation.

Adding NeoWebScript™ to your existing Apache server

This release should pretty much drop into an existing Apache 1.3.12 tree with relatively minor effort. You will need the following components installed on your server:

Apache
Tcl
TclX

Download the module version of the NeoWebScript server from the download area and unpack it. Once it's unpacked, the configure script, when run, will ask you where you have these packages installed. Once you've answered the questions, the NWS module will configure itself to be installed wherever your Apache server is installed. Then, just type:

make
make install

If you encounter any problems with this install that you cannot figure out from the documentation provided, please contact us at info@neowebscript.com and describe the problem in as much detail as possible. We try our best to make sure that the server will install on most all systems and under as many conditions as possible.

Thank you!