ACS Documentation :
ACS Installation Guide :
Requirements
There are three chief requirements for successfully installing and using
the ArsDigita Community System:
- Adequate hardware
- Necessary software
- Experience with an Unix environment.
Hardware Requirements
At a minimum, you need a hardware platform that allows you to run
the Oracle RDBMS comfortably.
You can do this on a wide variety of hardware platforms. At ArsDigita, we
are most familiar with running production servers using the ArsDigita Community System on Sun and HP hardware. However, the software can also be run comfortably on Linux and even Windows 2000.
The emphasis of this document is currently on a Linux installation. Installing
this software on other Unix systems, such as Solaris, is much the same. If
you are not installing onto Linux, you can still follow this documentation,
but you will need to substitute commands native to your Unix system if the
Red Hat Linux version does not work. For example, there is a standard tool
for creating new users under Solaris and Red Hat, useradd. If
your system does not support this, you will need to substitute the appropriate
command.
Installing the ArsDigita Community System under Windows 2000 is a
different matter that this document does not address. Please see the
Windows 2000 installation guide for instructions.
Minimum Hardware Requirements for Installing onto Linux
- An IBM-PC compatible with a Pentium processor or better.
- 128 Mb RAM (256 Mb recommended) with 400 Mb swap file
- 3.5 Gb Hard Drive space
- A network connection. Have your network configuration information
(such as IP address) handy when following this guide.
Software Requirements
The ArsDigita Community System requires:
- A Unix operating system (e.g. Solaris, Linux, HP-UX) or Windows 2000
- The Oracle8i RDBMS
- The Open Source AOLServer 3.0 Web Server running with the 8.3 Tcl interpreter (
nsd8x)
There are also initiatives to create versions of ACS that work with
other databases (see the OpenACS project) and
with other web servers (see the mod_aolserver package for Apache). However, this guide presumes a Unix
operating system, specifically Red Hat Linux, Oracle 8.1.6, and AOLServer 3.0.
This information may be useful for other platforms, but please exercise
careful judgment in following any of the instructions.
Experience with an Unix Environment
Running a reliable database-backed web server requires experience with the
server's environment, in this case Unix. Unix is
not always an intuitive environment and this guide cannot hope to explain
every nuance. You should be comfortable
with the following tasks before attempting an installation:
- Adding users, groups, setting passwords.
- Starting an X server and running an X program remotely.
- Basic file management using
cp, rm, mv, and cd.
- Compiling a program using a Makefile.
If you've never done these things before, consider exploring Unix at greater
depth before installing the ArsDigita Community System. Some useful
resources for doing this taken from Philip Greenspun's bookshelf are listed below.
An excellent introduction to the command line tools and basic programs
of Unix is Unix
Power Tools. An excellent online resource is The Unix Reference Desk
. However, you need to read further to get a firm grasp on
System Administration.
For System Administration:
For Solaris:
For HP-UX:
For Linux:
Above basic system administration, you need a good text editor. While
vi is functional, Emacs offers more features and is arguably
more extensive than any other text editor available today. These two books are excellent.
bquinn@arsdigita.com