Created by Héctor Romojaro, last modified by Héctor Romojaro 22 Feb 2011, at 12:00 PM
Getting started
Please, review the section on supported distributions first. Currently, the core packages (openacs, dotlrn)
are included into the Universe Ubuntu repository.
Release packages for Ubuntu 10.04 and Further
- Run:
apt-get update
- (optional) Provide for a PostgreSQL environment:
If you don't have a PostgreSQL installation at hand, provide one. You
do not need to care about setting up a concrete data base. This is
automatically done by the openacs and dotlrn post-install instructions.
apt-get install postgresql
If you run a remote PostgreSQL instance, remember to allow for access of the PostgreSQL Administrator (postgres) and the openacs/dotlrn user from the machine hosting your OpenACS/.LRN installation.
- Install the core packages and follow the on-screen instructions:
# OpenACS
apt-get install openacs
... or ...
# .LRN
apt-get install dotlrn
After Install
- (optional) To change IP address and port of the instance, please edit the file:
# OpenACS
/etc/openacs/openacs.sh
# dotLRN
/etc/dotlrn/dotlrn.sh
-
(optional) To control the instance
using daemontools, please install the daemontools ubuntu packages and
follow the instructions on the file:
# OpenACS
/usr/share/doc/openacs/README.daemontools
# dotLRN
/usr/share/doc/dotlrn/README.daemontools
People
Active contributors
- Héctor Romojaro
- Stefan Sobernig
- Avni M. Khatri
- Carl R. Blesius
Created by OpenACS community, last modified by Kenneth Wyrick 04 Jul 2009, at 09:37 PM
The quicksheet versions:
You should know what you're doing when you use them.
notes
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:
Installing Postgresql
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 update
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.
Compiling PostgreSQL
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
[root ~]#
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
[root ~]#
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
[root ~]#
Debian defaults to starting all services on runlevels 2-5.
Installing Tcl
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.
Installing AOLserver
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 Kenneth Wyrick 04 Jul 2009, at 09:37 PM
The quicksheet versions:
You should know what you're doing when you use them.
notes
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:
Installing Postgresql
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 update
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.
Compiling PostgreSQL
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
[root ~]#
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
[root ~]#
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
[root ~]#
Debian defaults to starting all services on runlevels 2-5.
Installing Tcl
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.
Installing AOLserver
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
