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.19.2.7 -r1.19.2.8 --- openacs-4/packages/acs-core-docs/www/xml/index.xml 2 Dec 2003 17:39:31 -0000 1.19.2.7 +++ openacs-4/packages/acs-core-docs/www/xml/index.xml 6 Dec 2003 21:22:58 -0000 1.19.2.8 @@ -19,80 +19,73 @@ Overview - - OpenACS (Open Architecture Community System) is an - advanced toolkit for building scalable, community-oriented - web applications. If you're thinking of building an - enterprise-level web application, OpenACS is a solid, - proven foundation that will give you a 3-6 month - headstart. - + + OpenACS (Open Architecture Community System) is an + advanced toolkit for building scalable, community-oriented + web applications. If you're thinking of building an + enterprise-level web application, OpenACS is a solid, + scalable framework for building dynamic content driven + sites. + - - OpenACS is also a collection of pre-built applications and - services that you can use to build your web - site/application. Through a modular architecture, OpenACS - has packages for user/groups management, content - management, e-commerce, news, FAQ, calendar, forums, bug - tracking, full-text searching, and much + + OpenACS is a collection of pre-built applications and + services that you can use to build your web + site/application. Through a modular architecture, OpenACS + has packages for user/groups management, content + management, e-commerce, news, FAQs, calendar, forums, bug + tracking, full-text searching, and much more. - + - - OpenACS relies on + OpenACS relies on AOLserver, the - free, multithreaded, scalable, Tcl-enabled, - web/application server used by America On-Line for most of - its web sites, and a true acid-compliant Relational - Database Management System (RDBMS). Currently OpenACS - supports PostgreSQL, an open source RDBMS, and - Oracle. (read - more) - + free, multithreaded, scalable, Tcl-enabled, + web/application server used by America Online for most of + its web sites, and a true ACID-compliant Relational + Database Management System (RDBMS). Currently OpenACS + supports PostgreSQL, an open source RDBMS, and Oracle and + is easily extensible to other databases which support a + comparable feature set. + - - The OpenACS toolkit is based on the ArsDigita Community - System. ArsDigita (now part of Red Hat, Inc.) kindly made - their work available under the GPL, - making all of this possible. - + + The OpenACS toolkit is derived from the ArsDigita + Community System (ACS). ArsDigita (now part of Red Hat, + Inc.) kindly made their work available under the GPL, + making all of this possible. + - The ArsDigita Community System (ACS) is a toolkit of software - that will help you build Web services with a collaborative dimension, - ranging from knowledge management within companies to B2C ecommerce - to product support and community among the customers. The software is - free and open-source and has been tested in heavy use since - 1995. - Philip Greenspun - + The OpenACS project was born when Don Baccus, Ben Adida, and + others decided to port ACS from Oracle to PostgreSQL, thus + making it a fully open-source solution. With OpenACS 4, + Oracle and PostgreSQL support were combined in one code base + and with OpenACS 5, support for internationalization and + localization has been added. + - - 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. + + A vibrant and productive community has sprung up around the + OpenACS software and there are many volunteer contributors + as well as a commercial companies able to provide support, + hosting, and custom development. Many of the production + users are actively funding and contributing work back to the + project. Formal, consensus driven governance has been + established (with semi-annual elections) which ensures the + project serves the needs of it's constituents. - - OpenACS &version; is the next generation of the web toolkit. It's based on - ACS 4, but no longer follows ArsDigita development. Unlike ACS - (which required Oracle) and OpenACS 3.x (which required PostgreSQL), - OpenACS &version; allows you to use either database. It's also built in such - a way to allow enterprising hackers (in the good sense of - the word) to extend it to other databases. Don Baccus leads - the development and numerous developers and non-developers - contribute from around the world. - - - The OpenACS community would like to hear your comments and - help you in your endeavors with the system. Stop by our - web site and feel - free to ask a question, post ideas or whatever. - + The OpenACS community would like to hear your comments and + can help you in your endeavors with the system. Visit our + web site and feel + free to ask questions or provide feedback. + Release Notes Section Missing @@ -292,6 +285,9 @@ Section missing + + Section missing + Section missing Fisheye: Tag 1.1 refers to a dead (removed) revision in file `openacs-4/packages/acs-core-docs/www/xml/engineering-standards/nxml-mode.xml'. Fisheye: No comparison available. Pass `N' to diff? 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.17.2.2 -r1.17.2.3 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml 29 Nov 2003 15:17:54 -0000 1.17.2.2 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml 6 Dec 2003 21:22:58 -0000 1.17.2.3 @@ -4,408 +4,411 @@ %myvars; ]> - - - Basic Steps - - The basic steps to getting OpenACS up and running are: - - - - Install an OS (Linux, FreeBSD, OpenBSD, , , ). - - - Install a database ( + Basic Steps + + + The basic steps to getting OpenACS up and running are: + + + + Install an OS (Linux, FreeBSD, OpenBSD, , , ). + + + Install a database (Oracle or - PostgreSQL). - + PostgreSQL). + - - Install the AOLserver webserver. - - - Create a unique database and system user. - Install the OpenACS tarball, start and AOLserver instance, and - use the OpenACS web pages to complete installation - (). - - - - - Binaries and other shortcuts - - - The patched version of AOLserver we use is not currently - available in a precompiled binary. - - - - The packaged version of - PostgreSQL in Debian and Red Hat and FreeBSD ports works fine. - - - Jonathan Marsden has created RPMs (at - http://www.xc.org) - for OpenACS 4.5 but there are not yet any for version - &version;. - - - An experimental script automates OpenACS checkout and - installation. - - - - - - - Requirements + + Install the AOLserver webserver. + + + Create a unique database and system user. + Install the OpenACS tarball, start and AOLserver instance, and + use the OpenACS web pages to complete installation + (). + + + + + + Binaries and other shortcuts + + + + The patched version of AOLserver we use is not currently + available in a precompiled binary. + + - You will need a PC (or equivalent) with at least these minimum - requirements: - - - Pentium processor - 128 MB RAM - (much more if you want Oracle) - 4 GB hard drive - A Unix-like operating system with tcl, tdom, and - a mail transport agent. () - - - 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 section. - -
- Compatibility Matrix - - - - - - - - - - - - - - - OpenACS Version - 3.2.5 - 4.5 - 4.6 - 4.6.1 - 4.6.2 - 4.6.3 - 5.0.0 - - - AOLserver - 3 - Verified - No - - - 3.3+ad13 - Untested - Verified - - - 3.3oacs1 - Untested - Verified - - - 3.4.2 - No - - - 3.4.2oacs1 - Untested - Verified - Untested - - - 3.5.5 - Untested - Verified - No - - - 4.0 - Untested - Verified - - - PostgreSQL - 7.0 - Verified - No - - - 7.2.x - Verified - No - - - 7.3.2 - 7.3.4 - No - Verified - - - 7.4 - No - Untested - + The packaged version of + PostgreSQL in Debian and Red Hat and FreeBSD ports works fine. + + + Jonathan Marsden has created RPMs (at + http://www.xc.org) + for OpenACS 4.5 but there are not yet any for version + &version;. + + + An experimental script automates OpenACS checkout and + installation. + + + + + - - Oracle - 8.1.6 - Verified - - - 8.1.7 - Verified - - - 9i - No - Untested - - - - -
- - At the time of writing AOLserver 4.0 has been tested with OpenACS and works but has not been used in - production. OpenACS 5.0.0 installs successfully on PostgreSQL 7.4 and Oracle 9i but not all packages - outside core have been tested. - - + + Requirements + + You will need a PC (or equivalent) with at least these minimum + requirements: + + + Pentium processor + 128 MB RAM + (much more if you want Oracle) + 4 GB hard drive + A Unix-like operating system with tcl, tdom, and + a mail transport agent. () + + + 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 section. + - - How to use this guide - - - This is text you will see on - screen, such as a Button 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 -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 - - + + Version Compatibility Matrix + + + + + + + + + + + + + OpenACS Version + 3.2.5 + 4.5 + 4.6 + 4.6.1 + 4.6.2 + 4.6.3 + 5.0.0 + + + + + AOLserver + 3 + Verified + No + + + 3.3+ad13 + Untested + Verified + + + 3.3oacs1 + Untested + Verified + + + 3.4.2 + No + + + 3.4.2oacs1 + Untested + Verified + Untested + + + 3.5.5 + Untested + Verified + No + + + 4.0 + Untested + Verified + + + PostgreSQL + 7.0 + Verified + No + + + 7.2.x + Verified + No + + + 7.3.2 - 7.3.4 + No + Verified + + + 7.4 + No + Untested + + + Oracle + 8.1.6 + Verified + + + 8.1.7 + Verified + + + 9i + No + Untested + + + +
+ + + + At the time of writing AOLserver 4.0 has been tested with OpenACS and works but has not been used in + production. OpenACS 5.0.0 installs successfully on PostgreSQL 7.4 and Oracle 9i but not all packages + outside core have been tested. + - - Paths and Users - -
- Assumptions in this Chapter - - - - - Fully qualified domain name of your server - yourserver.test - - - name of administrative access account - remadmin - - - OpenACS service - - service0 - -service0 - - - OpenACS service account - service0 - - - OpenACS database name - service0 - - - 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 + + + How to use this guide + + + + This is text you will see on + screen, such as a Button 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 + 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 + +
+ Assumptions in this Chapter + + + + + Fully qualified domain name of your server + yourserver.test + + + name of administrative access account + remadmin + + + OpenACS service + + service0 + + service0 + + + OpenACS service account + service0 + + + OpenACS database name + service0 + + + 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 are useful while setting up other software. Those files are located at: - /tmp/&tarballpath;/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 - - - - -
+ /tmp/&tarballpath;/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 - marked like this. The other - values we recommend you leave unchanged unless you have a - reason to change them. - - - - 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 + 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 + marked like this. The other + values we recommend you leave unchanged unless you have a + reason to change them. + + + + 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. - - + thread for discussion. + - - + - - Getting Help during installation - - - 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 - the output if needed. An alternative would be to use the - script command. - - + + Getting Help during installation - - - 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 - 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 run to the log and diagnose the problem. - - + + 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: + - - - Search the forums at - openacs.org - you'll often find many people who have - struggled through the same spot that you're in. - - + + + + 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 + the output if needed. An alternative would be to use the + script command. + + - - - 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. - - + + + 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 + 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 run to the log and diagnose the problem. + + - - - Ask questions at the irc channel on freenode.net - (#openacs). They're knowledgeable and quite friendly - if you can keep them on topic. - - + + + Search the forums at + openacs.org - you'll often find many people who have + struggled through the same spot that you're in. + + - - - Post a question on the forums. 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 - there's a SQL error in the TCL error or in the log, - post that too. - - + + + 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. + + - - - If you find errors in this document or if you have ideas about - making it better, please post them in our - BugTracker. + + + Ask questions at the irc channel on freenode.net + (#openacs). They're knowledgeable and quite friendly + if you can keep them on topic. - - - ($Id: overview.xml,v 1.12 2003/10/28 - 22:07:41 joela Exp $) + - - + + + Post a question on the forums. 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 + there's a SQL error in the TCL error or in the log, + post that too. + + + + + If you find errors in this document or if you have ideas about + making it better, please post them in our + BugTracker. + + + + ($Id$) + - +