Index: openacs-4/packages/acs-core-docs/www/acs-admin.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/acs-admin.html,v diff -u -N -r1.17 -r1.18 --- openacs-4/packages/acs-core-docs/www/acs-admin.html 5 Nov 2003 11:48:09 -0000 1.17 +++ openacs-4/packages/acs-core-docs/www/acs-admin.html 11 Nov 2003 10:28:27 -0000 1.18 @@ -1 +1 @@ -
Table of Contents
Tutorials and reference material for creating new OpenACS packages. -
Table of Contents
Tutorials and reference material for creating new OpenACS packages. +
Table of Contents
Table of Contents
Prev | Home | Next |
Appendix�E.�How to package and release OpenACS | Up | Platform Development |
Table of Contents
Prev | Home | Next |
Appendix�E.�How to package and release OpenACS | Up | Platform Development |
Download the Analog source tarball in +
Download the Analog source tarball in /tmp. Unpack, compile, and install analog.
[root@yourserver aolserver]# cd /usr/local/src [root@yourserver src]# tar xzf /tmp/analog-5.32.tar.gz [root@yourserver src]# cd analog-5.32 @@ -17,4 +17,4 @@ cd analog-5.32 make cd .. -mv analog-5.32 /usr/share/
See also the section called “Set up Log Analysis Reports - OPTIONAL”
+
by Vinod Kurup
OpenACS docs are written by the named authors, and may be edited
by OpenACS documentation staff.
@@ -18,7 +18,7 @@
[root@yourserver src]#
cd /usr/local/src
wget --passive http://uptime.openacs.org/aolserver-openacs/aolserver3.3oacs1.tar.gz
-tar xzf aolserver3.3oacs1.tar.gz
Compile AOLserver.�Compile and install AOLserver. First, prepare the installation directory and the source code. The message about BUILD-MODULES can be ignored.
root@yourserver root]# mkdir -p /usr/local/aolserver +tar xzf aolserver3.3oacs1.tar.gz
This section also relies on some OpenACS files, which you can get with the section called “Unpack the OpenACS tarball”.
Compile AOLserver.�Compile and install AOLserver. First, prepare the installation directory and the source code. The message about BUILD-MODULES can be ignored.
root@yourserver root]# mkdir -p /usr/local/aolserver [root@yourserver root]# cd /usr/local/src/aolserver [root@yourserver aolserver]# ./conf-clean cat: BUILD-MODULES: No such file or directory @@ -39,7 +39,7 @@ tarball's default value with our default value, /usr/local/aolserver:[root@yourserver aolserver]# echo "/usr/local/aolserver" > conf-inst [root@yourserver aolserver]#conf-make should contain the name of the GNU Make command on your system. It defaults to - gmake.
Set an environment variable that the nspostgres driver + gmake. Debian users: ln -s /usr/bin/make /usr/bin/gmake.
Set an environment variable that the nspostgres driver Makefile needs to compile correctly and run conf, which compiles AOLserver, the default modules, and the database driver, and Index: openacs-4/packages/acs-core-docs/www/apm-design.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/apm-design.html,v diff -u -N -r1.19 -r1.20 --- openacs-4/packages/acs-core-docs/www/apm-design.html 5 Nov 2003 14:46:51 -0000 1.19 +++ openacs-4/packages/acs-core-docs/www/apm-design.html 11 Nov 2003 10:28:27 -0000 1.20 @@ -1,4 +1,4 @@ -
OpenACS 5.0.0a4 Package Manager Design +
OpenACS 5.0.0a4 Package Manager Design by Bryan Quinn
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. @@ -88,7 +88,7 @@ packages for other ACS users to download and install.For a simple illustration of the difference between ACS without APM (pre-3.3) and ACS with APM (3.3 and beyond), consider a hypothetical ACS installation that uses only two of the thirty-odd modules available circa ACS -3.2 (say, bboard and e-commerce):
[D]APM itself is part of a package, the OpenACS Kernel, an OpenACS +3.2 (say, bboard and e-commerce):
[D]APM itself is part of a package, the OpenACS Kernel, an OpenACS service that is the only mandatory component of an OpenACS installation.
The OpenACS is a platform for web-based application software, and any software platform has the potential to develop problems like those described above. Fortunately, there are many precedents for systematic solutions, Index: openacs-4/packages/acs-core-docs/www/apm-requirements.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/apm-requirements.html,v diff -u -N -r1.14 -r1.15 --- openacs-4/packages/acs-core-docs/www/apm-requirements.html 31 Oct 2003 10:54:19 -0000 1.14 +++ openacs-4/packages/acs-core-docs/www/apm-requirements.html 11 Nov 2003 10:28:27 -0000 1.15 @@ -1,4 +1,4 @@ -
OpenACS 5.0.0a4 Package Manager Requirements +
OpenACS 5.0.0a4 Package Manager Requirements by Bryan Quinn and Todd Nightingale
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. Index: openacs-4/packages/acs-core-docs/www/backup-recovery.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/backup-recovery.html,v diff -u -N -r1.12 -r1.13 --- openacs-4/packages/acs-core-docs/www/backup-recovery.html 5 Nov 2003 14:46:51 -0000 1.12 +++ openacs-4/packages/acs-core-docs/www/backup-recovery.html 11 Nov 2003 10:28:27 -0000 1.13 @@ -1,4 +1,4 @@ -Backup and Recovery +
Backup and Recovery by Don Baccus with additions by Joel Aufrecht
@@ -143,7 +143,7 @@ single nightly backup file which is then collected into a bigger backup file that includes the other parts of the service (web pages, content, code). To make a new file every - night, edit the crontab file for service0:[service0@yourserver service0]$ export EDITOR=emacs;crontab -eAdd this line to the file. The numbers and stars at the beginning are cron columns that specify when the program should be run - in this case, whenever the minute is 0 and the hour is 1, i.e., 1:00 am every day.
0 1 * * * /usr/local/pgsql/bin/pg_dump -f /var/lib/aolserver/service0/database-backup/service0_`date +\%Y-\%m-\%d`.dmp service0If you plan to back up the whole /var/lib/aolserver/service0 directory, then it would be redundant to keep a history of database backups. In that case, set up the cron job to overwrite the previous backup each time:
0 1 * * * /usr/local/pgsql/bin/pg_dump -f /var/lib/aolserver/service0/database-backup/service0_nightly.dmp service0On a test service, make sure that your backup-recovery process work. After backing up the database and file system, delete the service as detailed below and then recover it.
[root@yourserver root]# svc -d /service/service0 + night, edit the crontab file for service0:[service0@yourserver service0]$ export EDITOR=emacs;crontab -eAdd this line to the file. The numbers and stars at the beginning are cron columns that specify when the program should be run - in this case, whenever the minute is 0 and the hour is 1, i.e., 1:00 am every day.
0 1 * * * /usr/local/pgsql/bin/pg_dump -f /var/lib/aolserver/service0/database-backup/service0_`date +\%Y-\%m-\%d`.dmp service0If you plan to back up the whole /var/lib/aolserver/service0 directory, then it would be redundant to keep a history of database backups. In that case, set up the cron job to overwrite the previous backup each time:
0 1 * * * /usr/local/pgsql/bin/pg_dump -f /var/lib/aolserver/service0/database-backup/service0_nightly.dmp service0On a test service, make sure that your backup-recovery process work. After backing up the database and file system, delete the service as detailed below and then recover it.
[root@yourserver root]# svc -d /service/service0 [root@yourserver root]# mv /var/lib/aolserver/service0/ /var/lib/aolserver/service0.lost [root@yourserver root]# rm /service/service0 rm: remove symbolic link `/service/service0'? y Index: openacs-4/packages/acs-core-docs/www/bootstrap-acs.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/bootstrap-acs.html,v diff -u -N -r1.20 -r1.21 --- openacs-4/packages/acs-core-docs/www/bootstrap-acs.html 5 Nov 2003 14:46:51 -0000 1.20 +++ openacs-4/packages/acs-core-docs/www/bootstrap-acs.html 11 Nov 2003 10:28:27 -0000 1.21 @@ -1,4 +1,4 @@ -Bootstrapping OpenACS +
Bootstrapping OpenACS by Jon Salz
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. Index: openacs-4/packages/acs-core-docs/www/complete-install.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/complete-install.html,v diff -u -N -r1.2 -r1.3 --- openacs-4/packages/acs-core-docs/www/complete-install.html 31 Oct 2003 10:54:19 -0000 1.2 +++ openacs-4/packages/acs-core-docs/www/complete-install.html 11 Nov 2003 10:28:27 -0000 1.3 @@ -1 +1 @@ -Chapter�3.�Complete Installation
Prev Home Next Prerequisite Software Up Install Unix-like system and supporting software
docs@openacs.orgView comments on this page at openacs.org +Chapter�3.�Complete Installation
Prev Home Next Prerequisite Software Up Install Unix-like system and supporting software
docs@openacs.orgView comments on this page at openacs.org Index: openacs-4/packages/acs-core-docs/www/configure.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/Attic/configure.html,v diff -u -N -r1.5 -r1.6 --- openacs-4/packages/acs-core-docs/www/configure.html 31 Oct 2003 10:54:19 -0000 1.5 +++ openacs-4/packages/acs-core-docs/www/configure.html 11 Nov 2003 10:28:27 -0000 1.6 @@ -1 +1 @@ -Chapter�4.�Configuring a New Service View comments on this page at openacs.org +Chapter�4.�Configuring a New Service View comments on this page at openacs.org Index: openacs-4/packages/acs-core-docs/www/credits.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/credits.html,v diff -u -N -r1.20 -r1.21 --- openacs-4/packages/acs-core-docs/www/credits.html 5 Nov 2003 14:46:51 -0000 1.20 +++ openacs-4/packages/acs-core-docs/www/credits.html 11 Nov 2003 10:28:27 -0000 1.21 @@ -1,4 +1,4 @@ -Appendix�C.�Credits Table of Contents
+
Appendix�C.�Credits Table of Contents
by Vinod Kurup
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. Index: openacs-4/packages/acs-core-docs/www/cvs-service-import.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/Attic/cvs-service-import.html,v diff -u -N -r1.11 -r1.12 --- openacs-4/packages/acs-core-docs/www/cvs-service-import.html 5 Nov 2003 14:46:51 -0000 1.11 +++ openacs-4/packages/acs-core-docs/www/cvs-service-import.html 11 Nov 2003 10:28:27 -0000 1.12 @@ -1,4 +1,4 @@ -Add the Service to CVS - OPTIONAL These steps take an existing OpenACS directory and add +
Add the Service to CVS - OPTIONAL These steps take an existing OpenACS directory and add it to a CVS repository..
Create and set permissions on a subdirectory in the local cvs repository.
[root@yourserver root]# mkdir /cvsroot/service0 [root@yourserver root]# chown service0.web /cvsroot/service0 Index: openacs-4/packages/acs-core-docs/www/cvs-tips.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/cvs-tips.html,v diff -u -N -r1.5 -r1.6 --- openacs-4/packages/acs-core-docs/www/cvs-tips.html 31 Oct 2003 10:54:19 -0000 1.5 +++ openacs-4/packages/acs-core-docs/www/cvs-tips.html 11 Nov 2003 10:28:27 -0000 1.6 @@ -1,4 +1,4 @@ -Appendix�D.�Using CVS with an OpenACS Site Table of Contents
+
Appendix�D.�Using CVS with an OpenACS Site Table of Contents
by Joel Aufrecht
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. Index: openacs-4/packages/acs-core-docs/www/database-management.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/database-management.html,v diff -u -N -r1.12 -r1.13 --- openacs-4/packages/acs-core-docs/www/database-management.html 5 Nov 2003 14:46:51 -0000 1.12 +++ openacs-4/packages/acs-core-docs/www/database-management.html 11 Nov 2003 10:28:27 -0000 1.13 @@ -1,4 +1,4 @@ -Database Management +
Database Management by Joel Aufrecht
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. Index: openacs-4/packages/acs-core-docs/www/db-api-detailed.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/db-api-detailed.html,v diff -u -N -r1.20 -r1.21 --- openacs-4/packages/acs-core-docs/www/db-api-detailed.html 5 Nov 2003 14:46:51 -0000 1.20 +++ openacs-4/packages/acs-core-docs/www/db-api-detailed.html 11 Nov 2003 10:28:27 -0000 1.21 @@ -1,4 +1,4 @@ -Database Access API +
Database Access API by Jon Salz. Revised and expanded by Roberto Mello (rmello at fslc dot usu dot edu), July 2002.
Index: openacs-4/packages/acs-core-docs/www/db-api.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/db-api.html,v diff -u -N -r1.20 -r1.21 --- openacs-4/packages/acs-core-docs/www/db-api.html 5 Nov 2003 14:46:51 -0000 1.20 +++ openacs-4/packages/acs-core-docs/www/db-api.html 11 Nov 2003 10:28:27 -0000 1.21 @@ -1,4 +1,4 @@ -The OpenACS Database Access API +
The OpenACS Database Access API By Pete Su and Jon Salz. Modified by Roberto Mello. Index: openacs-4/packages/acs-core-docs/www/dev-guide.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/dev-guide.html,v diff -u -N -r1.15 -r1.16 --- openacs-4/packages/acs-core-docs/www/dev-guide.html 31 Oct 2003 10:54:19 -0000 1.15 +++ openacs-4/packages/acs-core-docs/www/dev-guide.html 11 Nov 2003 10:28:27 -0000 1.16 @@ -1 +1 @@ -
Chapter�8.�Development Reference Table of Contents
- OpenACS 5.0.0a4 Packages
- OpenACS Data Models and the Object System
- The Request Processor
- The OpenACS Database Access API
- Using Templates in OpenACS 5.0.0a4
- Groups, Context, Permissions
- Writing OpenACS 5.0.0a4 Application Pages
- Parties in OpenACS 5.0.0a4
- OpenACS 4.x Permissions Tediously Explained
- Object Identity
- Programming with AOLserver
View comments on this page at openacs.org +Chapter�8.�Development Reference Table of Contents
- OpenACS 5.0.0a4 Packages
- OpenACS Data Models and the Object System
- The Request Processor
- The OpenACS Database Access API
- Using Templates in OpenACS 5.0.0a4
- Groups, Context, Permissions
- Writing OpenACS 5.0.0a4 Application Pages
- Parties in OpenACS 5.0.0a4
- OpenACS 4.x Permissions Tediously Explained
- Object Identity
- Programming with AOLserver
View comments on this page at openacs.org Index: openacs-4/packages/acs-core-docs/www/docbook-primer.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/docbook-primer.html,v diff -u -N -r1.21 -r1.22 --- openacs-4/packages/acs-core-docs/www/docbook-primer.html 5 Nov 2003 14:46:51 -0000 1.21 +++ openacs-4/packages/acs-core-docs/www/docbook-primer.html 11 Nov 2003 10:28:27 -0000 1.22 @@ -1,4 +1,4 @@ -OpenACS Documentation Guide +
OpenACS Documentation Guide By claus@arsdigita.com, with additions by Roberto Mello and the OpenACS Community @@ -31,7 +31,7 @@ In order to separate content and presentation, all OpenACS documentation will be marked up to conform to the DocBook XML DTD - + This enables us to publish in a variety of formats and relieves each contributor of the burden of presentation, freeing him to focus on content and sharing knowledge. @@ -52,7 +52,7 @@ list of elements and use more exotic features in your documents. The list is made up of SGML-elements but basically the same elements are valid in the XML DTD as long as you remember to: - +
Always close your tags with corresponding end-tags and to not use other tag minimization @@ -98,7 +98,7 @@ The documentation for each package will make up a little "book" that is structured like this - examples are emphasized: - +
book : Docs for one package - templating @@ -122,20 +122,20 @@ sources of these DocBook documents to get an idea of how they are tied together.- + Given that your job starts at the sect1-level, all your documents should open with a <sect1>-tag and end with the corresponding </sect1>.
- + You need to feed every <sect1> two attributes. The first attribute, id, is standard and can be used with all elements. It comes in very - handy when interlinking between documents (more about this when talking about links in Section�, “Links”). + handy when interlinking between documents (more about this when talking about links in the section called “Links”). The value of id has to be unique throughout the book you're making since the id's in your sect1's will turn into filenames when the book is parsed into HTML.
- + The other attribute is xreflabel. The value of this is the text that will appear as the link when referring to this sect1.
@@ -150,7 +150,7 @@ </sect1>
- + Inside this container your document will be split up into <sect2>'s, each with the same requirements - id and xreflabel @@ -159,7 +159,7 @@ When it comes to naming your sect2's and below, prefix them with some abbreviation of the id in the sect1 such as requirements-overview.
- + For displaying a snippet of code, a filename or anything else you just want to appear as a part of a sentence, we will use the tag <computeroutput>. @@ -169,12 +169,12 @@ <programlisting> is used. Just wrap your code block in it; mono-spacing, indents and all that stuff is taken care of automatically.
- + Linking falls into two different categories: inside the book you're making and outside:
- 1. Inside linking, cross-referencing other parts of your book
By having unique id's you can cross-reference any part of your book with a simple tag, regardless of where that part is. -
Check out how I link to a subsection of the Developer's Guide:
+Check out how I link to a subsection of the Developer's Guide:
Put this in your XML: @@ -205,14 +205,14 @@ And the output is: - Find information about what a package looks like in - Section�, “What a Package Looks Like” + the section called “What a Package Looks Like”Note that since I haven't provided an xreflabel for the subsection, packages-looks, the parser will try its best to explain where the link takes you.
- 2. Linking outside the documentation
- + If you're hyper-linking out of the documentation, it works almost the same way as HTML - the tag is just a little different @@ -233,7 +233,7 @@ do it, so if you want to start converting your documents right away, start out with the ones without graphics ;)
- + To insert a graphic we use the elements <mediaobject>, <imageobject>, @@ -259,7 +259,7 @@ Put your graphics in a separate directory ("images") and link to them only with relative paths.
- + Here's how you make the DocBook equivalent of the three usual HTML-lists:
- 1. How to make an <ul>
Making an unordered list is pretty much like doing the same thing in HTML - if you close your <li>, that is. The only differences are that each list item has to be wrapped in something more, such as @@ -304,7 +304,7 @@ </variablelist>
- + DocBook supports several types of tables, but in most cases, the <informaltable> is enough: @@ -341,7 +341,7 @@ <table> for an example.
- + Our documentation uses two flavors of emphasis - italics and bold type. DocBook uses one - <emphasis>.
Index: openacs-4/packages/acs-core-docs/www/eng-standards-constraint-naming.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/eng-standards-constraint-naming.html,v diff -u -N -r1.20 -r1.21 --- openacs-4/packages/acs-core-docs/www/eng-standards-constraint-naming.html 5 Nov 2003 14:46:51 -0000 1.20 +++ openacs-4/packages/acs-core-docs/www/eng-standards-constraint-naming.html 11 Nov 2003 10:28:27 -0000 1.21 @@ -1,4 +1,4 @@ -
Constraint naming standard
+Constraint naming standard
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff.Index: openacs-4/packages/acs-core-docs/www/eng-standards-filenaming.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/eng-standards-filenaming.html,v diff -u -N -r1.20 -r1.21 --- openacs-4/packages/acs-core-docs/www/eng-standards-filenaming.html 5 Nov 2003 14:46:51 -0000 1.20 +++ openacs-4/packages/acs-core-docs/www/eng-standards-filenaming.html 11 Nov 2003 10:28:27 -0000 1.21 @@ -1,4 +1,4 @@ -
ACS File Naming and Formatting Standards By michael@arsdigita.com and +
ACS File Naming and Formatting Standards By michael@arsdigita.com and aure@arsdigita.com
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. Index: openacs-4/packages/acs-core-docs/www/eng-standards-plsql.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/eng-standards-plsql.html,v diff -u -N -r1.20 -r1.21 --- openacs-4/packages/acs-core-docs/www/eng-standards-plsql.html 5 Nov 2003 14:46:51 -0000 1.20 +++ openacs-4/packages/acs-core-docs/www/eng-standards-plsql.html 11 Nov 2003 10:28:27 -0000 1.21 @@ -1,4 +1,4 @@ -PL/SQL Standards +
PL/SQL Standards By richardl@arsdigita.com and yon@arsdigita.com
Index: openacs-4/packages/acs-core-docs/www/eng-standards-versioning.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/eng-standards-versioning.html,v diff -u -N -r1.20 -r1.21 --- openacs-4/packages/acs-core-docs/www/eng-standards-versioning.html 5 Nov 2003 14:46:51 -0000 1.20 +++ openacs-4/packages/acs-core-docs/www/eng-standards-versioning.html 11 Nov 2003 10:28:27 -0000 1.21 @@ -1,4 +1,4 @@ -Release Version Numbering
+Release Version Numbering
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff.Index: openacs-4/packages/acs-core-docs/www/eng-standards.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/eng-standards.html,v diff -u -N -r1.13 -r1.14 --- openacs-4/packages/acs-core-docs/www/eng-standards.html 31 Oct 2003 10:54:19 -0000 1.13 +++ openacs-4/packages/acs-core-docs/www/eng-standards.html 11 Nov 2003 10:28:27 -0000 1.14 @@ -1 +1 @@ -
Chapter�9.�Engineering Standards View comments on this page at openacs.org +Chapter�9.�Engineering Standards View comments on this page at openacs.org Index: openacs-4/packages/acs-core-docs/www/ext-auth-requirements.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/ext-auth-requirements.html,v diff -u -N -r1.9 -r1.10 --- openacs-4/packages/acs-core-docs/www/ext-auth-requirements.html 5 Nov 2003 14:46:51 -0000 1.9 +++ openacs-4/packages/acs-core-docs/www/ext-auth-requirements.html 11 Nov 2003 10:28:27 -0000 1.10 @@ -1,4 +1,4 @@ -External Authentication Requirements People have plenty of usernames and passwords already, we +
External Authentication Requirements People have plenty of usernames and passwords already, we don't want them to have yet another. We want people to be able to log in to OpenACS with the same password they use to log in to any other system.
Besides, administrators have better things to do than create @@ -44,7 +44,7 @@ only one implementation of the authentication API, namly the one included in OpenACS Core.
Authentication Driver API: The service contract which authentication drivers implement.
Authentication:
-
Account Management (NO PICTURE YET)
Batch Synchronization (NO PICTURE YET)
Feature Status Description EXT-AUTH-01 A Extend Authentication/Acct Status API EXT-AUTH-03 A Account Creation API EXT-AUTH-05 A Password Management API EXT-AUTH-30 A Authority Management API
Feature Status Description EXT-AUTH-04 A Rewrite login, register, and admin pages to use APIs EXT-AUTH-38 A ad_form complain feature EXT-AUTH-19 A Rewrite password recovery to use API EXT-AUTH-21 A Rewrite email verification with API EXT-AUTH-28 A Username is email switch Users will log in using a username, a authority, and a +
Account Management (NO PICTURE YET)
Batch Synchronization (NO PICTURE YET)
Feature Status Description EXT-AUTH-01 A Extend Authentication/Acct Status API EXT-AUTH-03 A Account Creation API EXT-AUTH-05 A Password Management API EXT-AUTH-30 A Authority Management API
Feature Status Description EXT-AUTH-04 A Rewrite login, register, and admin pages to use APIs EXT-AUTH-38 A ad_form complain feature EXT-AUTH-19 A Rewrite password recovery to use API EXT-AUTH-21 A Rewrite email verification with API EXT-AUTH-28 A Username is email switch Users will log in using a username, a authority, and a password. The authority is the source for user/password verification. OpenACS can be an authority itself.
Each user in OpenACS will belong to exactly one authority, which can either be the "local" OpenACS users table, in which case the Index: openacs-4/packages/acs-core-docs/www/filename.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/filename.html,v diff -u -N -r1.20 -r1.21 --- openacs-4/packages/acs-core-docs/www/filename.html 5 Nov 2003 14:46:51 -0000 1.20 +++ openacs-4/packages/acs-core-docs/www/filename.html 11 Nov 2003 10:28:27 -0000 1.21 @@ -1,4 +1,4 @@ -
Detailed Design Documentation Template By You
+
Detailed Design Documentation Template By You
NOTE: Some of the sections of this template may not apply to your package, e.g. there may be no user-visible UI elements for a component of the OpenACS Core. Furthermore, it may be easier in some circumstances Index: openacs-4/packages/acs-core-docs/www/for-everyone.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/for-everyone.html,v diff -u -N -r1.12 -r1.13 --- openacs-4/packages/acs-core-docs/www/for-everyone.html 28 Oct 2003 22:07:34 -0000 1.12 +++ openacs-4/packages/acs-core-docs/www/for-everyone.html 11 Nov 2003 10:28:27 -0000 1.13 @@ -1 +1 @@ -
Part�I.�OpenACS For Everyone Table of Contents
Prev Home Next OpenACS Core Documentation Up Chapter�1.�High level information: What is OpenACS?
docs@openacs.orgView comments on this page at openacs.org +Part�I.�OpenACS For Everyone
Prev Home Next OpenACS Core Documentation Up Chapter�1.�High level information: What is OpenACS?
docs@openacs.orgView comments on this page at openacs.org Index: openacs-4/packages/acs-core-docs/www/general-documents.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/general-documents.html,v diff -u -N -r1.12 -r1.13 --- openacs-4/packages/acs-core-docs/www/general-documents.html 28 Oct 2003 22:07:34 -0000 1.12 +++ openacs-4/packages/acs-core-docs/www/general-documents.html 11 Nov 2003 10:28:27 -0000 1.13 @@ -1 +1 @@ -Chapter�1.�High level information: What is OpenACS? Table of Contents
View comments on this page at openacs.org +Chapter�1.�High level information: What is OpenACS? Table of Contents
View comments on this page at openacs.org Index: openacs-4/packages/acs-core-docs/www/groups-design.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/groups-design.html,v diff -u -N -r1.14 -r1.15 --- openacs-4/packages/acs-core-docs/www/groups-design.html 31 Oct 2003 10:54:19 -0000 1.14 +++ openacs-4/packages/acs-core-docs/www/groups-design.html 11 Nov 2003 10:28:27 -0000 1.15 @@ -1,4 +1,4 @@ -OpenACS 4 Groups Design +
OpenACS 4 Groups Design by Rafael H. Schloming and Mark Thomas
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. Index: openacs-4/packages/acs-core-docs/www/groups-requirements.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/groups-requirements.html,v diff -u -N -r1.14 -r1.15 --- openacs-4/packages/acs-core-docs/www/groups-requirements.html 31 Oct 2003 10:54:19 -0000 1.14 +++ openacs-4/packages/acs-core-docs/www/groups-requirements.html 11 Nov 2003 10:28:27 -0000 1.15 @@ -1,4 +1,4 @@ -OpenACS 4 Groups Requirements +
OpenACS 4 Groups Requirements by Rafael H. Schloming, Mark Thomas
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. Index: openacs-4/packages/acs-core-docs/www/i18n-requirements.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/i18n-requirements.html,v diff -u -N -r1.5 -r1.6 --- openacs-4/packages/acs-core-docs/www/i18n-requirements.html 31 Oct 2003 10:54:19 -0000 1.5 +++ openacs-4/packages/acs-core-docs/www/i18n-requirements.html 11 Nov 2003 10:28:27 -0000 1.6 @@ -1,4 +1,4 @@ -OpenACS Internationalization Requirements +
OpenACS Internationalization Requirements by Henry Minsky, Yon Feldman, Lars Pind, Index: openacs-4/packages/acs-core-docs/www/i18n.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/i18n.html,v diff -u -N -r1.11 -r1.12 --- openacs-4/packages/acs-core-docs/www/i18n.html 5 Nov 2003 14:46:51 -0000 1.11 +++ openacs-4/packages/acs-core-docs/www/i18n.html 11 Nov 2003 10:28:27 -0000 1.12 @@ -1,4 +1,4 @@ -
Internationalization +
Internationalization By Peter Marklund and Lars Pind
@@ -38,7 +38,7 @@ which are static and mostly text, it may be easier to create a new ADP page for each language. In this case, the pages are distinguished by a file naming convention. -If the request processor finds a file named filename.locale.adp, where locale matches the user's locale, it will process that file instead of filename.adp. For example, for a user with locale tl_PH, the file index.tl_PH.adp, if found, will be used instead of index.adp. The locale-specific file should thus contain text in the language appropriate for that locale. The code in the page, however, should still be in English. Message keys are still processed.
+
If the request processor finds a file named filename.locale.adp, where locale matches the user's locale, it will process that file instead of filename.adp. For example, for a user with locale tl_PH, the file index.tl_PH.adp, if found, will be used instead of index.adp. The locale-specific file should thus contain text in the language appropriate for that locale. The code in the page, however, should still be in English. Message keys are still processed.
Internationalizing templates is about replacing human readable text in a certain language with internal message keys, which can then be dynamically replaced with real human language in @@ -101,9 +101,9 @@
Here are a couple of examples. Say we have the following two parameters, taken directly from the dotlrn package. -
Table�10.1.�
Parameter Name Parameter Value class_instance_pages_csv #dotlrn.class_page_home_title#,Simple 2-Column;#dotlrn.class_page_calendar_title#,Simple 1-Column;#dotlrn.class_page_file_storage_title#,Simple 1-Column departments_pretty_name #departments_pretty_name# +
Table�10.1.�
Parameter Name Parameter Value class_instance_pages_csv #dotlrn.class_page_home_title#,Simple 2-Column;#dotlrn.class_page_calendar_title#,Simple 1-Column;#dotlrn.class_page_file_storage_title#,Simple 1-Column departments_pretty_name #departments_pretty_name# Then, depending on how we retrieve the value, here's what we get: -
Table�10.2.�
Command used to retrieve Value Retrieved Value parameter::get -localize -parameter class_instances_pages_csv Kurs Startseite,Simple 2-Column;Kalender,Simple 1-Column;Dateien,Simple 1-Column parameter::get -localize -parameter departments_pretty_name Abteilung parameter::get -parameter departments_pretty_name #departments_pretty_name# +
Table�10.2.�
Command used to retrieve Value Retrieved Value parameter::get -localize -parameter class_instances_pages_csv Kurs Startseite,Simple 2-Column;Kalender,Simple 1-Column;Dateien,Simple 1-Column parameter::get -localize -parameter departments_pretty_name Abteilung parameter::get -parameter departments_pretty_name #departments_pretty_name# The value in the rightmost column in the table above is the value returned by an invocation of parameter::get. Note that for localization to happen you must use the -localize flag. @@ -151,7 +151,7 @@ Use the *_pretty version in your ADP page.
To internationalize numbers, use lc_numeric $value, which formats the number using the appropriate decimal point and thousand separator for the locale. -
When coding forms, remember to use message keys for each piece of text that is user-visible, including form option labels and button labels.
When coding forms, remember to use message keys for each piece of text that is user-visible, including form option labels and button labels.
Acs-lang includes tools to automate some internationalization. From /acs-admin/apm/, select a package and then click on @@ -240,9 +240,9 @@ with the appropriate notation for the type of file, and store the text in the message catalog. You need to run the process twice, once for ADP files, and once for Tcl files. -
Find datetime in .xql files. Use command line tools to find suspect SQL code:
grep -r "to_char.*H" * +
Find datetime in .xql files. Use command line tools to find suspect SQL code:
grep -r "to_char.*H" * grep -r "to_date.*H" *In SQL statements, replace the format string with the ANSI standard format, YYYY-MM-DD HH24:MI:SS and change the field name to *_ansi so that it cannot be confused with previous, improperly formatting fields. For example,
to_char(timestamp,'MM/DD/YYYY HH:MI:SS') as foo_date_prettybecomes
to_char(timestamp,'YYYY-MM-DD HH24:MI:SS') as foo_date_ansiIn TCL files where the date fields are used, convert the datetime from local server timezone, which is how it's stored in the database, to the user's timezone for display. Do this with the localizing function lc_time_system_to_conn:
set foo_date_ansi [lc_time_system_to_conn $foo_date_ansi]When a datetime will be written to the database, first convert it from the user's local time to the server's timezone with lc_time_conn_to_system. Index: openacs-4/packages/acs-core-docs/www/index.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/index.html,v diff -u -N -r1.20 -r1.21 --- openacs-4/packages/acs-core-docs/www/index.html 5 Nov 2003 14:46:51 -0000 1.20 +++ openacs-4/packages/acs-core-docs/www/index.html 11 Nov 2003 10:28:27 -0000 1.21 @@ -1 +1 @@ -
OpenACS Core Documentation Table of Contents
- I. OpenACS For Everyone
- II. Administrator's Guide
- III. For OpenACS Package Developers
- 7. Development Tutorial
- 8. Development Reference
- OpenACS 5.0.0a4 Packages
- OpenACS Data Models and the Object System
- The Request Processor
- The OpenACS Database Access API
- Using Templates in OpenACS 5.0.0a4
- Groups, Context, Permissions
- Writing OpenACS 5.0.0a4 Application Pages
- Parties in OpenACS 5.0.0a4
- OpenACS 4.x Permissions Tediously Explained
- Object Identity
- Programming with AOLserver
- 9. Engineering Standards
- D. Using CVS with an OpenACS Site
- E. How to package and release OpenACS
- IV. For OpenACS Platform Developers
- Platform Development
- 10. Kernel Documentation
- Overview
- OpenACS 4 Object Model Requirements
- OpenACS 4 Object Model Design
- OpenACS 4 Permissions Requirements
- OpenACS 4 Permissions Design
- OpenACS 4 Groups Requirements
- OpenACS 4 Groups Design
- OpenACS 4 Subsites Requirements
- OpenACS 4 Subsites Design Document
- OpenACS 5.0.0a4 Package Manager Requirements
- OpenACS 5.0.0a4 Package Manager Design
- Database Access API
- OpenACS Internationalization Requirements
- Internationalization
- OpenACS 4 Security Requirements
- OpenACS 4 Security Design
- OpenACS 4 Security Notes
- OpenACS 4 Request Processor Requirements
- OpenACS 4 Request Processor Design
- Documenting Tcl Files: Page Contracts and Libraries
- Bootstrapping OpenACS
- External Authentication Requirements
List of Figures
View comments on this page at openacs.org +OpenACS Core Documentation Table of Contents
- I. OpenACS For Everyone
- II. Administrator's Guide
- III. For OpenACS Package Developers
- 7. Development Tutorial
- 8. Development Reference
- OpenACS 5.0.0a4 Packages
- OpenACS Data Models and the Object System
- The Request Processor
- The OpenACS Database Access API
- Using Templates in OpenACS 5.0.0a4
- Groups, Context, Permissions
- Writing OpenACS 5.0.0a4 Application Pages
- Parties in OpenACS 5.0.0a4
- OpenACS 4.x Permissions Tediously Explained
- Object Identity
- Programming with AOLserver
- 9. Engineering Standards
- D. Using CVS with an OpenACS Site
- E. How to package and release OpenACS
- IV. For OpenACS Platform Developers
- Platform Development
- 10. Kernel Documentation
- Overview
- OpenACS 4 Object Model Requirements
- OpenACS 4 Object Model Design
- OpenACS 4 Permissions Requirements
- OpenACS 4 Permissions Design
- OpenACS 4 Groups Requirements
- OpenACS 4 Groups Design
- OpenACS 4 Subsites Requirements
- OpenACS 4 Subsites Design Document
- OpenACS 5.0.0a4 Package Manager Requirements
- OpenACS 5.0.0a4 Package Manager Design
- Database Access API
- OpenACS Internationalization Requirements
- Internationalization
- OpenACS 4 Security Requirements
- OpenACS 4 Security Design
- OpenACS 4 Security Notes
- OpenACS 4 Request Processor Requirements
- OpenACS 4 Request Processor Design
- Documenting Tcl Files: Page Contracts and Libraries
- Bootstrapping OpenACS
- External Authentication Requirements
List of Figures
View comments on this page at openacs.org Index: openacs-4/packages/acs-core-docs/www/individual-programs.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/individual-programs.html,v diff -u -N -r1.11 -r1.12 --- openacs-4/packages/acs-core-docs/www/individual-programs.html 5 Nov 2003 11:48:10 -0000 1.11 +++ openacs-4/packages/acs-core-docs/www/individual-programs.html 11 Nov 2003 10:28:27 -0000 1.12 @@ -1,4 +1,4 @@ -Prerequisite Software +
Prerequisite Software by Joel Aufrecht
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. @@ -17,7 +17,7 @@ standard Linux shell. If you are using a different shell, you will need to substitute your shell's conventions for setting environment variables when - appropriate.Mac OS X.�Section�, “OpenACS Installation Guide for Mac OS X”
Windows/VMWare.�Section�, “OpenACS Installation Guide for Windows2000” The only + appropriate.
Mac OS X.�the section called “OpenACS Installation Guide for Mac OS X”
Windows/VMWare.�the section called “OpenACS Installation Guide for Windows2000” The only way to run OpenACS on Windows is through the VMWare emulator. (Please let me know if you have OpenACS running directly in Windows.)
Build Environment.�The Reference Platform installation compiles most programs from Index: openacs-4/packages/acs-core-docs/www/install-cvs.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-cvs.html,v diff -u -N -r1.11 -r1.12 --- openacs-4/packages/acs-core-docs/www/install-cvs.html 5 Nov 2003 14:46:51 -0000 1.11 +++ openacs-4/packages/acs-core-docs/www/install-cvs.html 11 Nov 2003 10:28:27 -0000 1.12 @@ -1,4 +1,4 @@ -
Initialize CVS (OPTIONAL) CVS is a source control system. Create and initialize a +
Initialize CVS (OPTIONAL) CVS is a source control system. Create and initialize a directory for a local cvs repository.
[root@yourserver tmp]# mkdir /cvsroot [root@yourserver tmp]# cvs -d /cvsroot init [root@yourserver tmp]# Index: openacs-4/packages/acs-core-docs/www/install-daemontools.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-daemontools.html,v diff -u -N -r1.11 -r1.12 --- openacs-4/packages/acs-core-docs/www/install-daemontools.html 5 Nov 2003 14:46:51 -0000 1.11 +++ openacs-4/packages/acs-core-docs/www/install-daemontools.html 11 Nov 2003 10:28:27 -0000 1.12 @@ -1,16 +1,16 @@ -Install Daemontools (OPTIONAL) Daemontools is a collection of programs for controlling +
Install Daemontools (OPTIONAL) Daemontools is a collection of programs for controlling other processes. We use daemontools to run and monitor AOLServer. It is installed in /package. These commands install daemontools and svgroup. svgroup is a script for granting permissions, to allow users other than root to use daemontools for specific - services.
Install Daemontools
download daemontools and install it.
Red Hat 8
[root@yourserver root]# mkdir -p /package + services.
Install Daemontools
download daemontools and install it.
Red Hat 8
[root@yourserver root]# mkdir -p /package [root@yourserver root]# chmod 1755 /package/ [root@yourserver root]# cd /package/ [root@yourserver package]# tar xzf /tmp/daemontools-0.76.tar.gz [root@yourserver package]# cd admin/daemontools-0.76/ [root@yourserver daemontools-0.76]# package/install Linking ./src/* into ./compile... -(many lines omitted) + Creating /service... Adding svscanboot to inittab... init should start svscan now. @@ -42,8 +42,7 @@ [root@yourserver admin]# cd daemontools-0.76 [root@yourserver daemontools-0.76]# patch -p1 < ../daemontools-0.76.errno.patch [root@yourserver daemontools-0.76]# package/install -Linking ./src/* into ./compile... -(many lines omitted) +Linking ./src/* into ./compile...(many lines omitted) Creating /service... Adding svscanboot to inittab... init should start svscan now. Index: openacs-4/packages/acs-core-docs/www/install-full-text-search.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/Attic/install-full-text-search.html,v diff -u -N -r1.10 -r1.11 --- openacs-4/packages/acs-core-docs/www/install-full-text-search.html 5 Nov 2003 11:48:10 -0000 1.10 +++ openacs-4/packages/acs-core-docs/www/install-full-text-search.html 11 Nov 2003 10:28:27 -0000 1.11 @@ -1,12 +1,11 @@ -Install Full Text Search If you want full text search, and you are running PostGreSQL, install this module to support FTS. Do this step after you have installed both PostGreSQL and +
Install Full Text Search If you want full text search, and you are running PostGreSQL, install this module to support FTS. Do this step after you have installed both PostGreSQL and Aolserver. You will need the openfts tarball in /tmp.
Install Tsearch. This is a PostGreSQL module that OpenFTS requires.
[root@yourserver root]# su - postgres [postgres@yourserver pgsql]$ cd /usr/local/src/postgresql-7.2.4/contrib/tsearch/ [postgres@yourserver tsearch]$ make sed 's,MODULE_PATHNAME,$libdir/tsearch,g' tsearch.sql.in >tsearch.sql -/usr/bin/flex -8 -Ptsearch_yy -o'parser.c' parser.l -(many lines omitted) +/usr/bin/flex -8 -Ptsearch_yy -o'parser.c' parser.l(many lines omitted) rm -f libtsearch.so ln -s libtsearch.so.0.0 libtsearch.so [postgres@yourserver tsearch]$ make install @@ -74,7 +73,7 @@ make su postgres make install -exit
If you are installing Full Text Search, add required packages to the new database. (In order for full text search to work, you must also install the PostGreSQL OpenFTS module and prerequisites.)
[service0@yourserver service0]$ /usr/local/pgsql/bin/psql service0 -f /usr/local/src/postgresql-7.2.4/contrib/tsearch/tsearch.sql Index: openacs-4/packages/acs-core-docs/www/install-more-software.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-more-software.html,v diff -u -N -r1.5 -r1.6 --- openacs-4/packages/acs-core-docs/www/install-more-software.html 5 Nov 2003 11:48:10 -0000 1.5 +++ openacs-4/packages/acs-core-docs/www/install-more-software.html 11 Nov 2003 10:28:27 -0000 1.6 @@ -1,4 +1,4 @@ -Appendix�B.�Install additional supporting software Table of Contents
+
Appendix�B.�Install additional supporting software Table of Contents
by Joel Aufrecht
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. Index: openacs-4/packages/acs-core-docs/www/install-nsopenssl.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-nsopenssl.html,v diff -u -N -r1.6 -r1.7 --- openacs-4/packages/acs-core-docs/www/install-nsopenssl.html 5 Nov 2003 11:48:10 -0000 1.6 +++ openacs-4/packages/acs-core-docs/www/install-nsopenssl.html 11 Nov 2003 10:28:27 -0000 1.7 @@ -1,4 +1,4 @@ -Install nsopenssl This AOLserver module is required if you want people to connect to your site via +
Install nsopenssl This AOLserver module is required if you want people to connect to your site via https. These commands compile nsopenssl and install it, along with a tcl helper script to handle https connections. You will also need ssl certificates. Because those should @@ -19,8 +19,7 @@ [root@yourserver nsopenssl-2.1]# cp https.tcl /usr/local/aolserver/modules/tcl/ [root@yourserver nsopenssl-2.1]#
cd /usr/local/src/aolserver -wget --passive -http://www.scottg.net/download/nsopenssl-2.1.tar.gz +wget --passive http://www.scottg.net/download/nsopenssl-2.1.tar.gz tar xzf nsopenssl-2.1.tar.gz cd nsopenssl-2.1 make OPENSSL=/usr/local/ssl Index: openacs-4/packages/acs-core-docs/www/install-nspam.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-nspam.html,v diff -u -N -r1.1 -r1.2 --- openacs-4/packages/acs-core-docs/www/install-nspam.html 28 Oct 2003 22:18:46 -0000 1.1 +++ openacs-4/packages/acs-core-docs/www/install-nspam.html 11 Nov 2003 10:28:27 -0000 1.2 @@ -1 +1 @@ -
Install nspam View comments on this page at openacs.org +Install nspam View comments on this page at openacs.org Index: openacs-4/packages/acs-core-docs/www/install-origins.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-origins.html,v diff -u -N -r1.1 -r1.2 --- openacs-4/packages/acs-core-docs/www/install-origins.html 28 Oct 2003 22:18:46 -0000 1.1 +++ openacs-4/packages/acs-core-docs/www/install-origins.html 11 Nov 2003 10:28:27 -0000 1.2 @@ -1,4 +1,4 @@ -Where did this document come from? +
Where did this document come from? This document was created by Vinod Kurup, but it's really just plagiarism from a number of documents that came before it. If I've used something that you've written without proper credit, let me Index: openacs-4/packages/acs-core-docs/www/install-overview.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-overview.html,v diff -u -N -r1.17 -r1.18 --- openacs-4/packages/acs-core-docs/www/install-overview.html 5 Nov 2003 11:48:10 -0000 1.17 +++ openacs-4/packages/acs-core-docs/www/install-overview.html 11 Nov 2003 10:28:27 -0000 1.18 @@ -1,4 +1,4 @@ -
Chapter�2.�Installation Overview Table of Contents
+
Chapter�2.�Installation Overview Table of Contents
by Vinod Kurup
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. Index: openacs-4/packages/acs-core-docs/www/install-qmail.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-qmail.html,v diff -u -N -r1.11 -r1.12 --- openacs-4/packages/acs-core-docs/www/install-qmail.html 5 Nov 2003 14:46:51 -0000 1.11 +++ openacs-4/packages/acs-core-docs/www/install-qmail.html 11 Nov 2003 10:28:27 -0000 1.12 @@ -1,4 +1,4 @@ -Install qmail (OPTIONAL) Qmail is a Mail Transfer Agent. It handles incoming and +
Install qmail (OPTIONAL) Qmail is a Mail Transfer Agent. It handles incoming and outgoing mail. Install qmail if you want your OpenACS server to send and receive mail, and you don't want to use an alternate MTA.
Red Hat 9: all djb tools (qmail, daemontools, ucspi) will @@ -14,8 +14,7 @@ cd ..
All platforms continue:
[root@yourserver src]# cd ucspi-tcp-0.88 [root@yourserver ucspi-tcp-0.88]# make ( cat warn-auto.sh; \ -echo 'main="$1"; shift'; \ -(many lines omitted) +echo 'main="$1"; shift'; \(many lines omitted) ./compile instcheck.c ./load instcheck hier.o auto_home.o unix.a byte.a [root@yourserver ucspi-tcp-0.88]# make setup check @@ -30,7 +29,7 @@ tcpserver: usage: tcpserver [ -1UXpPhHrRoOdDqQv ] [ -c limit ] [ -x rules.cdb ] [ -B banner ] [ -g gid ] [ -u uid ] [ -b backlog ] [ -l localname ] [ -t timeout ] host port program [root@yourserver ucspi-tcp-0.88]# -
(I'm not sure if this next step is 100% necessary, but when I skip it I get problems. If you get the error 553 sorry, that domain isn't in my list of allowed rcpthosts (#5.7.1) then you need to do this.) AOLServer sends outgoing mail via the ns_sendmail command, which pipes a command to the sendmail executable. Or, in our @@ -44,7 +43,7 @@ send outgoing mail.
[root@yourserver ucspi-tcp-0.88]# cp /tmp/openacs-5.0.0a4/packages/acs-core-docs/www/files/tcp.smtp.txt /etc/tcp.smtp [root@yourserver ucspi-tcp-0.88]# tcprules /etc/tcp.smtp.cdb /etc/tcp.smtp.tmp < /etc/tcp.smtpcp /tmp/openacs-5.0.0a4/packages/acs-core-docs/www/files/tcp.smtp.txt /etc/tcp.smtp -tcprules /etc/tcp.smtp.cdb /etc/tcp.smtp.tmp < /etc/tcp.smtp
Download qmail, +tcprules /etc/tcp.smtp.cdb /etc/tcp.smtp.tmp < /etc/tcp.smtp
Download qmail, set up the standard supporting users and build the binaries:
[root@yourserver root]# cd /usr/local/src [root@yourserver src]# wget http://www.qmail.org/netqmail-1.04.tar.gz [root@yourserver src]# tar xzf netqmail-1.04.tar.gz @@ -84,8 +83,7 @@ [root@yourserver netqmail-1.04]# cd netqmail-1.04 [root@yourserver netqmail-1.04]# make setup check ( cat warn-auto.sh; \ -echo CC=\'`head -1 conf-cc`\'; \ -(many lines omitted) +echo CC=\'`head -1 conf-cc`\'; \(many lines omitted) ./install ./instcheckcd /usr/local/src @@ -104,7 +102,7 @@ cd netqmail-1.04 ./collate.sh cd netqmail-1.04 -make setup check
Replace sendmail with qmail's wrapper.
[root@yourserver qmail-1.03]# rm -f /usr/bin/sendmail /usr/sbin/sendmail +make setup checkReplace sendmail with qmail's wrapper.
[root@yourserver qmail-1.03]# rm -f /usr/bin/sendmail /usr/sbin/sendmail [root@yourserver qmail-1.03]# ln -s /var/qmail/bin/sendmail /usr/sbin/sendmail [root@yourserver qmail-1.03]#rm -f /usr/bin/sendmail /usr/sbin/sendmail @@ -126,7 +124,7 @@
cd ~alias; touch .qmail-postmaster .qmail-mailer-daemon .qmail-root chmod 644 ~alias/.qmail* /var/qmail/bin/maildirmake ~alias/Maildir/ -chown -R alias.nofiles /var/qmail/alias/Maildir
Configure qmail to use the Maildir delivery format +chown -R alias.nofiles /var/qmail/alias/Maildir
Configure qmail to use the Maildir delivery format (instead of mbox), and install a version of the qmail startup script modified to use Maildir.
[root@yourserver alias]# echo "./Maildir" > /var/qmail/bin/.qmail [root@yourserver alias]# cp /tmp/openacs-5.0.0a4/packages/acs-core-docs/www/files/qmail.rc.txt /var/qmail/rc [root@yourserver alias]# chmod 755 /var/qmail/rc Index: openacs-4/packages/acs-core-docs/www/install-redhat.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-redhat.html,v diff -u -N -r1.12 -r1.13 --- openacs-4/packages/acs-core-docs/www/install-redhat.html 5 Nov 2003 14:46:51 -0000 1.12 +++ openacs-4/packages/acs-core-docs/www/install-redhat.html 11 Nov 2003 10:28:27 -0000 1.13 @@ -1,4 +1,4 @@ -Appendix�A.�Install Red Hat 8/9 +
Appendix�A.�Install Red Hat 8/9 by Joel Aufrecht
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. @@ -27,7 +27,7 @@
Unplug the network cable from your computer. We don't want to connect to the network until we're sure the computer is secure. - + (Wherever you see the word secure, you should always read it as, "secure enough for our purposes, given the amount of work we're @@ -55,7 +55,7 @@ Review (and modify if needed) the partitions created and click Next
On the pop-up window asking "Are you sure you want to do this?" click Yes - IF YOU ARE WIPING YOUR HARD DRIVE.
Click Next on the boot loader screen
Click Next on the boot loader screen
Configure Networking. Again, if you know what you're doing, do this step yourself, being sure to note the firewall holes. Otherwise, follow the instructions in this step to set up a computer directly connected to the internet with a dedicated IP address.
DHCP is a system by which a computer that @@ -76,7 +76,7 @@ Mail (SMTP). In the Other ports box, enter 443, 8000, 8443. Click Next. -Port 443 is for https (http over ssl), and 8000 and 8443 are http and https access to the development server we'll be setting up.
Select any additional languages you want the +Port 443 is for https (http over ssl), and 8000 and 8443 are http and https access to the development server we'll be setting up.
Select any additional languages you want the computer to support and then click Next
Choose your time zone and click Next.
Type in a root password, twice.
On the Package selection page, we're going to @@ -88,9 +88,9 @@ risk that's still screened by the firewall, or a resource hog. Just don't install a database or web server, because that would conflict with the database and web server we'll install later. -
check�Editors�(this�installs�emacs),
+check�Editors�(this�installs�emacs),
click�Details�next�to�Text-based�Internet,�check�lynx,�and�click�OK;
-check�Authoring�and�Publishing�(this�installs�docbook),
+check�Authoring�and�Publishing�(this�installs�docbook),
uncheck�Server�Configuration�Tools,
uncheck�Web�Server,
uncheck�Windows�File�Server,
@@ -105,7 +105,7 @@ Flat View and wait. In a minute, a list of packages will appear.uncheck�apmd�(monitors�power,�not�very�useful�for�servers),�
-check�ImageMagick�(required�for�the�photo-album�packages,�
+check�ImageMagick�(required�for�the�photo-album�packages,�
uncheckisdn4k-utils�(unless�you�are�using�isdn,�this�installs�a�useless�daemon),�
check�mutt�(a�mail�program�that�reads�Maildir),
uncheck�nfs-utils�(nfs�is�a�major�security�risk),�
@@ -143,7 +143,7 @@ kernel and openssl/openssh root exploits, so you should be upgrading all of that. Since you are upgrading the kernel, reboot after this step. -Lock down SSH
Lock down SSH
SSH is the protocol we use to connect securely to the computer (replacing telnet, which is insecure). sshd is the daemon that listens for incoming Index: openacs-4/packages/acs-core-docs/www/install-resources.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-resources.html,v diff -u -N -r1.1 -r1.2 --- openacs-4/packages/acs-core-docs/www/install-resources.html 28 Oct 2003 22:18:46 -0000 1.1 +++ openacs-4/packages/acs-core-docs/www/install-resources.html 11 Nov 2003 10:28:27 -0000 1.2 @@ -1,4 +1,4 @@ -
Resources +
Resources Here are some resources that OpenACS users have found useful.
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 -N -r1.4 -r1.5 --- openacs-4/packages/acs-core-docs/www/install-steps.html 5 Nov 2003 14:46:51 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/install-steps.html 11 Nov 2003 10:28:27 -0000 1.5 @@ -1,6 +1,6 @@ -
Basic Steps +
Basic Steps The basic steps to getting OpenACS up and running are: -
Install an OS (Linux, FreeBSD, OpenBSD, Appendix�A, Install Red Hat 8/9, Section�, “OpenACS Installation Guide for Mac OS X”, Section�, “OpenACS Installation Guide for Windows2000”).
Install a database (Oracle or +
Install an OS (Linux, FreeBSD, OpenBSD, Appendix�A, Install Red Hat 8/9, the section called “OpenACS Installation Guide for Mac OS X”, the section called “OpenACS Installation Guide for Windows2000”).
Install a database (Oracle or PostgreSQL).
Create a unique database and system user. Install the OpenACS tarball, start and AOLserver instance, and use the OpenACS web pages to complete installation @@ -17,7 +17,7 @@ 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. (Section�, “Prerequisite Software”)
+ a mail transport agent. (the section called “Prerequisite Software”)
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 Acquire Oracle section. @@ -38,7 +38,7 @@
su - nsadmin svc -d /service/server1 dropdb server1 -createdb server1
Figure�2.2.�Assumptions in this Chapter
Fully qualified domain name of your server yourserver.test name of administrative access account remadmin OpenACS service 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 +createdb server1 Figure�2.2.�Assumptions in this Chapter
None of these locations are set in stone - they're simply Index: openacs-4/packages/acs-core-docs/www/install-tclwebtest.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-tclwebtest.html,v diff -u -N -r1.2 -r1.3 --- openacs-4/packages/acs-core-docs/www/install-tclwebtest.html 5 Nov 2003 15:37:05 -0000 1.2 +++ openacs-4/packages/acs-core-docs/www/install-tclwebtest.html 11 Nov 2003 10:28:27 -0000 1.3 @@ -1,9 +1,8 @@ -
Install tclwebtest. Download the tclwebtest +
Install tclwebtest. Download the tclwebtest source, unpack it, and put it an appropriate place. As root:
cd /tmp -wget http://prdownloads.sourceforge.net/tclwebtest/tclwebtest-0.3.tar.gz?use_mirror=unc tar xvzf tclwebtest-0.3.tar.gz -mv tclwebtest /usr/local/ +mv tclwebtest-0.3 /usr/local/ ln -s /usr/local/tclwebtest-0.3 /usr/local/tclwebtest ln -s /usr/local/tclwebtest/tclwebtest /usr/local/bin
View comments on this page at openacs.org Index: openacs-4/packages/acs-core-docs/www/kernel-doc.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/kernel-doc.html,v diff -u -N -r1.15 -r1.16 --- openacs-4/packages/acs-core-docs/www/kernel-doc.html 31 Oct 2003 10:54:19 -0000 1.15 +++ openacs-4/packages/acs-core-docs/www/kernel-doc.html 11 Nov 2003 10:28:27 -0000 1.16 @@ -1 +1 @@ -Chapter�10.�Kernel Documentation Table of Contents
- Overview
- OpenACS 4 Object Model Requirements
- OpenACS 4 Object Model Design
- OpenACS 4 Permissions Requirements
- OpenACS 4 Permissions Design
- OpenACS 4 Groups Requirements
- OpenACS 4 Groups Design
- OpenACS 4 Subsites Requirements
- OpenACS 4 Subsites Design Document
- OpenACS 5.0.0a4 Package Manager Requirements
- OpenACS 5.0.0a4 Package Manager Design
- Database Access API
- OpenACS Internationalization Requirements
- Internationalization
- OpenACS 4 Security Requirements
- OpenACS 4 Security Design
- OpenACS 4 Security Notes
- OpenACS 4 Request Processor Requirements
- OpenACS 4 Request Processor Design
- Documenting Tcl Files: Page Contracts and Libraries
- Bootstrapping OpenACS
- External Authentication Requirements
View comments on this page at openacs.org +Chapter�10.�Kernel Documentation Table of Contents
- Overview
- OpenACS 4 Object Model Requirements
- OpenACS 4 Object Model Design
- OpenACS 4 Permissions Requirements
- OpenACS 4 Permissions Design
- OpenACS 4 Groups Requirements
- OpenACS 4 Groups Design
- OpenACS 4 Subsites Requirements
- OpenACS 4 Subsites Design Document
- OpenACS 5.0.0a4 Package Manager Requirements
- OpenACS 5.0.0a4 Package Manager Design
- Database Access API
- OpenACS Internationalization Requirements
- Internationalization
- OpenACS 4 Security Requirements
- OpenACS 4 Security Design
- OpenACS 4 Security Notes
- OpenACS 4 Request Processor Requirements
- OpenACS 4 Request Processor Design
- Documenting Tcl Files: Page Contracts and Libraries
- Bootstrapping OpenACS
- External Authentication Requirements
View comments on this page at openacs.org Index: openacs-4/packages/acs-core-docs/www/kernel-overview.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/kernel-overview.html,v diff -u -N -r1.11 -r1.12 --- openacs-4/packages/acs-core-docs/www/kernel-overview.html 31 Oct 2003 10:54:19 -0000 1.11 +++ openacs-4/packages/acs-core-docs/www/kernel-overview.html 11 Nov 2003 10:28:27 -0000 1.12 @@ -1,4 +1,4 @@ -Overview
+
Overview
The OpenACS Kernel, which handles system-wide necessities such as metadata, security, users and groups, subsites, and package Index: openacs-4/packages/acs-core-docs/www/ld-id2849650.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/Attic/ld-id2849650.html,v diff -u -N --- /dev/null 1 Jan 1970 00:00:00 -0000 +++ openacs-4/packages/acs-core-docs/www/ld-id2849650.html 11 Nov 2003 10:29:45 -0000 1.1 @@ -0,0 +1 @@ +
Long Description This is an image of the flow in the Request Processor
Index: openacs-4/packages/acs-core-docs/www/ld-id2886798.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/Attic/ld-id2886798.html,v diff -u -N --- /dev/null 1 Jan 1970 00:00:00 -0000 +++ openacs-4/packages/acs-core-docs/www/ld-id2886798.html 11 Nov 2003 10:29:45 -0000 1.1 @@ -0,0 +1 @@ +Long Description OpenACS without APM vs. with APM Index: openacs-4/packages/acs-core-docs/www/mac-installation.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/mac-installation.html,v diff -u -N -r1.15 -r1.16 --- openacs-4/packages/acs-core-docs/www/mac-installation.html 5 Nov 2003 14:46:51 -0000 1.15 +++ openacs-4/packages/acs-core-docs/www/mac-installation.html 11 Nov 2003 10:28:27 -0000 1.16 @@ -1,2 +1,2 @@ -OpenACS Installation Guide for Mac OS X There are several resources for installing on OS X.
An +
OpenACS Installation Guide for Mac OS X There are several resources for installing on OS X.
($Id$)
Prev Home Next OpenACS Installation Guide for Windows2000 Up Chapter�4.�Configuring a New Service
docs@openacs.orgView comments on this page at openacs.org Index: openacs-4/packages/acs-core-docs/www/maintenance-web.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/maintenance-web.html,v diff -u -N -r1.12 -r1.13 --- openacs-4/packages/acs-core-docs/www/maintenance-web.html 5 Nov 2003 14:46:51 -0000 1.12 +++ openacs-4/packages/acs-core-docs/www/maintenance-web.html 11 Nov 2003 10:28:27 -0000 1.13 @@ -1,4 +1,4 @@ -Hosting Web Sites +
Hosting Web Sites by Joel Aufrecht
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. Index: openacs-4/packages/acs-core-docs/www/maintenance.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/Attic/maintenance.html,v diff -u -N -r1.7 -r1.8 --- openacs-4/packages/acs-core-docs/www/maintenance.html 31 Oct 2003 10:54:19 -0000 1.7 +++ openacs-4/packages/acs-core-docs/www/maintenance.html 11 Nov 2003 10:28:27 -0000 1.8 @@ -1 +1 @@ -Chapter�6.�Maintenance Table of Contents
View comments on this page at openacs.org +Chapter�6.�Maintenance Table of Contents
View comments on this page at openacs.org Index: openacs-4/packages/acs-core-docs/www/object-identity.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/object-identity.html,v diff -u -N -r1.20 -r1.21 --- openacs-4/packages/acs-core-docs/www/object-identity.html 5 Nov 2003 14:46:51 -0000 1.20 +++ openacs-4/packages/acs-core-docs/www/object-identity.html 11 Nov 2003 10:28:27 -0000 1.21 @@ -1,4 +1,4 @@ -Object Identity +
Object Identity by Rafael H. Schloming
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. Index: openacs-4/packages/acs-core-docs/www/object-system-design.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/object-system-design.html,v diff -u -N -r1.15 -r1.16 --- openacs-4/packages/acs-core-docs/www/object-system-design.html 31 Oct 2003 10:54:19 -0000 1.15 +++ openacs-4/packages/acs-core-docs/www/object-system-design.html 11 Nov 2003 10:28:27 -0000 1.16 @@ -1,4 +1,4 @@ -OpenACS 4 Object Model Design +
OpenACS 4 Object Model Design by Pete Su, Michael Yoon, Richard Li Index: openacs-4/packages/acs-core-docs/www/object-system-requirements.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/object-system-requirements.html,v diff -u -N -r1.14 -r1.15 --- openacs-4/packages/acs-core-docs/www/object-system-requirements.html 31 Oct 2003 10:54:19 -0000 1.14 +++ openacs-4/packages/acs-core-docs/www/object-system-requirements.html 11 Nov 2003 10:28:27 -0000 1.15 @@ -1,4 +1,4 @@ -
OpenACS 4 Object Model Requirements +
OpenACS 4 Object Model Requirements By Pete Su
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. Index: openacs-4/packages/acs-core-docs/www/objects.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/objects.html,v diff -u -N -r1.21 -r1.22 --- openacs-4/packages/acs-core-docs/www/objects.html 5 Nov 2003 14:46:51 -0000 1.21 +++ openacs-4/packages/acs-core-docs/www/objects.html 11 Nov 2003 10:28:27 -0000 1.22 @@ -1,4 +1,4 @@ -OpenACS Data Models and the Object System +
OpenACS Data Models and the Object System By Pete Su
OpenACS docs are written by the named authors, and may be edited @@ -80,7 +80,7 @@ Fire up your text editor and open the ROOT/packages/notes/sql/oracle/notes-create.sql (ROOT/packages/notes/sql/postgresql/notes-create.sql for the PG version) file created when we created the package. Then, do the following: -+
First, add an entry to the acs_object_types table with the following PL/SQL call:
begin @@ -140,7 +140,7 @@ because the new type note is a subtype of acs_object, it will inherit these attributes, so there is no need for us to define them. -The next thing we do is make a small modification to the data model to reflect the fact that each row in the notes table represents something that is not only an object of type @@ -165,7 +165,7 @@ use the acs_objects table to find objects will transparently find any objects that are instances of any subtype of acs_objects. -
The next step is to define a PL/SQL package for your new type, and write some basic procedures to create and delete objects. Here is a package definition for our new type: @@ -213,7 +213,7 @@ object OBJ was "read only", then any other object that used OBJ as its context would also be "read only" by default. We'll talk about this more later. -
The PL/SQL package body contains the implementations of the procedures defined above. The only subtle thing going on here is that we must use acs_object.new to insert a row into Index: openacs-4/packages/acs-core-docs/www/openacs-overview.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/openacs-overview.html,v diff -u -N -r1.11 -r1.12 --- openacs-4/packages/acs-core-docs/www/openacs-overview.html 31 Oct 2003 10:54:19 -0000 1.11 +++ openacs-4/packages/acs-core-docs/www/openacs-overview.html 11 Nov 2003 10:28:27 -0000 1.12 @@ -1,4 +1,4 @@ -
Overview +
Overview OpenACS (Open Architecture Community System) is an advanced toolkit for building scalable, community-oriented web applications. If you're thinking of building an Index: openacs-4/packages/acs-core-docs/www/openacs-unpack.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/openacs-unpack.html,v diff -u -N -r1.6 -r1.7 --- openacs-4/packages/acs-core-docs/www/openacs-unpack.html 31 Oct 2003 10:54:20 -0000 1.6 +++ openacs-4/packages/acs-core-docs/www/openacs-unpack.html 11 Nov 2003 10:28:27 -0000 1.7 @@ -1,6 +1,17 @@ -
Unpack the OpenACS tarball The OpenACS tarball contains sample configuration files +
Unpack the OpenACS tarball The OpenACS tarball contains sample configuration files for some of the packages listed below. In order to access those files, unpack the tarball now.
[root@yourserver root]# cd /tmp [root@yourserver tmp]# tar xzf openacs-5.0.0a4.tgzcd /tmp -tar xzf openacs-5.0.0a4.tgz
Prev Home Next Appendix�B.�Install additional supporting software Up Initialize CVS (OPTIONAL)
docs@openacs.orgView comments on this page at openacs.org +tar xzf openacs-5.0.0a4.tgzIf you are installing from a different method and just need the configuration files, you can instead get them from CVS:
[root@yourserver root]# cd /tmp +[root@yourserver tmp]# cvs -d :pserver:anonymous@openacs.org:/cvsroot co openacs-4/packages/acs-core-docs/www/files/ +cvs checkout: warning: failed to open /root/.cvspass for reading: No such file or directory +cvs server: Updating openacs-4/packages/acs-core-docs/www/files +U openacs-4/packages/acs-core-docs/www/files/README.TXT +(many lines omitted) +U openacs-4/packages/acs-core-docs/www/files/template-ini.ini +U openacs-4/packages/acs-core-docs/www/files/winnsd.txt +[root@yourserver tmp]# mv openacs-4 openacs-5.0.0a4 +cd /tmp +cvs -d :pserver:anonymous@openacs.org:/cvsroot co openacs-4/packages/acs-core-docs/www/files/ +mv openacs-4 openacs-5.0.0a4
Prev Home Next Appendix�B.�Install additional supporting software Up Initialize CVS (OPTIONAL)
docs@openacs.orgView comments on this page at openacs.org Index: openacs-4/packages/acs-core-docs/www/openacs.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/openacs.html,v diff -u -N -r1.19 -r1.20 --- openacs-4/packages/acs-core-docs/www/openacs.html 5 Nov 2003 15:32:38 -0000 1.19 +++ openacs-4/packages/acs-core-docs/www/openacs.html 11 Nov 2003 10:28:27 -0000 1.20 @@ -1,4 +1,4 @@ -Install OpenACS 5.0.0a4 +
Install OpenACS 5.0.0a4 by Vinod Kurup
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. @@ -38,7 +38,7 @@ [root@yourserver root]# useradd -g service0 -G web service0 -d /home/service0 [root@yourserver root]#Starting with OpenACS 5.0, an experimental script is available to automate all of the steps for the rest of this - section. Requires tclwebtest. If you are not feeling lucky, skip to Section�, “Install from tarball”.
Get the install script from CVS. It is located within + section. Requires tclwebtest. If you are not feeling lucky, skip to the section called “Install from tarball”.
Get the install script from CVS. It is located within the main cvs tree, at /etc/install. Use anonymous CVS checkout to get that directory in the home directory of the service's dedicated user. We put it there so that it is not @@ -57,7 +57,7 @@ /home/service0/install/install.tcl and change the values as documented in the file. It will work unchanged at 127.0.0.1:8000.
Run the file as root.
[service0@yourserver service0]$ exit -[root@yourserver root]# ./home/service0/install/install.sh +[root@yourserver root]# sh /home/service0/install/install.sh /home/service0/install/install.sh: Starting installation with config_file /home/service0/install/install.tcl. Using serverroot=/var/lib/aolserver/ service0, server_url=http://0.0.0.0:8000, do_checkout=yes, do_install=yes, @@ -66,7 +66,7 @@ ./install.sh: Finished (re)installing /var/lib/aolserver/service0 at Wed Nov 5 13:27:17 CET 2003. Access the new site at http://127.0.0.1:8000 with admin username admin@yourserver.test and password 1 -[root@yourserver root]#You can proceed to Section�, “Next Steps”.
You should already have downloaded the OpenACS tarball +[root@yourserver root]#
You can proceed to the section called “Next Steps”.
You should already have downloaded the OpenACS tarball to the /tmp directory. If not, download the OpenACS tarball and save it in @@ -207,7 +207,7 @@ SVRMGR> alter user service0 quota unlimited on service0; SVRMGR> exit;
Your table space is now ready. In case you are trying to delete a - previous OpenACS installation, consult these commands in Section�, “Deleting a tablespace” below. + previous OpenACS installation, consult these commands in the section called “Deleting a tablespace” below.
Make sure that you can login to Oracle using your service_name account:
@@ -222,7 +222,7 @@ You should see today's date in a format 'YYYY-MM-DD.' If you can't login, try redoing step 1 again. If the date is in the wrong format, make sure you followed the steps outlined in - Section�, “Troubleshooting Oracle Dates” + the section called “Troubleshooting Oracle Dates”Prepare PostgreSQL for an OpenACS Service.�
Create a user in the database matching the service name. With default PostGreSQL authentication the name of the user of the process will be matched to this account @@ -239,7 +239,7 @@ CREATE DATABASE [service0@yourserver service0]$
su - service0 -createdb -E UNICODE service0
Automate daily database Vacuuming. This is a process which cleans out discarded data from the database. A quick way to automate vacuuming is to edit the cron file for the database user.
[service0@yourserver service0]$ export EDITOR=emacs;crontab -eAdd this line to the file. The numbers and stars at the beginning are cron columns that specify when the program should be run - in this case, whenever the minute is 0 and the hour is 1, i.e., 1:00 am every day.
0 1 * * * /usr/local/pgsql/bin/vacuumdb --analyze service0
Add Full Text Search Support (OPTIONAL)
[service0@yourserver service0]$ exit +createdb -E UNICODE service0
Automate daily database Vacuuming. This is a process which cleans out discarded data from the database. A quick way to automate vacuuming is to edit the cron file for the database user.
[service0@yourserver service0]$ export EDITOR=emacs;crontab -eAdd this line to the file. The numbers and stars at the beginning are cron columns that specify when the program should be run - in this case, whenever the minute is 0 and the hour is 1, i.e., 1:00 am every day.
0 1 * * * /usr/local/pgsql/bin/vacuumdb --analyze service0
Add Full Text Search Support (OPTIONAL)
[service0@yourserver service0]$ exit logout [root@yourserver root]#Configure an AOLserver Service for OpenACS.�
@@ -249,7 +249,7 @@ need to configure a virtual server. The Reference Platform uses a configuration file included in the OpenACS tarball, /var/lib/aolserver/service0/etc/config.tcl. - Open it in an editor to adjust the parameters.
[root@yourserver root]# su - service0 + Open it in an editor to adjust the parameters.[root@yourserver root]# su - service0 [service0@yourserver service0]$ cd /var/lib/aolserver/service0/etc [service0@yourserver etc]# emacs config.tclIndex: openacs-4/packages/acs-core-docs/www/oracle.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/oracle.html,v diff -u -N -r1.20 -r1.21 --- openacs-4/packages/acs-core-docs/www/oracle.html 5 Nov 2003 14:46:51 -0000 1.20 +++ openacs-4/packages/acs-core-docs/www/oracle.html 11 Nov 2003 10:28:27 -0000 1.21 @@ -1,4 +1,4 @@ -
Install Oracle 8.1.7 +
Install Oracle 8.1.7 by Vinod Kurup
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. @@ -67,7 +67,7 @@ of passwords, we advise you to follow these defaults unless you know what you are doing. Subsequent documents will expect that you used the defaults, so a change made here will necessitate further changes - later. For a guide to the defaults, please see Section�, “Defaults”. + later. For a guide to the defaults, please see the section called “Defaults”.@@ -330,16 +330,16 @@
Note
Some people have had trouble with this step on RedHat 7.3 and 8.0. If so, try the following steps before calling - ./runInstaller: + ./runInstaller:
Execute the following command: - /usr/i386-glibc21-linux/bin/i386-glibc21-linux-env.sh + /usr/i386-glibc21-linux/bin/i386-glibc21-linux-env.sh
- Type export LD_ASSUME_KERNEL=2.2.5 + Type export LD_ASSUME_KERNEL=2.2.5
@@ -363,7 +363,7 @@ logged on as oracle using su - oracle. If so, edit the ~/.bash_profile as you - did in Section�, “Pre-Installation Tasks” + did in the section called “Pre-Installation Tasks”
@@ -568,7 +568,7 @@
Run the script. Switch to the oracle user first to set the environment appropriately and then do - su to get root privileges, while keeping + su to get root privileges, while keeping the oracle user's enviroment.
joeuser:~$ su - oracle @@ -691,7 +691,7 @@ This step will take you through the steps of creating a customized database. Be warned that this process takes about an hour on a Pentium II with 128 MB of RAM. -Note
RedHat 7.3 and 8.0 users: Before running dbassist, do the following.
+
Note
RedHat 7.3 and 8.0 users: Before running dbassist, do the following.
Download the glibc patch from Oracle Technet into /tmp.
@@ -887,7 +887,7 @@
SQL> select sysdate from dual;If you don't see a date that fits the format - YYYY-MM-DD, please read Section�, “Troubleshooting Oracle Dates”. + YYYY-MM-DD, please read the section called “Troubleshooting Oracle Dates”.
At this point we are going to hammer your database with an intense acceptance test. This usually takes around 30 minutes. @@ -912,7 +912,7 @@ pre-existing database. Unfortunately, the only solution is to create a new database with a block size of at least 4096. For instructions on how to - do this, see Section�, “Creating the First Database” above. You + do this, see the section called “Creating the First Database” above. You can set the parameter using the dbassist program or by setting the DB_BLOCK_SIZE parameter in Index: openacs-4/packages/acs-core-docs/www/os-install.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/os-install.html,v diff -u -N -r1.1 -r1.2 --- openacs-4/packages/acs-core-docs/www/os-install.html 28 Oct 2003 22:18:46 -0000 1.1 +++ openacs-4/packages/acs-core-docs/www/os-install.html 11 Nov 2003 10:28:27 -0000 1.2 @@ -1,4 +1,4 @@ -
Linux Install Guides +
Linux Install Guides Here's a list of some helpful documentation for various OS's
Painless Debian Index: openacs-4/packages/acs-core-docs/www/os-security.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/os-security.html,v diff -u -N -r1.1 -r1.2 --- openacs-4/packages/acs-core-docs/www/os-security.html 28 Oct 2003 22:18:46 -0000 1.1 +++ openacs-4/packages/acs-core-docs/www/os-security.html 11 Nov 2003 10:28:27 -0000 1.2 @@ -1,4 +1,4 @@ -
Security Information +
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 Index: openacs-4/packages/acs-core-docs/www/packages.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/packages.html,v diff -u -N -r1.20 -r1.21 --- openacs-4/packages/acs-core-docs/www/packages.html 5 Nov 2003 14:46:51 -0000 1.20 +++ openacs-4/packages/acs-core-docs/www/packages.html 11 Nov 2003 10:28:27 -0000 1.21 @@ -1,4 +1,4 @@ -
OpenACS 5.0.0a4 Packages +
OpenACS 5.0.0a4 Packages By Pete Su and Bryan Quinn
OpenACS docs are written by the named authors, and may be edited Index: openacs-4/packages/acs-core-docs/www/parties.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/parties.html,v diff -u -N -r1.20 -r1.21 --- openacs-4/packages/acs-core-docs/www/parties.html 5 Nov 2003 14:46:51 -0000 1.20 +++ openacs-4/packages/acs-core-docs/www/parties.html 11 Nov 2003 10:28:27 -0000 1.21 @@ -1,4 +1,4 @@ -Parties in OpenACS 5.0.0a4 +
Parties in OpenACS 5.0.0a4 by Rafael H. Schloming
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. Index: openacs-4/packages/acs-core-docs/www/permissions-design.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/permissions-design.html,v diff -u -N -r1.14 -r1.15 --- openacs-4/packages/acs-core-docs/www/permissions-design.html 31 Oct 2003 10:54:20 -0000 1.14 +++ openacs-4/packages/acs-core-docs/www/permissions-design.html 11 Nov 2003 10:28:27 -0000 1.15 @@ -1,4 +1,4 @@ -OpenACS 4 Permissions Design +
OpenACS 4 Permissions Design by John Prevost and Rafael H. Schloming
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. Index: openacs-4/packages/acs-core-docs/www/permissions-requirements.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/permissions-requirements.html,v diff -u -N -r1.14 -r1.15 --- openacs-4/packages/acs-core-docs/www/permissions-requirements.html 31 Oct 2003 10:54:20 -0000 1.14 +++ openacs-4/packages/acs-core-docs/www/permissions-requirements.html 11 Nov 2003 10:28:27 -0000 1.15 @@ -1,4 +1,4 @@ -OpenACS 4 Permissions Requirements