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.7 -r1.7.2.1 --- openacs-4/packages/acs-core-docs/www/operating-system.html 7 Mar 2002 06:55:36 -0000 1.7 +++ openacs-4/packages/acs-core-docs/www/operating-system.html 15 May 2002 23:26:18 -0000 1.7.2.1 @@ -1,247 +1,109 @@ - - - -Install an Operating System - - - - - - - - - -
-

-Install an Operating System

-

+Install an Operating System

Install an Operating System

+ by Vinod Kurup
+ 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. -

-
-

-Other OpenACS Guides

-

+

Other OpenACS Guides

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

-
-
-

-Linux Information

-

+

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

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

-
---- - - - - - - - -
RequirementReason
recent kernelCurrently version 2.2.19 or +

- - - - - - - - - - - - - - - - - - - - - - - - - - -
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. + (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. -
glib 2.1 (or greater)You need recent versions of - these libraries for Oracle to work properly.
perl (and perl-suid) +
glib 2.1 (or greater)You need recent versions of + these libraries for Oracle to work properly.
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) + 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) +
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 +
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. -

-
-
-

-Linux Install Guides

-

+

Linux Install Guides

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

- -
-

-Security Information

-

+

  • Official + Debian Guide

  • RedHat

  • Mandrake

  • SuSE

  • 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$)

    -
    -

    - - +