Filtered by category Subsystems Documentation, 1 - 10 of 75 Postings (all
Created by Joel Aufrecht, last modified by Gustaf Neumann 19 Aug 2014, at 08:09 PM
OpenACS requires, at a minimum, an operating system, database,
and webserver 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
|7.3.2 - 7.3.x
||tar: no, CVS: Yes
|9.0 - 9.3
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 OpenACS community, last modified by Maurizio Martignano 06 Aug 2014, at 07:53 AM
OpenACS and .LRN can be installed as native Win64 applications for Windows 8, Windows 8.1, Windows Server 2012 and Windows Server 2012 R2 using the Windows-OpenACS distribution.
The current release is Windows-OpenACS version 2.3 (released August 2014).
For more details, http://www.spazioit.com/pages_en/sol_inf_en/windows-openacs_en/ .
Created by Gustaf Neumann, last modified by Gustaf Neumann 28 May 2014, at 08:52 PM
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
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 . 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 and 9.3 on Ubuntu 12.04, 13.04 and Fedora Core 18.
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:
apt-get install postgresql
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 13.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-HEAD.tcl -u nsadmin -g nsadmin
or you can manage your installation with upstart (Ubuntu/Debian). In this case,
you might use the following commands
To use OpenACS, point your browser to http://localhost:8000/
The configuration file is /usr/local/ns/config-oacs-HEAD.tcl
and might be tailored to your needs. The access.log and error.log of
this instance are in /var/www/oacs-HEAD/log
On Fedora, the startup commands for systemd are
systemctl status oacs-HEAD
systemctl start oacs-HEAD
systemctl stop oacs-HEAD
Created by Byron Linares, last modified by Gustaf Neumann 12 Nov 2013, at 11:22 AM
NOTE: Currently (05/2009), the best option to get OpenACS 5.5.* running on Windows is to use the native windows installation Win32-OpenACS by Spazio IT (Maurizio Martignano).
This page describes the installation of:
- OpenACS 5.2.3
- DotLRN 2.2.0
- AOLServer 4.0.beta10_2003
- PostgresSQL 7.4.3
- OpenACS 5.2.3
- DotLrn 2.2.0
Installer Download :
The installer is available in openacs community page.
- OpenACS/dotLRN installer
- OpenACS 5.2.0 installer
Run the "OpenACS/DotLRN Installer" called setup.exe, read the license document before continuing, the installer will ask for some information, this will be used to make the automatic installation.
There are to ways to install the components; manually or automatic
- dotLRN Manual and openACS Manual:
- In this modality the entered personal data in the installer will be omitted and will be necessary to retake the installation from a browser window and enter the necessary data to continue the creation of the data modeling.
- dotLRN Automatic and openACS Automatic
- In this modality the installer its in charge of all the work, when finishing creating the data model the following step would be to reinitiate the service and continue with the use of the platform.
- Source Code:
- The installer will put in the installation folder the source code of the same one.
Select what you want to install and click next. After the installer places all the files, a browser window will be opened and the installation have to be continued from here, if the automatic mode has been selected wait to the installation finishes. When the installation finishes restart the server and type in a web browser "http://localhost"
- OpenACS on the web: access to http://localhost/
- Start Server: Bach file to initiate the server (aolserver, postgresql, cygwim)
- Stop Server: Bach file to stop the server (aolserver, postgresql, cygwin)
- Unistall OpenACS: Uninstall all
- Check if CygWin: Please execute the file server/cygwin/cygwin.bat. You should get a black screen with some green text saying: "yourusername@yourcomputer" and the "$".
- Check PostgreSQL: in the cygwin window typy psql -l , You should get the names of all data base.
- Check AOLServer: ps -alW | grep nsd , You should get some thing like this
- 2312 0 0 2312 ? 0 07:52:20 C:\OpenACS\nsd4\bin\nsd.exe
developed at the Galileo University (www.galileo.edu) by Byron Haroldo Linares Roman email@example.com as part of the E-LANE project (www.e-lane.org)
related forum threads
OpenACS/dotLRN installer for MSWindows
Created by OpenACS community, last modified by Maurizio Martignano 10 Nov 2013, at 08:53 AM
There are many ways to get OpenACS working for you quickly and/or easily. See Try OpenACS for demonstrations, automated installations and hosting solutions.
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 23 Sep 2013, at 08:16 PM
Install a *nix-based operating system (OS)
Follow the installation directions that come with the distribution.
There are generally 2 strategies at this point:
- Install an OS with minimum programs, or
- Install a suite of programs, for example choose between a developer set or desktop set.
We recommend installing only the OS to minimize the chances of conflicts resulting from installing 2 or more copies of one of the OpenACS system components openacs-system.
The impatient reader might want to check out the two scripts at naviserver-openacs which can be used to install OpenACS from scratch on a variety if systems (including Debian/RHEL Linux or Mac OS X), and which lists the detailed dependencies during the build process. Below, we describe in detail the steps.
Many additional programs, such as a build environment (gcc), Mail Transport Agent (MTA), and source control system, are also needed for a fully operational installation. Most of these are included with a basic OS installation.
Install some helper software
You might want to install some of these after a minimum OS install, since OpenACS administration usually assumes you have these (or alternates) installed:
- emacs or vi/vim
- bash shell (usually automatically installed with Linux distributions)
- gcc or equivalent (along with standard distribution source libraries) - if you plan to install software from source.
- ImageMagick - used by some packages for server side image processing
- aspell - used to offer spell checking in forms
*nix install guides
some helpful documentation for installing *nix flavors
*nix-based systems without installing *nix
These DEMOs install a temporary *nix OS on your system:
Or, lease a hosted system with a *nix OS and OpenACS installed on it.
See companies that host OpenACS websites.
Securing your system
Once you get your OS installed, it's imperative that you secure your installation. As Jon Griffin repeatedly warns us, "No distribution is secure out of the box." The Reference Platform implements some basic precautions, but security is a process, not a condition. If you are responsible for a computer hooked to the internet, you are responsible for learning some rudiments of security, such as monitoring the state of a computer, maintaining patch levels, and keeping backups. We recommend these resources:
Created by OpenACS community, last modified by Benjamin Brink 09 Sep 2013, at 07:44 PM
OpenACS for everyone
OpenACS (Open Architecture Community System) is:
- an advanced toolkit for building scalable, community-oriented web applications.
- a robust, scalable framework (see: en:openacs-system) for building dynamic content driven sites and enterprise-level web applications.
- a collection of pre-built applications and services that you can build on to create a custom web-site or application.
- derived from the ArsDigita Community System (ACS). ArsDigita (now part of Red Hat, Inc.) kindly made their work available under the GPL, making all of this possible.
Through a modular architecture, OpenACS has packages for user/groups management, content management, e-commerce, news, FAQs, calendar, forums, bug tracking, wiki (XoWiki ), full-text searching etc. See OpenACS repository.
Use the OpenACS fourms to contact the OpenACS community. We welcome your feedback and can help with your OpenACS endeavors. Commercial support is also available.
What others say about OpenACS
Testimonials posted to forums on OpenACS
History of OpenACS
See: History of OpenACS en:docs-history
Bibliography and Credits
See: Documentation Credits en:doc-credits
Created by OpenACS community, last modified by Jim Lynch 06 Sep 2013, at 12:21 AM
Check suitability of a previously installed TCL.
Start tcl (type tclsh or find it using which tclsh).
[root root]% info exists tcl_platform(threaded)
[root root]% info patchlevel
If the first command returns anything other than 1, then tcl is not threaded. If tcl is threaded and the version is 8.5 or higher, then installing tcl from source is optional.
(jiml) Note that you will also need compiletime stuff so you can build things against that tcl; how to get it varies according to what OS and flavor thereof you run. Personally, I don't like to permit the operating system to dictate any versions of anything or have any influence over installing/removing, so I build the whole stack (these days, not including postgres) myself.
Get TCL 8.5 (or higher). Download and install TCL 8.5 from source.
If you have not installed TCL already, download the latest TCL version from Sourceforge or http://www.tcl.tk/software/tcltk/downloadnow85.html
We are installing tcl in context with aolserver to use a consistent set of libraries when more than one version may be present. Use the same directory for aolserver here, that you will be using when installing aolserver from the en:aolserver-install page.
Remember that you have to be logged in as root to issue the following commands.
[root root]# mkdir -p /usr/local/src/aolserver40r10
[root root]# cd /usr/local/src/aolserver40r10
[root src]# wget http://heanet.dl.sourceforge.net/sourceforge/tcl/tcl8.5.14-src.tar.gz
[root src]# tar xfz tcl8.5.14-src.tar.gz
[root src]# cd tcl8.5.14/unix
[root unix]# ./configure --enable-threads --prefix=/usr/local/aolserver40r10
[root unix]# make install
Pull info from: http://www.tcl.tk/software/tcltk/downloadnow85.html
Created by OpenACS community, last modified by Gustaf Neumann 31 Aug 2013, at 11:37 AM
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
Created by OpenACS community, last modified by Gustaf Neumann 31 Aug 2013, at 11:17 AM
the free, open-source, multithreaded, scalable, Tcl-enabled, web/application server used by some of the world's busiest websites, such as AOL.com, Mapquest.com, Netscape.com, and Moviefone.com. Other sites that run on AOLserver: http://panoptic.com/wiki/aolserver/Sites_That_Run_On_AOLserver
What others say about AOLserver
Using AOLserver with OpenACS
Notes on upgrading AOLserver 4.5.1 ( or greather )
- All the ns_cache* API is from AOLServer 4.5.1 on, part of the core, therefore loading nscache.so in your config file is not longer required. Doing otherwise could lead to syntax errors while doing some calls to the API.