Basic Steps

+Basic Steps

Prev	Chapter 2. Installation Overview	Next

Basic Steps

Most of the documentation in this section is kept as a + reference. More up-to-date documentation is in the install + sections in the Wiki. +

The basic steps for installing OpenACS are:

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”.
Install a database (see the section called “Install Oracle 8.1.7” or Install PostgreSQL).
Install AOLserver (Install AOLserver 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.7.0).

Specific instructions are available for Mac OS X and + (see Install OpenACS 5.9.0).

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

You can try out OpenACS using some binary installers. In + the section called “OpenACS Installation Guide for Windows”).

Binaries and other shortcuts

You can try out OpenACS using some binary installers. In general, they are not yet supported by the community, so they are mostly for evaluation purposes. Installing OpenACS

You can see a list of current installers. @@ -41,10 +44,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 ( /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 server yourserver.test

name of administrative access account remadmin

OpenACS service

+createdb $OPENACS_SERVICE_NAME

export OPENACS_SERVICE_NAME=service0

Paths and Users

Table 2.1. Default directories for a standard install

Fully qualified domain name of your server	yourserver.test
name of administrative access account	remadmin
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	/var/tmp
The OpenACS tarball contains some files which are useful while setting up other software. Those - files are located at:	/var/tmp/openacs-5.7.0/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:

/var/tmp/openacs-5.9.0/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 @@ -94,4 +97,4 @@ If you find errors in this document or if you have ideas about making it better, please post them in our BugTracker. -

($Id$)

Prev	Home	Next
Chapter 2. Installation Overview	Up	Prerequisite Software