OpenACS Core Documentation


Table of Contents

I. OpenACS For Everyone
1. High level information: What is OpenACS?
Overview
OpenACS Release Notes
II. Administrator's Guide
2. Installation Overview
Basic Steps
Prerequisite Software
3. Complete Installation
Install a Unix-like system and supporting software
Install Oracle 8.1.7
Install PostgreSQL
Install OpenACS 5.6.0
OpenACS Installation Guide for Windows2000
OpenACS Installation Guide for Mac OS X
4. Upgrading
Overview
Upgrading 4.5 or higher to 4.6.3
Upgrading OpenACS 4.6.3 to 5.0
Upgrading an OpenACS 5.0.0 or greater installation
Upgrading the OpenACS files
Upgrading Platform components
5. Production Environments
Starting and Stopping an OpenACS instance.
AOLserver keepalive with inittab
Running multiple services on one machine
High Availability/High Performance Configurations
Staged Deployment for Production Networks
Installing SSL Support for an OpenACS service
Set up Log Analysis Reports
External uptime validation
Diagnosing Performance Problems
6. Database Management
Running a PostgreSQL database on another server
Deleting a tablespace
Vacuum Postgres nightly
A. Install Red Hat 8/9
B. Install additional supporting software
Unpack the OpenACS tarball
Initialize CVS (OPTIONAL)
Add PSGML commands to emacs init file (OPTIONAL)
Install Daemontools (OPTIONAL)
Install qmail (OPTIONAL)
Install Analog web file analyzer
Install nspam
Install Full Text Search using Tsearch2
Install Full Text Search using OpenFTS (deprecated see tsearch2)
Install nsopenssl
Install tclwebtest.
Install PHP for use in AOLserver
Install Squirrelmail for use as a webmail system for OpenACS
Install PAM Radius for use as external authentication
Install LDAP for use as external authentication
Install AOLserver 3.3oacs1
III. For OpenACS Package Developers
7. Development Tutorial
Creating an Application Package
Setting Up Database Objects
Creating Web Pages
Debugging and Automated Testing
8. Development Reference
OpenACS Packages
OpenACS Data Models and the Object System
The Request Processor
Using Templates in OpenACS
Groups, Context, Permissions
Writing OpenACS Application Pages
Parties in OpenACS
OpenACS Permissions Tediously Explained
Object Identity
Programming with AOLserver
9. Engineering Standards
OpenACS Style Guide
CVS Guidelines
Release Version Numbering
Constraint naming standard
ACS File Naming and Formatting Standards
PL/SQL Standards
Variables
Automated Testing
10. Documentation Standards
OpenACS Documentation Guide
Using PSGML mode in Emacs
Using nXML mode in Emacs
Detailed Design Documentation Template
System/Application Requirements Template
11. Internationalization
Internationalization and Localization Overview
How Internationalization/Localization works in OpenACS
How to Internationalize a Package
Design Notes
Translator's Guide
IV. For OpenACS Platform Developers
12. Kernel Documentation
Overview
Object Model Requirements
Object Model Design
Permissions Requirements
Permissions Design
Groups Requirements
Groups Design
Subsites Requirements
Subsites Design Document
Package Manager Requirements
Package Manager Design
Database Access API
Security Requirements
Security Design
Request Processor Requirements
Request Processor Design
Documenting Tcl Files: Page Contracts and Libraries
Bootstrapping OpenACS
External Authentication Requirements
13. Releasing OpenACS
OpenACS Core and .LRN
How to Update the OpenACS.org repository
How to package and release an OpenACS Package
How to Update the translations
Index

List of Figures

4.1. Upgrading with the APM
4.2. Upgrading a local CVS repository
5.1. Multiple-server configuration
5.2. Simple A/B Deployment - Step 1
5.3. Simple A/B Deployment - Step 2
5.4. Simple A/B Deployment - Step 3
5.5. Complex A/B Deployment - Step 1
5.6. Complex A/B Deployment - Step 2
5.7. Complex A/B Deployment - Step 3
5.8. Query Analysis example
7.1. Assumptions in this section
7.2. Tutorial Data Model
7.3. The Database Creation Script
7.4. Database Deletion Script
7.5. Page Map
8.1. Server file layout diagram
8.2. Package file layout diagram

List of Tables

2.1. Default directories for a standard install
2.2. Version Compatibility Matrix
4.1. Assumptions in this section
5.1. How it Works
8.1. Package files
8.2. Context Hierarchy Example
8.3. acs_objects example data
11.1. Internationalization and Localization Overview

List of Examples

9.1. Getting datetime from the database ANSI-style
View comments on this page at openacs.org