Index: openacs-4/packages/acs-core-docs/www/operating-system.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/Attic/operating-system.html,v diff -u -r1.8 -r1.9 --- openacs-4/packages/acs-core-docs/www/operating-system.html 10 Aug 2002 20:07:20 -0000 1.8 +++ openacs-4/packages/acs-core-docs/www/operating-system.html 28 Feb 2003 05:36:04 -0000 1.9 @@ -1,9 +1,9 @@ Install an Operating System
Prev Chapter 2. Installing on Unix/Linux Next

Install an Operating System

by Vinod Kurup
- OpenACS docs are written by the named authors, but may be edited - by OpenACS documentation staff. -

+ OpenACS docs are written by the named authors, but may be edited + by OpenACS documentation staff. +

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. @@ -12,7 +12,7 @@ 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. + OS specific guides to install OpenACS 4.6.

Linux Information

I'm currently using Debian GNU/Linux, so this guide may show that bias. Installation on any Linux distribution should be similar and @@ -43,22 +44,25 @@ to set aside a swap partition which is twice your RAM size.

Some things that you will need: -

RequirementReason
recent kernelCurrently 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. +

RequirementReason
recent kernel + + Version 2.2.22 or greater is the standard requirement. I used + version 2.4.19 for this guide. + +
bash + + Bash is the standard Linux shell and we assume you are using + bash for these instructions. If not, 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 +
GNU Make (3.76.1 or better) + PostgreSQL and AOLserver require gmake to compile. Note that + on most linux distributions, GNU Make is simply named make and there is no gmake, whereas on BSD distributions, make and @@ -68,45 +72,122 @@ 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) + + OpenACS 4.6 stores queries in XML files, so libxml2 is + used to parse these files. (Debian users: + apt-get install libxml2-dev) + +
daemontools + + If you decide to follow our recommendations, you'll need + daemontools installed. We'll explain where to get it when you + need it. + +
docbook-xml, docbook-xsl, libxslt, xsltproc + + Only needed if you plan to write or edit OpenACS + documentation. (docbook-xml v4.2, docbook-xsl v1.56, libxslt + 1.0.21, xsltproc 1.0.21) + +
a MTA (Mail Transfer Agent) + + An MTA is needed for OpenACS to send notifications or handle + incoming mail. Qmail seems to be the most popular choice in + the OpenACS community. Other options include Postfix, Exim + and Sendmail. +

Locations:

  • + We'll compile stuff in /usr/local/src +

  • - PostgreSQL will go into /usr/local/pgsql + + PostgreSQL will go into + /usr/local/pgsql +

  • - AOLServer will go into /usr/local/aolserver + + AOLServer will go into + /usr/local/aolserver +

  • - The web root will go into /web + + The web root will go into your home directory + (e.g. /home/joeuser/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. -

Linux Install Guides

- Here's a list of some helpful documentation for various OS's -

Security Information

- 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. -

($Id$)
Prev Home Next
Overview Up Install Oracle 8.1.7
rmello at fslc.usu.edu
- vinod@kurup.com -
+ +

+ + Note that previous versions of this document recommended using + /web for the web root and running + AOLserver as the nsadmin user. For + security and compatibility reasons, this is no longer recommended. + +

+ + This guide will use joeuser as a + normal user. Substitute your own username wherever you see + joeuser. + +

Linux Install Guides

+ Here's a list of some helpful documentation for various OS's +

Security Information

+ + 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. + +

($Id$)
Prev Home Next
Overview Up Install Oracle 8.1.7
rmello at fslc.usu.edu
vinod@kurup.com
View comments on this page at openacs.org