Index: openacs-4/packages/acs-core-docs/www/aolserver4.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/aolserver4.html,v diff -u -r1.8.2.4 -r1.8.2.5 --- openacs-4/packages/acs-core-docs/www/aolserver4.html 5 Jul 2004 19:47:30 -0000 1.8.2.4 +++ openacs-4/packages/acs-core-docs/www/aolserver4.html 15 Oct 2004 07:35:40 -0000 1.8.2.5 @@ -2,23 +2,23 @@ OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff.
Retrieve TCL 8.4 (or higher).�Download and install TCL 8.4
If you have not installed TCL already, download the latest TCL version from Sourceforge
Remember that you have to be root if you want to follow these instructions. On Mac OS X type sudo su - to become root.
Alternatively use curl -L -O instead of wget (especially on Mac OS X.
[root root]# cd /usr/local/src
-[root src]# wget http://heanet.dl.sourceforge.net/sourceforge/tcl/tcl8.4.6-src.tar.gz
-[root src]# tar xfz tcl8.4.6-src.tar.gz
-[root src]# cd tcl8.4.6/unix
+[root src]# wget http://heanet.dl.sourceforge.net/sourceforge/tcl/tcl8.4.7-src.tar.gz
+[root src]# tar xfz tcl8.4.7-src.tar.gz
+[root src]# cd tcl8.4.7/unix
[root unix]# ./configure --enable-threads
[root unix]# make install
[root root]#
cd /usr/local/src
-wget http://heanet.dl.sourceforge.net/sourceforge/tcl/tcl8.4.6-src.tar.gz
-tar xfz tcl8.4.6-src.tar.gz
-cd tcl8.4.6/unix
+wget http://heanet.dl.sourceforge.net/sourceforge/tcl/tcl8.4.7-src.tar.gz
+tar xfz tcl8.4.7-src.tar.gz
+cd tcl8.4.7/unix
./configure --enable-threads
make install
Retrieve AOLserver.�Download the aolserver from CVS.
[root root]# cd /usr/local/src
-[root src]# mkdir aolserver40r5
-[root src]# cd aolserver40r5
+[root src]# mkdir aolserver40r8
+[root src]# cd aolserver40r8
[root aolserver]# cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver login
-[root aolserver]# cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co -r aolserver_v40_r5 aolserver
+[root aolserver]# cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co -r aolserver_v40_r8 aolserver
[root aolserver]# cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co nscache
[root aolserver]# cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co nspostgres
[root aolserver]# cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co nssha1
@@ -28,27 +28,27 @@
[root aolserver]# tar xvfz tDOM-0.7.8.tar.gz
[root root]#
cd /usr/local/src
-mkdir aolserver40r5
-cd aolserver40r5
-cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co -r aolserver_v40_r5 aolserver
+mkdir aolserver40r8
+cd aolserver40r8
+cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co -r aolserver_v40_r8 aolserver
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co nscache
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co nspostgres
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co nssha1
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co -r v2_7 nsoracle
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co nsxml
wget http://www.tdom.org/tDOM-0.7.8.tar.gz
-tar xvfz tDOM-0.7.8.tar.gz
Configure, compile and install AOLserver.�Many people need to run more than one version of AOLserver in parallel. This section accomodates future upgrades by installing AOLserver 4 in /usr/local/aolserver40r5.
[root aolserver]# cd /usr/local/src/aolserver40r5/aolserver -[root aolserver]# ./configure --prefix=/usr/local/aolserver40r5 --with-tcl=/usr/local/lib/ +tar xvfz tDOM-0.7.8.tar.gz
Configure, compile and install AOLserver.�Many people need to run more than one version of AOLserver in parallel. This section accomodates future upgrades by installing AOLserver 4 in /usr/local/aolserver40r8.
[root aolserver]# cd /usr/local/src/aolserver40r8/aolserver
+[root aolserver]# ./configure --prefix=/usr/local/aolserver40r8 --with-tcl=/usr/local/lib/
[root aolserver]# make install
-cd /usr/local/src/aolserver40r5/aolserver
-./configure --prefix=/usr/local/aolserver40r5 --with-tcl=/usr/local/lib/
+cd /usr/local/src/aolserver40r8/aolserver
+./configure --prefix=/usr/local/aolserver40r8 --with-tcl=/usr/local/lib/
make install
-ln -s /usr/local/aolserver40r5 /usr/local/aolserver
If this is the only version of AOLserver in use, or is the default version, create a symlink. If not, then be sure to use /usr/local/aolserver40r5 instead of /usr/local/aolserver in future steps.
[root aolserver]# ln -s /usr/local/aolserver40r5 /usr/local/aolserver
Configure, compile and install the modules.� -
[root aolserver]# cd /usr/local/src/aolserver40r5/nscache +ln -s /usr/local/aolserver40r8 /usr/local/aolserver
If this is the only version of AOLserver in use, or is the default version, create a symlink. If not, then be sure to use /usr/local/aolserver40r8 instead of /usr/local/aolserver in future steps.
[root aolserver]# ln -s /usr/local/aolserver40r8 /usr/local/aolserver
Configure, compile and install the modules.� +
[root aolserver]# cd /usr/local/src/aolserver40r8/nscache [root nscache]# make install
Install nsoracle (if you want to use Oracle)
[root nscache]# cd ../nsoracle [root nsoracle]# make install
Install nspostgres (if you want to use Postgres)
[root nsrewrite]# cd ../nspostgres -[root nspostgres]# make install POSTGRES=LSB ACS=1 INST=/usr/local/aolserver40r5
If you get errors like:
nspostgres.c: In function `Ns_PgTableList': -nspostgres.c:679: warning: passing arg 3 of `Tcl_DStringAppend' as signed due to prototype
then PostGreSQL is probably not in the standard location. The location of PostGreSQL is very dependent on which method was used to install it. To correct the problem, replace LSB with the path to the path to your PostGreSQL installation. Often this is /usr/local/pgsql.
Another possibility is that you may need to set +[root nspostgres]# make install POSTGRES=/usr/local/pgsql ACS=1 INST=/usr/local/aolserver40r8
If you get errors like:
nspostgres.c: In function `Ns_PgTableList': +nspostgres.c:679: warning: passing arg 3 of `Tcl_DStringAppend' as signed due to prototype
then PostGreSQL is probably not in the standard location. The location of PostGreSQL is very dependent on which method was used to install it. To correct the problem, replace /usr/local/pgsql with the path to the path to your PostGreSQL installation.
Another possibility is that you may need to set the LD_LIBRARY_PATH environmental variable. You may still get warnings, but sometimes this will fix things enough to work.
[root nspostgres]# export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/pgsql/lib @@ -59,24 +59,24 @@If you run into problems with libpq.a do the following (and repeat the step above)
[root nspostgres]# ranlib /usr/local/pgsql/lib/libpq.aIf you run into problems with the linker, edit the Makefile. Add -lnsdb to the MODLIBS var.
MODLIBS = -L$(PGLIB) -lpq -lnsdb
[root nsrewrite]# cd ../nssha1 [root nssha1]# make
If the make fails you will have to edit nssha1.c. Comment out the following 2 lines (lines 139-140):
// typedef unsigned int u_int32_t; // typedef unsigned char u_int8_t;
Now install nssha1:
[root nssha1]# make install
[root nssha1]# cd ../tDOM-0.7.8/unix
Edit the CONFIG file. Uncomment the instructions meant for AOLserver 4, but edit it to look like this:
../configure --enable-threads --disable-tdomalloc - --prefix=/usr/local/aolserver40r5 --with-tcl=/usr/local/lib
Now you can compile and configure tDOM
[root unix]# sh CONFIG + --prefix=/usr/local/aolserver40r8 --with-tcl=/usr/local/lib
Now you can compile and configure tDOM
[root unix]# sh CONFIG [root unix]# make install
Add a database-specific wrapper script.�This script sets database environment variables before starting AOLserver; this allows the AOLserver instance can communicate with the database. There is one script each for Oracle and PostgreSQL. They don't conflict, so if you plan - to use both databases, install both.
Oracle
[root aolserver]# cd /usr/local/aolserver40r5/bin + to use both databases, install both.
Oracle
[root aolserver]# cd /usr/local/aolserver40r8/bin [root bin]# cp /tmp/openacs-5.1.1/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle [root bin]# chmod 750 nsd-oracle [root bin]# -cd /usr/local/aolserver40r5/bin +cd /usr/local/aolserver40r8/bin cp /tmp/openacs-5.1.1/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle -chmod 750 nsd-oracle
PostgreSQL
[root aolserver]# cd /usr/local/aolserver40r5/bin +chmod 750 nsd-oraclePostgreSQL
[root aolserver]# cd /usr/local/aolserver40r8/bin [root bin]# cp /tmp/openacs-5.1.1/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres [root bin]# chmod 755 nsd-postgres [root bin]# -cd /usr/local/aolserver40r5/bin +cd /usr/local/aolserver40r8/bin cp /tmp/openacs-5.1.1/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres chmod 755 nsd-postgres
You may need to edit these scripts if you are not using /usr/local/aolserver as the directory of Aolserver4.
Change startup script (optional).�If you want to run AOLserver on a port below 1024 (normally, for a webserver you will use 80), you will have to change the /var/lib/aolserver/service0/etc/daemontools/run script according to the documentation found there (namely: Add the -b yourip:yourport switch)