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.4 -r1.15.2.5 --- openacs-4/packages/acs-core-docs/www/install-steps.html 22 Oct 2004 02:38:14 -0000 1.15.2.4 +++ openacs-4/packages/acs-core-docs/www/install-steps.html 1 Nov 2004 23:39:51 -0000 1.15.2.5 @@ -1,25 +1,25 @@ -Basic Steps

Basic Steps

+Basic Steps

Basic Steps

The basic steps for getting OpenACS installed 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 + 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 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 installation. -

    System Requirements

    +

System Requirements

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

  • 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, 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 +

How to use this guide

  • This is text you will see on screen, such as a Button or link in a radio button list or menu.

  • This is text that you will type.

  • This is text from a program or file which you may need to examine or edit:

    if {$database == "oracle"} {
    @@ -37,7 +37,8 @@
     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$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 +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 + $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

None of these locations are set in stone - they're simply @@ -49,7 +50,7 @@ Some of the paths and user accounts have been changed from those recommended in previous versions of this document to improve security and maintainability. See this - thread for discussion.

Getting Help during installation

+ thread for discussion.

Getting Help during installation

We'll do our best to assure that following our instructions will get you to the promised land. If something goes wrong, don't panic. There are plenty of ways to get help. Here are some tips: