- 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. -
Table�2.2.�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 | |
|---|---|---|---|---|---|---|---|---|---|
| AOLserver | 3 | Yes | No | ||||||
| 3.3+ad13 | Maybe | Yes | |||||||
| 3.3oacs1 | Maybe | Yes | |||||||
| 3.4.2 | No | ||||||||
| 3.4.2oacs1 | Maybe | Yes | Maybe | ||||||
| 3.5.5 | Maybe | Yes | No | ||||||
| 4.0 | Maybe | Yes | |||||||
| PostgreSQL | 7.0 | Yes | No | ||||||
| 7.2 | � | Yes | No | ||||||
| 7.3.2 - 7.3.x | No | Yes | |||||||
| 7.4 | No | Maybe | |||||||
| Oracle | 8.1.6 | Maybe | Yes | ||||||
| 8.1.7 | Maybe | Yes | |||||||
| 9i | No | Yes | |||||||
OpenACS 5.1.2.�The OpenACS tarball comprises the core packages and + 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. +
Table�2.2.�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 | |
|---|---|---|---|---|---|---|---|---|---|
| AOLserver | 3 | Yes | No | ||||||
| 3.3+ad13 | Maybe | Yes | |||||||
| 3.3oacs1 | Maybe | Yes | |||||||
| 3.4.2 | No | ||||||||
| 3.4.2oacs1 | Maybe | Yes | Maybe | ||||||
| 3.5.5 | Maybe | Yes | No | ||||||
| 4.0 | Maybe | Yes | |||||||
| PostgreSQL | 7.0 | Yes | No | ||||||
| 7.2 | � | Yes | No | ||||||
| 7.3.2 - 7.3.x | No | Yes | |||||||
| 7.4 | No | Maybe | |||||||
| Oracle | 8.1.6 | Maybe | Yes | ||||||
| 8.1.7 | Maybe | Yes | |||||||
| 9i | No | Yes | |||||||
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. +
OpenACS 5.1.3.�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.
Operating System.�OpenACS is designed for a Unix-like system. It is + and Oracle. Some scripts require bash shell.
Operating System.�OpenACS is designed for a Unix-like system. It is developed primarily in Linux. It can be run on Mac OS X, - and in Windows within VMWare.
Linux.�The installation assumes a linux kernel of 2.2.22 or newer, or 2.4.14 or newer.
FreeBSD.�FreeBSD - guide. The Reference Platform uses bash, which is the + and in Windows within VMWare.
Linux.�The installation assumes a linux kernel of 2.2.22 or newer, or 2.4.14 or newer.
FreeBSD.�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.
Mac OS X.�the section called “OpenACS Installation Guide for Mac OS X”
Windows/VMWare.�the section called “OpenACS Installation Guide for Windows2000” The only + appropriate, and install bash to work with the scripts. Substitute fetch when the instructions suggest you use + wget to download software.
Mac OS X.�the section called “OpenACS Installation Guide for Mac OS X”
Windows/VMWare.�the section called “OpenACS Installation Guide for Windows2000” The only way to run OpenACS on Windows is through the VMWare emulator. (Please let me know if you have OpenACS running directly in Windows.)
Build Environment.�The Reference Platform installation compiles most programs from @@ -32,13 +35,13 @@ whereas on BSD distributions, make and gmake are - different.
TCL 8.3.�
TCL 8.3, 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.
TCL 8.3 development headers and libraries, OPTIONAL.� The site-wide-search service, OpenFTS, requires these to + different --use gmake.
TCL 8.3.�
TCL 8.3, REQUIRED.�OpenACS is written in TCL, an interpreted + 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.
TCL 8.3 development headers and libraries, OPTIONAL.� The site-wide-search service, OpenFTS, requires these to compile. (Debian users: apt-get install tcl8.3-dev). You need this - to install OpenFTS.
tDOM, REQUIRED.�OpenACS 5.1.2 stores + to install OpenFTS.
tDOM, REQUIRED.�OpenACS 5.1.3 stores queries in XML files, so we use an AOLserver module called tDOM to parse these files. (This replaces libxml2, which was used prior to 4.6.4.) tDOM is available from http://www.tdom.org).
tclwebtest, OPTIONAL.�tclwebtest 0.3 is a tool for testing web interfaces @@ -49,7 +52,7 @@ running Apache with mod_nsd - see this post.
AOLserver 3.3oacs1, REQUIRED.�Mat Kovach's source distribution of AOLserver, including all of the patches listed below.
Mat Kovach is graciously maintaining an AOLserver distribution that - includes all the patches and modules needed to run OpenACS 5.1.2. These + includes all the patches and modules needed to run OpenACS 5.1.3. 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. @@ -69,16 +72,18 @@ The patch that makes exec work on BSD is available at sourceforge.net
- The patch that makes ns_uuencode + The patch for aolserver 3.x that makes ns_uuencode work for binary files is available at sourceforge.net
- The patch that makes AOLserver respect the + The patch that makes AOLserver 3.x respect the -g flag is available at sourceforge.net -
nsopenssl 2.1a, OPTIONAL.�Provides SSL capabilities for AOLserver. It requires +
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. (home - page)
ns_pam + secure (https) connections to your webserver. + aolserver3.x requires nsopenssl 2.1a. aolserver4.x requires nsopenssl3; see + aolserver.com for latest release. (home page) +
ns_pam 0.1, OPTIONAL.�Provides PAM capabilities for AOLserver. You need this if you want OpenACS users to authenticate through a PAM module (such as RADIUS). (home @@ -91,7 +96,7 @@ DNS values, and produces a report. You need this if you want to see how much traffic your site is getting.
Balance 3.11, OPTIONAL.�"Balance is a simple but powerful generic tcp proxy with round robin load balancing and failover mechanisms." You need this or something equivalent if you are running a high-availability production site and do not have an external load balancing system.
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