Index: openacs-4/packages/acs-core-docs/www/xml/index.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/index.xml,v diff -u -r1.11 -r1.12 --- openacs-4/packages/acs-core-docs/www/xml/index.xml 28 Feb 2003 05:25:49 -0000 1.11 +++ openacs-4/packages/acs-core-docs/www/xml/index.xml 17 Jun 2003 20:56:17 -0000 1.12 @@ -2,15 +2,44 @@ - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -24,7 +53,14 @@ + + + + + + + @@ -36,7 +72,6 @@ - @@ -46,8 +81,6 @@ - - @@ -58,28 +91,9 @@ - - - - - - - - - - - - - - - - - - - - ]> + OpenACS Documentation @@ -137,21 +151,23 @@ web site and feel free to ask a question, post ideas or whatever. - - &release-notes; - + + + Release Notes + Release Notes Prior + to 5.0.0. + &release-notes; + Administrator's Guide - - Guide to installation, upgrade, and maintenance. - - - + &software; + &compatibility; + Installing on Unix/Linux &install-overview; @@ -160,7 +176,6 @@ &postgres; &aolserver; &openacs; - &nextsteps; &credits; Index: openacs-4/packages/acs-core-docs/www/xml/openacs.xsl =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/openacs.xsl,v diff -u -r1.6 -r1.7 --- openacs-4/packages/acs-core-docs/www/xml/openacs.xsl 28 Feb 2003 05:25:49 -0000 1.6 +++ openacs-4/packages/acs-core-docs/www/xml/openacs.xsl 17 Jun 2003 20:56:17 -0000 1.7 @@ -3,10 +3,18 @@ version="1.1" exclude-result-prefixes="doc"> - + + + + + + @@ -41,18 +49,18 @@ - + - + - + @@ -95,7 +103,7 @@ - + @@ -109,11 +117,11 @@ - + - + @@ -130,7 +138,7 @@ - + @@ -144,25 +152,22 @@ - + - +
- rmello at fslc.usu.edu -
-
- mailto:vinod@kurup.com + mailto:docs@openacs.org - vinod@kurup.com + docs@openacs.org
@@ -179,7 +184,7 @@
- http://openacs.org/doc/openacs-4/ + http://openacs.org/doc/openacs-4-6-3/ @@ -199,7 +204,7 @@
- OpenACS docs are written by the named authors, but may be edited + OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff.

@@ -303,9 +308,9 @@ -
+ 
     
-
+ Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml,v diff -u -r1.7 -r1.8 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml 28 Feb 2003 05:27:39 -0000 1.7 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml 17 Jun 2003 20:56:17 -0000 1.8 @@ -22,7 +22,9 @@ What's OpenACS? OpenACS was born when Don Baccus, Ben Adida, - et al decided to port ACS from Oracle to PostgreSQL, thus making it a fully open-source solution. + et al decided to port ACS from Oracle to + PostgreSQL, thus making it a fully open-source solution. + OpenACS &version; is the next generation of the web toolkit. It's based on @@ -37,67 +39,71 @@ + Purpose of this document - This document will describe how to install an operating - system, OpenACS &version;, and all supporting software, from - scratch. + + This document will describe how to install, configure, and + maintain an installation of OpenACS &version; on a Unix-like + system, including all supporting software. All examples + in this chapter are part of the OpenACS &version;-P or + OpenACS &version;-O Reference Platform, which use Red + Hat 8.0. Differences between the Reference Platform + and common alternate platforms are noted where known. - Requirements - + Requirements + You will need a PC (or equivalent) with at least these minimum requirements: - - Pentium processor - 128 MB RAM + + Pentium processor + 128 MB RAM (much more if you want Oracle) - 4 GB hard drive - - - + 4 GB hard drive + + You will need all of the required software. + + If you want to serve pages to people outside of your machine, you'll need a network connection of some type. - - + + Note that these are minimum requirements to get a development system - up and running. For a large production system, we recommend you read about - the (now slightly obsolete) ArsDigita - Server Architecture article. + up and running. For a production system, we recommend you read about + the ArsDigita + Server Architecture - - + + Running a reliable database-backed web server requires experience with the server's environment, in this case UNIX. UNIX is not always an intuitive environment and this guide cannot hope to explain every - nuance. If you follow the reference implementation, all of - the unix commands you need will be in the text. However, - you will have trouble indentifying typos or other problems. - Ideally, you should be comfortable with the following tasks before + nuance. You should be comfortable with the following tasks before attempting an installation: - - - + + + Adding users, groups, setting passwords - - + (For Oracle) Starting an X server and running an X program remotely - - + + Basic file management using cp, rm, mv, and cd - - + + Compiling a program using ./config and make. @@ -119,28 +125,27 @@ - Steps involved - + Steps involved + The basic steps to getting OpenACS up and running are: - - - Install an OS and supporting software - - - Install a webserver (AOLServer) - - - Install a database (Oracle or + + + Install an OS + + + Install a webserver (AOLServer) + + + Install a database (Oracle or PostgreSQL) Install a database driver (allows the webserver to talk to the database) - Start the OpenACS - installer, which will configure a database. + Start the OpenACS installer, which will configure a database instance.. @@ -149,15 +154,10 @@ How to use this guide - This is text that - tells you to do something, like click a - Button or - link + This is text you will see on + screen, such as a Button or link + in a radio button list or menu. - - This is an option you will see - on screen, such as 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 @@ -172,15 +172,15 @@ 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/openacs-dev -[nsadmin@localhost aolserver]$ dropdb openacs-dev +[nsadmin@localhost aolserver]$ svc -d /service/server1 +[nsadmin@localhost aolserver]$ dropdb server1 DROP DATABASE -[nsadmin@localhost aolserver]$ createdb openacs-dev +[nsadmin@localhost aolserver]$ createdb server1 CREATE DATABASE su - nsadmin -svc -d /service/openacs-dev -dropdb openacs-dev -createdb openacs-dev +svc -d /service/server1 +dropdb server1 +createdb server1 @@ -212,7 +212,7 @@ worry if you feel overwhelmed by all the information in the error logs. Over time, you'll find that they make more and more sense. Soon, you'll actually look forward to errors so that you - can find the problem in the log. + can run to the log and diagnose the problem. @@ -226,9 +226,17 @@ + The bottom of each page has a link to OpenACS.org, where you can post + comments and read other users comments about the + contents of the page. + + + + + Ask questions at the irc channel on openprojects.net - (#openacs). They're knowledgeable and quite friendly if you can - keep them on topic. + (#openacs). They're knowledgeable and quite friendly + if you can keep them on topic. @@ -238,10 +246,9 @@ url="http://openacs.org/bboard/">bboards. Make sure you've done a search first. When you do post, be sure to include your setup information (OS, etc) as well as the exact commands - that are failing with the accompanying error. If you want to post - stuff from your logs (please do!), be sure to enclose them in - <PRE></PRE> tags so that they don't get all jumbled - together. + that are failing with the accompanying error. If + there's a SQL error in the TCL error or in the log, + post that too. @@ -280,6 +287,9 @@ I've used something that you've written without proper credit, let me know and I'll fix it right away. + Version &version; was edited by Joel Aufrecht. + These are a few of my sources: @@ -298,23 +308,112 @@ - Vinod - Kurup's Brief OpenACS4 installation guide + Vinod Kurup's Brief OpenACS4 + installation guide - Joel Aufrecht's OpenACS 4.5 Quick Guide. - + Please also see the section for more acknowledgements. + + Linux Install Guides + + Here's a list of some helpful documentation for various OS's + + + + + Painless Debian + GNU/Linux by Stephen van Egmond + + + + + Official + Debian Guide + + + + + + RedHat + + + + + + Mandrake + + + + + + SuSE + + + + + + + + + Security Information + + Once you get your OS installed, it's imperative that you secure your + installation. As Jon Griffin repeatedly warns us, "No distribution is + secure out of the box." The Reference Platform implements + some basic precautions, but security is a process, not a + condition. If you are responsible for a computer hooked to the + internet, you are responsible for learning some rudiments of + security, such as monitoring the state of a computer, + maintaining patch levels, and keeping backups. We recommend + these resources: + + + + + + Securing and Optimizing Linux - version 2.0 + + + + Jon + Griffin's notes + + + Linux Administrators + Security Guide + + + Installation + of a Secure Webserver + + + + Bruce + Schneier's Crypto-Gram, especially The + security patch treadmill and Monitoring First. + + + + + Resources @@ -419,7 +518,6 @@ ($Id$) -