Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/software.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/software.xml,v diff -u -r1.19 -r1.20 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/software.xml 27 Oct 2004 21:29:55 -0000 1.19 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/software.xml 13 Jan 2005 13:55:17 -0000 1.20 @@ -1,51 +1,50 @@ - %myvars; -]> - - - Prerequisite Software +<<]> + + Prerequisite Software - by Joel Aufrecht - - - - OpenACS requires, at a minimum, an operating system, database, - and webserver. Many additional programs, such as a Mail - Transport Agent and source control system, are also needed for - a fully effective instance. + by Joel Aufrecht + + + + OpenACS requires, at a minimum, an operating system, database, + and webserver to work. Many additional programs, such as a build environment, Mail + Transport Agent, and source control system, are also needed for + a fully effective installation. - - - Version Compatibility Matrix - - - - - - - - - - - - + +
+ Version Compatibility Matrix + + + + + + + + + + + + + + OpenACS Version + 3.2.5 + 4.5 + 4.6 + 4.6.1 + 4.6.2 + 4.6.3 + 5.0 + 5.1 + + + - OpenACS Version - 3.2.5 - 4.5 - 4.6 - 4.6.1 - 4.6.2 - 4.6.3 - 5.0 - 5.1 - - - - AOLserver 3 Yes @@ -122,14 +121,17 @@
- + The OpenACS installation instructions assume the operating system and build environment are installed. + The instructions explain installation of TCL, tDOM, tclwebtest, a Web Server, a Database, a Process Controller, and + Source Control software. The following external links are for reference only. + <ulink url="http://openacs.org/projects/openacs/download/">OpenACS &version;</ulink> The OpenACS tarball comprises the core packages and many useful additional packages. This includes a full set of documentation. The tarball works with both PostgreSQL - and Oracle. + and Oracle. Some scripts require bash shell. @@ -151,12 +153,12 @@ FreeBSD - FreeBSD - guide. The Reference Platform uses bash, which is the + FreeBSD guide. The OpenACS Reference Platform uses shell scripts written for bash, which is the standard Linux shell. If you are using a different shell, you will need to substitute your shell's conventions for setting environment variables when - appropriate. + appropriate, and install bash to work with the scripts. Substitute fetch when the instructions suggest you use + wget to download software. @@ -204,7 +206,7 @@ whereas on BSD distributions, make and gmake are - different. + different --use gmake. @@ -219,9 +221,9 @@ <ulink url="http://www.tcl.tk/">TCL</ulink> 8.4.x, REQUIRED OpenACS is written in TCL, an interpreted - language. The TCL interpreter must be installed for - OpenACS to function. TCL is included in most standard - distributions. + language. A threaded version of the TCL interpreter must be installed for + OpenACS to work. The TCL interpreter that is included in most standard + distributions may not be thread safe. @@ -272,19 +274,68 @@ - - - <ulink url="http://prdownloads.sourceforge.net/aolserver/nspostgres-4.0.tar.gz?download">nspostgres 4.x</ulink>, REQUIRED - Provides PostgreSQL capabilities for AOLserver. - + + Mat Kovach is graciously maintaining an AOLserver distribution that + includes all the patches and modules needed to run OpenACS &version;. These + instructions will describe how to install using his source + distribution. He also has binaries for SuSE 7.3 and OpenBSD 2.8 (and + perhaps more to come), currently located at uptime.openacs.org. + + + + It's also possible to download all the pieces and patches yourself: + + + + + AOLserver is available at aolserver.com + + + + The OpenACS PostgreSQL driver (nspostgres.so) is available from + SourceForge. If + you do decide to use nspostgres.so, you have to remember to + change the AOLserver config file to point to nspostgres.so + instead of postgres.so. This guide uses Mat Kovach's distro + (i.e. postgres.so) + + + + + The patch that makes exec work + on BSD is available at sourceforge.net + + + + The patch for aolserver 3.x that makes ns_uuencode + work for binary files is available at sourceforge.net + + + + The patch that makes AOLserver 3.x respect the + -g flag is available at + sourceforge.net + + + - <ulink url="http://www.scottg.net/webtools/aolserver/modules/nsopenssl/">nsopenssl</ulink> 3.0beta22 or newer, OPTIONAL + nsopenssl, OPTIONAL Provides SSL capabilities for AOLserver. It requires OpenSSL. You need this if you want users to make - secure (https) connections to your webserver. + secure (https) connections to your webserver. + aolserver3.x requires nsopenssl 2.1a. aolserver4.x requires nsopenssl3; see + aolserver.com for latest release. (home page) + @@ -354,7 +405,7 @@ Database The data on your site (for example, user names and passwords, calender entries, and notes) is stored in the database. - OpenACS seperates the database with an abstraction layer, + OpenACS separates the database with an abstraction layer, which means that several different databases all function identically. While you can run the core OpenACS on any supported database, not all contributed packages support all @@ -462,8 +513,4 @@ ($Id: software.xml,v 1.8 2003/10/29 09:01:09 joela Exp $) - - - - - +