Filtered by category Subsystems Documentation, 11 - 20 of 86 Postings (
all,
summary)
Created by Gustaf Neumann, last modified by Gustaf Neumann 03 Sep 2021, at 12:00 PM
Wiki pages for the packages available in the OpenACS code repository:
List of the actively maintained packages
In the oacs-5-10 channel, currently 93 packages are actively maintained. Additionally, the packages is use on openacs.org are maintained as well, but not necessarily recommended for new installations. The packages in the main branch are in different states, some of these work perfecty, some of these migh use outdated calls an can be seen as starting points for new projects.
Packages in the oacs-5-9 channel.
Packages in the oacs-5-10 channel.
Created by Byron Linares, last modified by Gustaf Neumann 26 May 2021, at 12:32 PM
This page is obsolete and kept as a reference.
The how-to for a well maintained Windows installation is here.
OpenACS/dotLRN windows installer how to
Required software:
Download
Installer Sources:
The installer source consists in a main Inno Setup script “installer.iss” and could be found in cvs or obtained with the installer.
Other files:
There are some necessary file numbers in order to build the installer.
- tcl\bintallerw.tcl: the AOLserver configuration script
- Install.xml: this XML file control the packages installed by the OpenAcs installer
- tcl\Windows-procs.tcl: This file includes various hacks to make OpenACS work on Windows.Replaces the TCL exec command on Windows, allowing exec to be called with unix-y arguments.Index.tcl : file used for automatic installation.
- Index-org.tcl: file used for manual installation.
- Installer.tcl: file used in automatic installation.
- Installer-org.tcl: file used in manual installation.
- Stara.bat, stop.bat: batch files for starting and stopping all services.
- Tools/setx.exe, tools/reg.exe ,/tools/uzip.exe, /tools/reg.exe Windows command line tools necessary for the installation process.
- AOLserver_4-0-beta-10_2003-08-04.zip: AOLServer
- cygwin.zip: CygWin Unix environment for Windows. Cygwin.zip also contains the PostgreSQL database
- cygwin.bat: file to launch cygwin unix environment console.
- license_en.txt: license text file.
- important.txt: extra info text file.
- Note.txt : especial notes text file.
Download Resources
Building the installer:
- In order to build this installer we need to place all the resources in a folder.
- Create tools and tcl folders with the files before mentioned.
- Download OpenACS, dotLRN and all desired package and place in a folder and named “oacs-dotlrn”
- Open the file installer.iss and generate the installer.
The installer.iss has to important parts:
[Files] section:
In this section are listed all the sources for the installer, in this part you
Can change or add any source that you want.
[Run] section:
In this section is where all commands are executed, like the cygwin installation, postgreSQL installation and AOLserver.
[Code] section:
Section for define procedures or functions to work around the installation.
These are the main sections in the “installer.iss” script. And the sections that have to be changed form personalize the installer.
developed at the Galileo University (www.galileo.edu) by Byron Haroldo Linares Roman bhlr@galileo.edu as part of the E-LANE project (www.e-lane.org)
Instructions on using the installer are at:
Created by David Arroyo Menéndez, last modified by Gustaf Neumann 26 May 2021, at 12:20 PM
This page is mostly obsolete. There are now Debian packages for all OpenACS requirements, and OpenACS (.LRN) itself, and a fairly general installer from scratch naviserver-openacs.
See The debian wiki page
The rest of this page is superseded by the debian wiki page.
You can also use the en:OpenACSDebianInstallGuide quicksheet.
Install tcl 8.4
apt-get install tcl8.4 tcl8.4-dev tcl8.4-doc
Install PostgreSQL 8.2
(from ubuntu repository or debian etch) for PG 8.2 I had to add this line to the /etc/apt/sources.list (under debian etch)
deb http://www.backports.org/debian etch-backports main contrib non-free
Install with apt
apt-get install postgresql-8.2 postgresql-client postgresql-dev postgresql-doc
under debian-etch I did this to avoid downloading some 7.4-packages
apt-get install postgresql-8.2 postgresql-client-8.2 postgresql-dev postgresql-doc-8.2
Config the postgresql 8.x
from How_to_install_in_Postgres_8.x
/etc/postgresql/8.2/main/postgresql.conf
add_missing_from = on
regex_flavor = extended
default_with_oids = on
On debian you could need to change the postgresql port number to 5432, see /etc/postgresql/8.2/main/postgresql.conf
Create the database
su postgres -c "/usr/lib/postgresql/8.2/bin/createlang plpgsql template1"
su postgres -c "createuser service"
Shall the new user be allowed to create
databases? (y/n) y
Shall the new user be allowed to create
more new users? (y/n) y
CREATE USER
su postgres -c "createdb -E UNICODE service"
Install AOLserver
(AOLserver 4.5 for now only from debian unstable)
# Note: on ubuntu maybe more better install AOLserver 4.0 and you can download it from debian stable
- Add the next lines to /etc/apt/sources.list
deb http://http.us.debian.org/debian stable main contrib non-free
deb http://non-us.debian.org/debian-non-US stable/non-US main contrib non-free
deb http://security.debian.org stable/updates main contrib non-free
- Update
apt-get update
# If you have any trouble with gpg keys, then you must read: http://www.davidam.com/debian/debian-gpg
- Install wit apt
apt-get install -t unstable aolserver4 aolserver4-nscache aolserver4-nsopenssl aolserver4-nspostgres aolserver4-nssha1 aolserver4-dev aolserver4-doc daemontools-installer cvs
*note: unpack the https.gz from aolserver4-nsopenssl and copy it over to the tcl directory of aolserver4, if not the api with https such as ns_httpspost will not be available.
https.gz is normally found at /usr/share/doc/aolserver4-nsopenssl/examples/
The tcl directory for aolserver4 is normally found at /usr/lib/aolserver4/modules/tcl/
- Install tdom from cvs
# Sometimes cvs.tdom.org is down, if you have problems you can download with
wget http://cognovis.de/file-storage/view/aolserver45.tar.bz2
cd /usr/lib/aolserver4
sudo ln -s /usr/include/aolserver4 include
mkdir /usr/local/src/aolserver4
cd /usr/local/src/aolserver4
sudo cvs -z3 -d:pserver:anonymous@cvs.tdom.org:/usr/local/pubcvs co tdom
cd tdom/unix
../configure --enable-threads --disable-tdomalloc --with-aolserver=/usr/lib/aolserver4 --prefix=/usr/lib/aolserver4 --with-tcl=/usr/lib/tcl8.4
sudo make install
- Install XOTcl
cd /usr/local/src
sudo wget http://media.wu-wien.ac.at/download/xotcl-1.6.7.tar.gz
sudo tar xvfz xotcl-1.6.7.tar.gz
cd xotcl-1.6.7/
export CC=gcc
sudo ./configure --enable-threads --enable-symbols --prefix=/usr/lib/aolserver4 --exec-prefix=/usr/lib/aolserver4 --with-tcl=/usr/lib/tcl8.4
sudo make
sudo make install-aol
- Install TclLib
cd /usr/local/src
sudo wget http://kent.dl.sourceforge.net/sourceforge/tcllib/tcllib-1.10.tar.gz
sudo tar xvzf tcllib-1.10.tar.gz
cd tcllib-1.10
sudo ./configure --prefix=/usr/lib/aolserver4
sudo make install
Download and config OpenACS 5.4
- Create the directory where we can install OpenACS
adduser service
su - service
mkdir aolserver
cd aolserver
- Copy the two config files aolserver.nsadmin and nsadmin.tcl there:
wget http://www.davidam.com/debian/aolserver.nsadmin
wget http://www.davidam.com/debian/nsadmin.tcl
- Change nsadmin to service
mv aolserver.nsadmin aolserver.service
mv nsadmin.tcl service.tcl
sed -i "s/nsadmin/service/g" aolserver.service service.tcl
- Download OpenACS from cvs
cvs -z3 -d :pserver:anonymous@cvs.openacs.org:/cvsroot co -r oacs-5-4 openacs-4
mv openacs-4 service
chmod 774 aolserver.service
# create log directory (if needed)
mkdir service/log
- Start AOLserver
./aolserver.service start
Some minutes after that, it must be running on http://localhost:8000
Created by OpenACS community, last modified by Gustaf Neumann 26 May 2021, at 12:18 PM
See one of these:
Should you decide to install OpenACS from source using general en:openacs-system-install instructions, refer to these notes for changes:
OS X conventions
On Mac OS X type sudo su - to become root.
Use curl -L -O instead of wget
If you are running Mac OS X prior to 10.3, you should be able to install and use PostgreSQL 7.3.x. Mac OS X 10.3 requires PostgreSQL 7.4. Note: if you're installing PG on an Intel Mac, you'll need to install 8.x; 7.4.x won't compile because of a lack of "native spinlock support" -- and this is something that the PG maintainers aren't inclined to fix. See this. PG 8.0.x installs fine, as does PG 8.1 or 8.2.
Creating postgres user
Do this instead:
First make sure the gids and uids below are available (change them if they are not). To list taken uids and gids:
nireport / /groups name gid | grep "[0-9][0-9][0-9]"
nireport / /users name uid | grep "[0-9][0-9][0-9]"
Now you can install the users
sudo niutil -create / /groups/web
sudo niutil -createprop / /groups/web gid 201
sudo niutil -create / /users/postgres
sudo niutil -createprop / /users/postgres gid 201
sudo niutil -createprop / /users/postgres uid 502
sudo niutil -createprop / /users/postgres home /usr/local/pgsql
sudo niutil -create / /users/$OPENACS_SERVICE_NAME
sudo niutil -createprop / /users/$OPENACS_SERVICE_NAME gid 201
sudo niutil -createprop / /users/$OPENACS_SERVICE_NAME uid 201
mkdir -p /usr/local/pgsql
chown -R postgres:web /usr/local/pgsql /usr/local/src/postgresql-7.4.7
chmod 750 /usr/local/pgsql
Compile and install PostgreSQL
If you're using Fink:
Append --with-includes=/sw/include/ --with-libraries=/sw/lib flags to ./configure.
./configure --with-includes=/sw/include/ --with-libraries=/sw/lib
Set PostgreSQL to start on boot
cd /Library/StartupItems/
tar xfz /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/files/osx-postgres-startup-item.tgz
Alternatively, one can use an XML file like the following to start PostgreSQL via launchd (specifying the postgres binary directory and database directory)
For Mac OS X Tiger (10.4.*), use:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>GroupName</key>
<string>nsadmin</string>
<key>Label</key>
<string>org.postgresql.PostgreSQL</string>
<key>OnDemand</key>
<false/>
<key>ProgramArguments</key>
<array>
<string>/usr/local/pg820/bin/pg_ctl</string>
<string>-D</string>
<string>/usr/local/pg820/data</string>
<string>-l</string>
<string>/usr/local/pg820/data/server.log</string>
<string>start</string>
</array>
<key>ServiceDescription</key>
<string>PostgreSQL Server</string>
<key>UserName</key>
<string>postgres</string>
</dict>
</plist>
For Mac OS X Leopard (10.5.*), use:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>org.postgresql.PostgreSQL</string>
<key>UserName</key>
<string>postgres</string>
<key>GroupName</key>
<string>nsadmin</string>
<key>OnDemand</key>
<false/>
<key>ProgramArguments</key>
<array>
<string>/usr/local/pg820/bin/postmaster</string>
<string>-D</string>
<string>/usr/local/pg820/data</string>
<string>-c</string>
<string>log_connections=YES</string>
</array>
</dict>
</plist>
Save the above files as /Library/LaunchDaemons/org.postgresql.PostgreSQL.plist and postgres will be started automatically on the next boot of the system. One can use launchctl to start the service for testing;
launchctl % load /Library/LaunchDaemons/org.postgresql.PostgreSQL.plist % start org.postgresql.PostgreSQL % ^D
To get Tcl to build on Leopard or newer
for compiling under Mac OS X Leopard or newer, use the following flags to compile Tcl:
./configure --prefix=/opt/aolserver --enable-threads --disable-corefoundation --enable-symbols
To get tDOM to build on tiger
- Download and install/update to the latest version of xcode tools (version2.2) from http://developer.apple.com/tools/xcode which updates the gcc compiler.
- Then make some additional changes to the unix/CONFIG file (after modifying the unix/CONFIG file according to instructions at en:aolserver-install, uncomment:
'CC=gcc; export CC'
- add a new line, somewhere after the first line:
export CPP="/usr/bin/cpp"
When versions of AOLservers different to AOLserver 4.5 (head, including changes from Mar 22, 2008) are used, AOLserver is likely to segfault on startup due to recent changes in the Mac OS X System libraries. To avoid this, use
ulimit -n 256
in the startup script (don't use unlimited).
Created by Ryan Gallimore, last modified by Gustaf Neumann 26 Sep 2019, at 08:27 PM
As root:
OPENACS_SERVICE_NAME=service1 # Name your service
export $OPENACS_SERVICE_NAME
groupadd web
useradd -g web $OPENACS_SERVICE_NAME mkdir /var/lib/aolserver
cd /var/lib/aolserver
# Download latest tarball:
>> wget [URL to latest tarball]
>> tar xzvf [tarball.tar.gz]
>> mv [tarball_dir] $OPENACS_SERVICE_NAME
# OR, checkout from CVS. Replace oacs-5-4 with the branch of your choice.
>> cvs -d:pserver:anonymous@cvs.openacs.org/cvsroot checkout -r oacs-5-4 acs-core
>> mv openacs-4 $OPENACS_SERVICE_NAME
chown -R $OPENACS_SERVICE_NAME.web /var/lib/aolserver/$OPENACS_SERVICE_NAME chmod -R 770 /var/lib/aolserver/$OPENACS_SERVICE_NAME
# PostgreSQL 8.x
service postgresql stop yum -y remove postgresql # Download the PG rpm
# Initialize the Cluster
service postgresql initdb
# Start the service
service postgresql start
# Start pg on boot
chkconfig postgresql on
# Change postgresql.conf
# AOLServer
Try the AOLServer 4.5 page. The archive download works well
(but uses sources from 2006).
# Daemontools should now be installed, so let's set it up to start, stop and restart AOLServer
cd /service
ln -s /var/lib/aolserver/$OPENACS_SERVICE_NAME/etc/daemontools $OPENACS_SERVICE_NAME
# Daemontools will no scan the etc/daemontools directory and find the run script.
Read this for more information on Daemontools commands
# Modify the etc/daemontools/run script for your ip, user and group. Note the -b IP:PORT flag that # must be added for privileged ports.
# Modify etc/config.tcl to match your hostname and IP. aolserver director should be /usr/local/aolserver
# avoid pid not found errors in the log
chown -R $OPENACS_SERVICE_NAME.web /usr/local/aolserver/log
chmod -R 775 /usr/local/aolserver/log
# Start the server!
svc -u /service/$OPENACS_SERVICE_NAME
# Watch the log for errors:
tail -f /var/lib/aolserver/$OPENACS_SERVICE_NAME/log/error.log
If successful, call up the site URL and install the data model.
# Done!
Created by Gustaf Neumann, last modified by Gustaf Neumann 25 Sep 2019, at 11:53 AM
NaviServer is a fork of AOLserver. While the goal of the AOLserver community is stability (no code changes unless necessary), NaviServer is targeted toward further development and extensions (implementing new features required by state of the art web server environments, see NEWS).
Availability
Using NaviServer with OpenACS
Created by Gustaf Neumann, last modified by Gustaf Neumann 25 Sep 2019, at 11:40 AM
Libthread is the standard Tcl thread library developed by Zoran Vasiljevic and provides optional functionality for OpenACS. Threads created by the Tcl thread library are executed in an event loop, which makes it easy to send commands to such threads. xotcl-core provides support for the the thread library and uses it for example for background delivery of large files. Also the chat package uses libthread when it is installed. The xotcl-request-monitor depends on libthread.
The advantage of libthead over NaviServer/AOLserver threads is that the threads created by libthread are waiting in an event loop for incoming requests, which eases some types of applications.
INSTALLATION:
In case, NaviServer was installed via install-ns, one can skip the section installation steps. Also the provided configuration script is already set up correctly for usage. The instruction below is for cases, where install-ns was not used.
1. Get and install libthread:
download libthread e.g. from
https://downloads.sourceforge.net/sourceforge/tcl/thread2.8.2.tar.gz
untar it and go to you platform specific directory (eg. thread2.8.2/unix)
# cd unix
# ../configure --enable-threads \
--prefix=/usr/local/ns \
--exec-prefix=/usr/local/ns \
--with-naviserver=/usr/local/ns
use --prefix --exec-prefix --with-naviserver with the path pointing to the directory, where NaviServer is installed.
The setup for AOLserver is similar, but different paths are used.
make
make install
You should now have installed libthread2.8.2.so (check for /usr/local/ns/lib/thread*/libthread* )
2) Adjusting the AOLserver/NaviServer configuration file to use libthread
Open the configuration file
restart nsd and check the error log, whether libthread was loaded successfully.
Created by OpenACS community, last modified by Gustaf Neumann 25 Sep 2019, at 11:16 AM
the free, open-source, multi-threaded, 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 greater )
- 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.
