Filtered by category Subsystems Documentation, 1 - 10 of 77 Postings (all
Created by OpenACS community, last modified by Maurizio Martignano 12:51 PM, Friday
OpenACS can be installed as native Win64 applications for Windows 8.1, Windows 10, Windows Server 2012 R2 and Windows Server 2016 TP using the Windows-OpenACS distribution.
The current release is Windows-OpenACS version 3.0.3 (released February 2016).
For more details, http://www.spazioit.com/pages_en/sol_inf_en/windows-openacs_en/ .
Created by Joel Aufrecht, last modified by Gustaf Neumann 29 Jan 2016, at 12:21 PM
OpenACS requires, at a minimum, an operating system, database, and web server to work. Many additional programs, such as a build environment, Mail Transport Agent, and source control system, are also needed for a fully effective installation.
Table 2.2. Version Compatibility Matrix
||tar: no, CVS: Yes
|9.0 - 9.5
The value in the cells correspond to the last version of that release, and not necessarily to all minor releases. Empty cells denote an unknown status.
Created by Gustaf Neumann, last modified by Gustaf Neumann 22 Jan 2016, at 08:41 AM
OpenACS (5.8) works with PostgreSQL 9.1 or newer out of the box, no special configurations in postgresql.conf are needed like with previous versions.
To work with PostgreSQL 9, one has to use an actual postgres driver:
OpenACS core + commonly used packages (search, forums, xowiki, ...) have been tested with PostgreSQL 9.2.4
For new installs, OpenACS 5.8 works without further considerations. When upgrading the database to PostgreSQL 9.*, one has to keep in mind, that not only the sql-install scripts have to be SQL 9.* compatible, but as well the update scripts (migration scripts). During the work for making OpenACS compatible with PostgreSQL 9.*, we did not update (all) of the migration scripts (e.g. kernel upgrades) of earlier versions.
Therefore, the following upgrade steps are recommended:
- For users of PostgreSQL versions earlier than 8.4: In case you run a version of OpenACS earlier than 5.5 then upgrade first your code to OpenACS 5.5 (oacs-5-5 branch from the CVS Repository), then dump your database and reload it into pg 8.4 (e.g. into pg 8.4.17, which is the oldest still supported version from postgres, end-of-life July 2014). Then continue with the next step below.
- For users of PostgreSQL version 8.4 (or newer before 9): Make sure, you are running Tcl 8.5, then get OpenACS 5.8.0 (or newer) and upgrade OpenACS and your used packages (e.g. via acs-admin/apm + "install packages"). Then dump the database and restore it in pg 9.*.
Created by Gustaf Neumann, last modified by Gustaf Neumann 22 Jan 2016, at 08:38 AM
This page describes how to install OpenACS with NaviServer on Unix-like systems (e.g. Linux, Mac OS X, Solaris, OmniOS) by compiling all but PostgreSQL from scratch, guided by script that collects the components from various sources, compiles it, etc.
The installation is done in two steps:
- install-ns.sh : Install NaviServer and its components for a PostgreSQL installation from scratch by obtaining the relevant sources and compiling it. The script assumes PostgreSQL to be installed (or obtainable via package managers), but installs all other components by obtaining it from the source repositories and compiling it from scratch (e.g. Tcl, tcllib, tDOM, libthread, nsf/XOTcl 2).
- install-oacs.sh : Install OpenACS from CVS/git. This script configures a (pre-installed) PostgreSQL installation for
OpenACS, adds hstore, installs OpenACS core, basic OpenACS packages, xowiki, xowf and optionally dotlrn from CVS/git and generates a config file and startup files (for Ubuntu and Fedora Core). The script assumes a pre-existing NaviServer installation, installed e.g. via install-ns.sh
These install scripts are frequently updated when now components are released or problems are detected (commit log ).
If you open the links above, use save-as in the browser to save the files. Alternatively, download the files as .zip file or clone the repository via GitHub .
git clone https://github.com/gustafn/install-ns
The scripts work under a typical Linux installation (e.g. Ubuntu, Fedora Core) as well as on Mac OS X or on OmniOS. The scripts are tested with PostgreSQL 9.1, 9.2, 9.3, 9.4 and 9.5 on Ubuntu 12.04, 13.04, 14.04, Fedora Core 18 and CentOS 7.
On a a fresh Ubuntu installation, you should be able to download the two scripts from this page and install OpenACS with NaviServer in the following steps:
bash install-ns.sh build
bash install-oacs.sh build
After running both scripts in the default configuration you will see e.g. on Ubuntu 14.04
Congratulations, you have installed OpenACS with NaviServer on your machine.
You might start the server manually with
sudo /usr/local/ns/bin/nsd -t /usr/local/ns/config-oacs-5-9.tcl -u nsadmin -g nsadmin
or you can manage your installation with upstart (Ubuntu/Debian). In this case, you might use the following commands
initctl status oacs-5-9
initctl start oacs-5-9
initctl stop oacs-5-9
To use OpenACS, point your browser to http://localhost:8000/ The configuration file is /usr/local/ns/config-oacs-5-9.tcl and might be tailored to your needs. The generated startup file is in /etc/init/oacs-5-9.conf. The access.log and error.log of this instance are in /var/www/oacs-5-9/log
On Fedora, the startup commands for systemd are
systemctl status oacs-5-9
systemctl start oacs-5-9
systemctl stop oacs-5-9
The generated startup file for RedHat/Fedora is in /lib/systemd/system/oacs-5-9.service
Created by Markus Moser, last modified by Markus Moser 13 Jan 2016, at 03:17 PM
Make sure the Arch User Repository is set up correctly. On a fresh installation, follow the instructions as described here: https://wiki.archlinux.org/index.php/yaourt
or, in greater detail, here: https://www.digitalocean.com/community/tutorials/how-to-use-yaourt-to-easily-download-arch-linux-community-packages
Let's start with installing postgres. Theoretically, you could skip this step, since postgres is automatically pulled in as a dependency of openacs. In case anything goes wrong with your postgres installation, OpenACS will run into errors when trying to setup the database after installation.
➤ sudo pacman -S postgresql
Let's start the service and check if it runs correctly.
➤ sudo systemctl start postgresql
➤ sudo systemctl status postgresql
● postgresql.service - PostgreSQL database server
Loaded: loaded (/usr/lib/systemd/system/postgresql.service; disabled; vendor preset: disabled)
Active: active (running) since ....
Now let's install OpenACS.
➤ yaourt -S openacs
After the installation we can start it conveniently with systemd:
➤ sudo systemctl start openacs
➤ sudo systemctl status openacs
Created by OpenACS community, last modified by Markus Moser 13 Jan 2016, at 03:14 PM
There are many ways to get OpenACS working for you quickly and/or easily. See Try OpenACS for demonstrations and hosting solutions.
For platforms like Linux/Ubuntu, Linux/Debian, FreeBSD or Windows, one can use the packaged solutions:
Generic installation scripts
For many Linux platforms (e.g. Ubuntu, Debian, Fedora), one can use the generic installer that compiles all base components (using Naviserver) and creates users/groups as needed; which works with Postgres 9.2 or newer. These install scripts can be as well used on Mac OS X, when MacPorts are installed. These installer scripts are regularly updated.
The following alternative script installs aolserver and the contained modules from sources. It assumes, that PostgreSQL is already installed:
- Install AOLserver: http://openacs.org/storage/view/aolserver/install.tgz
- Install OpenACS: en:openacs-subsystem-install
Manually installing OpenACS:
These are the steps involved in setting up OpenACS. Before beginning, read about ways of getting help (en:docs-admin-help) during installation. Also, read the documentation completely before beginning, to minimize the chance of any surprises during installation.
- Prerequisites to installing OpenACS
- OpenACS reference platform
- Install a *nix based operating system
- Get the code
- Install Oracle
- Install PostgreSQL
- Install Tcl
- Install AOLserver
- Install OpenACS distribution
These pages contain notes where installing OpenACS on a specific OS different from the *nix standard installation instructions (above). These notes also refer to helper scripts and automated installers that can really simplify installation:
Created by OpenACS community, last modified by Gustaf Neumann 22 Dec 2015, at 10:01 AM
OpenACS for developers
Besides the quality components of Openacs (See: en:openacs-system), OpenACS has these enterprise-quality features for developers:
- high-performance XML data processing with easy, powerful Tcl scripting functionality using en:tdom (as of OpenACS version 5.0)
- XOTcl object-oriented scripting, which combines the ideas of scripting and object-orientation in a way that preserves the benefits of both (as of OpenACS verison 5.3)
- Automated testing (see: en:Testing_with_Selenium and en:testing-with-tclwebtest)
- Flexible and easy caching, for improving the performance of your websites. http://openacs.org/doc/tutorial-caching.html
- programming in Tcl with AOLserver - A lightweight, simple, extremely fast scripting language that features a clean, easy-to-understand API (Application Programming Interface) for generating websites from the database. (See: http://openacs.org/doc/programming-with-aolserver.html )
- pooled DB connections (which reduces database connection startup and teardown time), much like the technique JDBC uses, but predating it by many years. (See: http://www.aolserver.com/docs/admin/dbadmin.html#2 )
- Component package system for easy installation and upgrading of packages (See: http://openacs.org/doc/apm-design.html
- Upgrade paths for code and database schemas (See: http://openacs.org/doc/tutorial-upgrade-scripts.html )
- Full internationalization, including an excellent workflow for translating content into new languages. (See: http://openacs.org/doc/i18n.html )
- Fully functional content repository and content management system. (See: http://openacs.org/doc/cms/cms-intro.html )
- An elegant templating system that separates code from presentation of content. (See: http://openacs.org/doc/templates.html )
- An object system that resides on top of the database, permitting site developers to create complex applications using an object API. Examples include an object level permissions system, audit trails, and ability to relate one object to another. (See: http://openacs.org/doc/object-system-requirements.html )
- OpenACS is released as open source under the GPL license, with millions of lines of open-sourced applications available to use as examples. There are also pre-written packages for you to use or adapt.
will be pulling in docs from here: http://openacs.org/doc/acs-package-dev.html and http://openacs.org/doc/acs-plat-dev.html
Integrated Development Environments (IDE)
These text editors are commonly used when coding on OpenACS:
Bibliography and Credits
Created by OpenACS community, last modified by Gustaf Neumann 22 Dec 2015, at 09:59 AM
Tutorials for OpenACS development
Other related tutorials
See also: OpenACS Mentorship Program
Other useful resources
Created by OpenACS community, last modified by Monika Andergassen 04 Dec 2015, at 10:33 AM
This information is deprecated. Please refer to Installing OpenACS on debian.
The quicksheet versions:
You should know what you're doing when you use them.
Tcl development headers are required for compiling Tcl packages yourself.
apt-get install tcl8.4-dev
Should you decide to Install OpenACS from source using general en:openacs-system-install instructions, refer to these notes for changes:
Debian stable user should install PostGreSQL from source as detailed below, or they should use the www.backports.org backport for Postgres to get a more current version. Debian unstable users: the following process has been known to work (but you should double-check that the version of PostGreSQL is 7.3 or above):
For Debian stable users, you can use backports, by adding this line to the /etc/apt/sources.list
deb http://www.backports.org/debian stable bison postgresql openssl openssh tcl8.4 courier debconf spamassassin tla diff patch neon chkrootki
and perform this actions:
apt-get install postgresql postgresql-dev postgresql-doc
ln -s /usr/include/postgresql/ /usr/include/pgsql
ln -s /var/lib/postgres /usr/local/pgsql
ln -s /usr/include/pgsql /usr/local/pgsql/include
su postgres -c "/usr/lib/postgresql/bin/createlang plpgsql template1"
..and proceed to the next section.
Installing PostgreSQL's Tsearch2
apt-get install postgresql-contrib
Creating the Postgres user.
Use adduser instead of useradd. Type man adduser for more info.
On debian woody (stable, 3.0), do:
./configure --without-readline --without-zlib
Set PostgreSQL to start on boot
[root ~]# cp /var/tmp/packages/acs-core-docs/www/files/postgresql.txt /etc/init.d/postgresql
[root ~]# chown root.root /etc/init.d/postgresql
[root ~]# chmod 755 /etc/init.d/postgresql
cp /var/tmp/openacs-5.2.0d1/packages/acs-core-docs/www/files/postgresql.txt /etc/init.d/postgresql
chown root.root /etc/init.d/postgresql
chmod 755 /etc/init.d/postgresql
Test the script
[root ~]# /etc/init.d/postgresql stop
Stopping PostgreSQL: ok
If PostgreSQL successfully stopped, then use the following command to make sure that the script is run appropriately at boot and shutdown.
[root ~]# update-rc.d postgresql defaults
Adding system startup for /etc/init.d/postgresql ...
/etc/rc0.d/K20postgresql -> ../init.d/postgresql
/etc/rc1.d/K20postgresql -> ../init.d/postgresql
/etc/rc6.d/K20postgresql -> ../init.d/postgresql
/etc/rc2.d/S20postgresql -> ../init.d/postgresql
/etc/rc3.d/S20postgresql -> ../init.d/postgresql
/etc/rc4.d/S20postgresql -> ../init.d/postgresql
/etc/rc5.d/S20postgresql -> ../init.d/postgresql
[root ~]# /etc/init.d/postgresql start
Starting PostgreSQL: ok
Debian defaults to starting all services on runlevels 2-5.
You can apt-get install tcl8.4-dev if you have the right version (stable users will need to add tcl8.4 to their sources.list file as described in the "Install Postgresql" section above. You will have to use /usr/lib/tcl8.4/ instead of /usr/local/lib when you try to find the tcl libraries, however.
apt-get install tcl8.4 tcl8.4-dev
and proceed to installing aolserver.
When installing aolserver, replace --with-tcl=/usr/local/lib/ with --with-tcl=/usr/lib/tcl8.4.
To install AOLserver you can use apt command:
apt-get install aolserver4 aolserver4-nscache aolserver4-nspostgres aolserver4-nssha1 tdom
After installing AOLserver, You need to make the following symbolic link:
ln -s /usr/lib/aolserver4 /usr/local/aolserver