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.19 -r1.20 --- openacs-4/packages/acs-core-docs/www/install-steps.html 5 May 2004 12:36:04 -0000 1.19 +++ openacs-4/packages/acs-core-docs/www/install-steps.html 11 Jun 2004 10:17:37 -0000 1.20 @@ -1,6 +1,6 @@ -Basic Steps
Alex logo
Prev Chapter�2.�Installation Overview Next

Basic Steps

+Basic Steps

Alex logo
Prev Chapter�2.�Installation Overview Next

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 Install Oracle or +

    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 @@ -27,19 +27,19 @@ }

    5. 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. The command prompt varies by system; in the examples we use the form[service0 aolserver]$, where service0 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 - service0
-[service0 aolserver]$ svc -d /service/service0
-[service0 aolserver]$ dropdb service0
+          which you can copy and paste. The command prompt varies by system; in the examples we use the form[$OPENACS_SERVICE_NAME aolserver]$, where $OPENACS_SERVICE_NAME 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 - $OPENACS_SERVICE_NAME
+[$OPENACS_SERVICE_NAME aolserver]$ svc -d /service/$OPENACS_SERVICE_NAME
+[$OPENACS_SERVICE_NAME aolserver]$ dropdb $OPENACS_SERVICE_NAME
 DROP DATABASE
-[service0 aolserver]$ createdb service0
+[$OPENACS_SERVICE_NAME aolserver]$ createdb $OPENACS_SERVICE_NAME
 CREATE DATABASE
-su - service0
-svc -d /service/service0
-dropdb service0
-createdb 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 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 +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 are useful while setting up other software. Those - files are located at:/tmp/openacs-5.2.0d1/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.2.0d1/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