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.6.2.3 -r1.6.2.4 --- openacs-4/packages/acs-core-docs/www/install-steps.html 8 Dec 2003 15:41:17 -0000 1.6.2.3 +++ openacs-4/packages/acs-core-docs/www/install-steps.html 15 Dec 2003 15:03:47 -0000 1.6.2.4 @@ -1,23 +1,21 @@ Basic Steps
Alex logo
Prev Chapter�2.�Installation Overview Next

Basic Steps

- The basic steps to getting OpenACS up and running are: -

  1. Install an OS (Linux, FreeBSD, OpenBSD, Appendix�A, Install Red Hat 8/9, the section called “OpenACS Installation Guide for Mac OS X”, the section called “OpenACS Installation Guide for Windows2000”).

  2. Install a database (Oracle or - PostgreSQL).

  3. Install the AOLserver webserver.

  4. Create a unique database and system user. + 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).

    2. Install a database (see Install Oracle or + Install PostgreSQL).

    3. Install AOLserver (see Install AOLserver 3.3oacs1).

    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 - (Install OpenACS 5.0.0b4).

    Binaries and other shortcuts

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

    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 available in a precompiled binary.

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

    3. Jonathan Marsden has created RPMs (at - http://www.xc.org) - for OpenACS 4.5 but there are not yet any for version - 5.0.0b4.

    4. An experimental script automates OpenACS checkout and + PostgreSQL in Debian and Red Hat and FreeBSD ports works fine.

    5. An experimental script automates the OpenACS checkout and installation. -

    Requirements

    +

System Requirements

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

+

All of the software that you will need 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. @@ -30,21 +28,22 @@ 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"} {
           set db_password        "mysitepassword"
-          }

  • This is text that you will +}

  • This is text that you will see and type in a command shell, including text you may have to change. It is followed by a list of just the commands, - which you can copy and paste.

    [root@localhost root]# su - nsadmin
-          [nsadmin@localhost aolserver]$ svc -d /service/server1
-          [nsadmin@localhost aolserver]$ dropdb server1
-          DROP DATABASE
-          [nsadmin@localhost aolserver]$ createdb server1
-          CREATE DATABASE
-          
    su - nsadmin
-            svc -d /service/server1
-            dropdb server1
-            createdb server1

    • Paths and Users

    Figure�2.1.�Assumptions in this Chapter

    Fully qualified domain name of your serveryourserver.test
    name of administrative access accountremadmin
    OpenACS serviceservice0
    OpenACS service accountservice0
    OpenACS database nameservice0
    Root of OpenACS service file tree/var/lib/aolserver/service0
    Location of source code tarballs for new software/tmp
    The OpenACS tarball contains some files which + which you can copy and paste. The command prompt varies by system; in the examples we use the form[nsadmin aolserver]$, where nsadmin is the current user and aolserver is the current directory. The root prompt is shown ending in # and all other prompts in $.

    +[root root]# su - nsadmin
+[nsadmin aolserver]$ svc -d /service/server1
+[nsadmin aolserver]$ dropdb server1
+DROP DATABASE
+[nsadmin aolserver]$ createdb server1
+CREATE DATABASE
+su - nsadmin
+svc -d /service/server1
+dropdb server1
+createdb server1

    Paths and Users

    Table�2.2.�Default directories for a standard install

    Fully qualified domain name of your serveryourserver.test
    name of administrative access accountremadmin
    OpenACS serviceservice0
    OpenACS service accountservice0
    OpenACS database nameservice0
    Root of OpenACS service file tree (SERVERROOT)/var/lib/aolserver/service0
    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.0.0b4/packages/acs-core-docs/www/files
    Database backup directory/var/lib/aolserver/service0/database-backup
    Service config files/var/lib/aolserver/service0/etc
    Service log files/var/lib/aolserver/service0/log
    Compile directory/usr/local/src
    PostgreSQL directory/usr/local/pgsql
    AOLserver directory/usr/local/aolserver

    + files are located at:

    		/tmp/openacs-5.0.0b4/packages/acs-core-docs/www/files
    Database backup directory/var/lib/aolserver/service0/database-backup
    Service config files/var/lib/aolserver/service0/etc
    Service log files/var/lib/aolserver/service0/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