| Prev | Chapter 2. Installing on Unix/Linux | Next |
|---|
We won't provide detailed instructions to install an operating system since there are so many valid choices available and each OS has their own installation procedures.
Members of the OpenACS community use a variety of UNIX, Linux, BSD and even Windows systems. The remainder of this guide will be specific to Linux. Users of other OS's may find some helpful information here, but we recommend that you instead use one of these OS specific guides to install OpenACS 4.5.
This guide is currently valid for Mac OS 10.04, but it's being updated for OS 10.1 as we speak. In the meantime, eager 10.1 users can see this bboard thread for some help.
OpenACS Installation Guide for Windows 2000
This was written for ACS and has not yet been updated for OpenACS. (Note: AOLServer is no longer supporting Windows - it may be possible to run AOLServer under Cygwin, but I haven't seen any success reports yet). Another alternative is to use John Sequeira's Oasis VM, which is basically a fully working OpenACS 4.5 system that you load into VMware.
I'm currently using Debian GNU/Linux, so this guide may show that bias. Installation on any Linux distribution should be similar and we'll try to point out differences where they exist.
When you do install your system, be sure to set up enough swap space - at least 400 MB for Oracle, less for PostgreSQL. A rule of thumb is to set aside a swap partition which is twice your RAM size.
Some things that you will need:
| Requirement | Reason |
|---|---|
| recent kernel | Currently version 2.2.19 or greater is the standard requirement. Some people are using 2.4.x (2.4.16) kernels. |
| bash | Bash is the standard Linux shell. We assume you are using bash for these instructions. If you're not using bash, then you will need to substitute your shell's conventions for setting environment variables when appropriate. |
| glibc 2.1 (or greater) | You need recent versions of these libraries for Oracle to work properly. If you want Unicode support, you'll need glibc 2.2. |
| perl (and perl-suid) | A few parts of the ACS require perl to work correctly. (Debian users: apt-get install perl-suid) |
| GNU Make (3.76.1 or better) | PostgreSQL and AOLServer require gmake to compile. Note that on some linux distributions, GNU Make is simply named make and there is no gmake, whereas on BSD distributions, make and gmake are different. |
| Tcl 8.3 development package (headers, libraries) | The site-wide-search service, OpenFTS, requires these to compile. (Debian users: apt-get install tcl8.3-dev) |
| libxml2 | OpenACS 4.5 stores queries in XML files, so libxml2 is used to parse these files. (Debian users: apt-get install libxml2-dev) |
Locations:
We'll compile stuff in /usr/local/src
PostgreSQL will go into /usr/local/pgsql
AOLServer will go into /usr/local/aolserver
The web root will go into /web
None of these locations are set in stone - they're simply the values that we've chosen. You are free to install your software in other locations, but you'll need to adjust the instructions in this document to point to those locations.
Here's a list of some helpful documentation for various OS's
Painless Debian GNU/Linux by Stephen van Egmond
Once you get your OS installed, it's imperative that you secure your installation. As Jon Griffin repeatedly warns us, "No distribution is secure out of the box." Again, this topic is too big to cover properly here, so see these links.