Index: openacs-4/packages/acs-core-docs/www/install-steps.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-steps.html,v diff -u -r1.15.2.6 -r1.15.2.7 --- openacs-4/packages/acs-core-docs/www/install-steps.html 8 Nov 2004 19:59:24 -0000 1.15.2.6 +++ openacs-4/packages/acs-core-docs/www/install-steps.html 27 Nov 2004 01:32:49 -0000 1.15.2.7 @@ -1,22 +1,22 @@ Basic Steps
Alex logo
Prev Chapter�2.�Installation Overview Next

Basic Steps

- The basic steps for getting OpenACS installed are: + The basic steps for installing OpenACS are:

  1. Install an OS and supporting software (see Install a Unix-like OS or Appendix�A, Install Red Hat 8/9 for more details). See the Table�2.2, “Version Compatibility Matrix”.

  2. Install a database (see the section called “Install Oracle 8.1.7” or Install PostgreSQL).

  3. Install AOLserver (Install AOLserver 4) .

  4. Create a unique database and system user. Install the OpenACS tarball, start and AOLserver instance, and use the OpenACS web pages to complete installation - (see Install OpenACS 5.1.2).

There are specific instructions available for Mac OS X and - Windows2000 available (see the section called “OpenACS Installation Guide for Mac OS X” or - the section called “OpenACS Installation Guide for Windows2000” for those).

Binaries and other shortcuts

  1. The patched version of AOLserver we use is not currently + (see Install OpenACS 5.1.3).

Specific instructions are available for Mac OS X and + Windows2000 (see the section called “OpenACS Installation Guide for Mac OS X” or + the section called “OpenACS Installation Guide for Windows2000”).

Binaries and other shortcuts

  1. The patched version of AOLserver we use is not currently available in a precompiled binary.

  2. The packaged version of - PostgreSQL in Debian and Red Hat and FreeBSD ports works fine.

  3. Once AOLserver and a database are installed, a bash script automates the OpenACS checkout and + PostgreSQL in Debian, Red Hat, and FreeBSD ports works fine.

  4. Once AOLserver and a database are installed, a bash script automates the OpenACS checkout and installation.

System Requirements

You will need a PC (or equivalent) with at least these minimum - requirements: + specifications:

  • 128MB RAM (much more if you want Oracle)

  • 1GB free space on your hard drive (much more if you want Oracle)

  • A Unix-like operating system with Tcl, tDOM, and a mail transport agent like sendmail or qmail. (see the section called “Prerequisite Software”)

- All of the software mentioned is free and open-source, + All of the software mentioned is open-source and available without direct costs, except for Oracle. You can obtain a free copy of Oracle for development purposes. This is described in the Acquire Oracle section.

How to use this guide

  • This is text you will see on @@ -37,10 +37,10 @@ su - $OPENACS_SERVICE_NAME svc -d /service/$OPENACS_SERVICE_NAME dropdb $OPENACS_SERVICE_NAME -createdb $OPENACS_SERVICE_NAME

    Setting a global shell variable for cut and paste.�In order to cut and paste the instructions into your shell, you must set the environment variable $OPENACS_SERVICE_NAME. In order to set it globally so that it works for any new users or special service users you may create, edit the file /etc/profile and add this line:

    export OPENACS_SERVICE_NAME=service0

Paths and Users

Table�2.1.�Default directories for a standard install

Fully qualified domain name of your serveryourserver.test
name of administrative access accountremadmin
OpenACS service +createdb $OPENACS_SERVICE_NAME

Setting a global shell variable for cut and paste.�In order to cut and paste the instructions into your shell, you must set the environment variable $OPENACS_SERVICE_NAME. In order to set it globally so that it works for any new users or special service users you may create, edit the file /etc/profile ( /etc/share/skel/dot.profile for FreeBSD) and add this line:

export OPENACS_SERVICE_NAME=service0

Paths and Users

Table�2.1.�Default directories for a standard install

Fully qualified domain name of your serveryourserver.test
name of administrative access accountremadmin
OpenACS service $OPENACS_SERVICE_NAME (set to service0 in default install)
OpenACS service account$OPENACS_SERVICE_NAME
OpenACS database name$OPENACS_SERVICE_NAME
Root of OpenACS service file tree (SERVERROOT)/var/lib/aolserver/$OPENACS_SERVICE_NAME
Location of source code tarballs for new software/tmp
The OpenACS tarball contains some files which are useful while setting up other software. Those - files are located at:/tmp/openacs-5.1.2/packages/acs-core-docs/www/files
Database backup directory/var/lib/aolserver/$OPENACS_SERVICE_NAME/database-backup
Service config files/var/lib/aolserver/$OPENACS_SERVICE_NAME/etc
Service log files/var/lib/aolserver/$OPENACS_SERVICE_NAME/log
Compile directory/usr/local/src
PostgreSQL directory/usr/local/pgsql
AOLserver directory/usr/local/aolserver

+ files are located at:

/tmp/openacs-5.1.3/packages/acs-core-docs/www/files
Database backup directory/var/lib/aolserver/$OPENACS_SERVICE_NAME/database-backup
Service config files/var/lib/aolserver/$OPENACS_SERVICE_NAME/etc
Service log files/var/lib/aolserver/$OPENACS_SERVICE_NAME/log
Compile directory/usr/local/src
PostgreSQL directory/usr/local/pgsql
AOLserver directory/usr/local/aolserver

None of these locations are set in stone - they're simply the values that we've chosen. The values that you'll probably want to change, such as service name, are