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.