| Prev | Chapter�2.�Installation Overview | Next |
|---|
+ +
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 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.
Install a database (see Section�, “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.2.3rc1).
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”).
You can try out OpenACS using some binary installers. In + (see Install OpenACS 5.3.0).
Specific instructions are available for Mac OS X and + Windows2000 (see Section�, “OpenACS Installation Guide for Mac OS X” or + Section�, “OpenACS Installation Guide for Windows2000”).
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.
The packaged version of PostgreSQL in Debian, Red Hat, and FreeBSD ports works fine.
Once AOLserver and a database are installed, a bash script automates the OpenACS checkout and installation. -
You will need a PC (or equivalent) with at least these minimum 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”)
+ a mail transport agent like sendmail or qmail. (see Section�, “Prerequisite Software”)
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. -
This is text you will see on
- screen, such as a 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"} {
- set db_password "mysitepassword"
+ This is text you will see on + screen, such as a 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"} {
+ set db_password "mysitepassword"
}This is text that you will
- see and type in a command shell, including text you may have to
+ 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[$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+ 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 -[$OPENACS_SERVICE_NAME aolserver]$createdb $OPENACS_SERVICE_NAME+[$OPENACS_SERVICE_NAME aolserver]$ createdb $OPENACS_SERVICE_NAME CREATE DATABASE su - $OPENACS_SERVICE_NAME svc -d /service/$OPENACS_SERVICE_NAME dropdb $OPENACS_SERVICE_NAME -createdb $OPENACS_SERVICE_NAMESetting 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.profilefor FreeBSD) and add this line:export OPENACS_SERVICE_NAME=service0
Table�2.1.�Default directories for a standard install
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 @@ -53,16 +53,16 @@ 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.
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:
Keep track of the commands you are run and record their output. I
like to do my installations in a shell inside of emacs
- (M-x shell) so that I can save
+ (M-x shell) so that I can save
the output if needed. An alternative would be to use the
- script command.
+ script command.
We'll point out where the error logs for the various pieces of software are. Output from those logs will help us help you. Don't