| Prev | Chapter�2.�Installation Overview | Next |
|---|
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 | 5.2 | |
|---|---|---|---|---|---|---|---|---|---|---|
| AOLserver | 3 | Yes | No | |||||||
| 3.3+ad13 | Maybe | Yes | No | |||||||
| 3.3oacs1 | Maybe | Yes | No | |||||||
| 3.4.2 | No | |||||||||
| 3.4.2oacs1 | Maybe | Yes | No | |||||||
| 3.5.5 | Maybe | Yes | No | |||||||
| 4.0 | Maybe | Yes | ||||||||
| PostgreSQL | 7.0 | Yes | No | |||||||
| 7.2 | Maybe | Yes | No | |||||||
| 7.3.2 - 7.3.x | No | Yes | ||||||||
| 7.4 | No | Yes | ||||||||
| 8.0 | No | Maybe | Yes | |||||||
| 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. +
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 | 5.2 | |
|---|---|---|---|---|---|---|---|---|---|---|
| AOLserver | 3 | Yes | No | |||||||
| 3.3+ad13 | Maybe | Yes | No | |||||||
| 3.3oacs1 | Maybe | Yes | No | |||||||
| 3.4.2 | No | |||||||||
| 3.4.2oacs1 | Maybe | Yes | No | |||||||
| 3.5.5 | Maybe | Yes | No | |||||||
| 4.0 | Maybe | Yes | ||||||||
| PostgreSQL | 7.0 | Yes | No | |||||||
| 7.2 | Maybe | Yes | No | |||||||
| 7.3.2 - 7.3.x | No | Yes | ||||||||
| 7.4 | No | Yes | ||||||||
| 8.0 | No | Maybe | Yes | |||||||
| Oracle | 8.1.6 | Maybe | Yes | |||||||
| 8.1.7 | Maybe | Yes | ||||||||
| 9i | No | Yes | ||||||||
| 10g | � | No | Maybe | |||||||
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.2.0d1.�The OpenACS tarball comprises the core packages and +
OpenACS 5.2.0b1.�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. Some scripts require bash shell.
Operating System.�OpenACS is designed for a Unix-like system. It is @@ -18,8 +18,8 @@ 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, 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
+ 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 @@ -29,19 +29,19 @@ operating system distribution.
GNU Make 3.76.1 or newer, REQUIRED.�PostgreSQL and AOLserver require gmake to
compile. Note that on most linux
distributions, GNU Make is simply named
- make and
+ make and
there is no
- gmake,
+ gmake,
whereas on BSD distributions,
- make and
- gmake are
+ make and
+ gmake are
different --use gmake.
TCL 8.4.x.�
TCL 8.4.x, 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.4.x development headers and libraries, OPTIONAL.� The site-wide-search service, OpenFTS, requires these to - compile. (Debian users: apt-get install - tcl8.4-dev). You need this - to install OpenFTS.
tDOM, REQUIRED.�OpenACS 5.2.0d1 stores
+ compile. (Debian users: apt-get install
+ tcl8.4-dev). You need this
+ to install OpenFTS.
tDOM, REQUIRED.�OpenACS 5.2.0b1 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.)
tclwebtest, OPTIONAL.�tclwebtest is a tool for testing web interfaces via tcl scripts.
Web Server.�The web server handles incoming HTTP requests, provides @@ -50,7 +50,7 @@ errors. OpenACS uses AOLserver; some people have had success running Apache with mod_nsd.
AOLserver 4.x, REQUIRED.�Provides the base HTTP server
Mat Kovach is graciously maintaining an AOLserver distribution that - includes all the patches and modules needed to run OpenACS 5.2.0d1. These + includes all the patches and modules needed to run OpenACS 5.2.0b1. 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. @@ -67,14 +67,14 @@ (i.e. postgres.so)
- The patch that makes exec work
+ The patch that makes exec work
on BSD is available at sourceforge.net
- The patch for aolserver 3.x 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 3.x respect the
- -g flag is available at
+ -g flag is available at
sourceforge.net
nsopenssl, OPTIONAL.�Provides SSL capabilities for AOLserver. It requires OpenSSL. You need this if you want users to make