Index: openacs-4/packages/acs-core-docs/www/aolserver4.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/aolserver4.adp,v diff -u -r1.2 -r1.3 --- openacs-4/packages/acs-core-docs/www/aolserver4.adp 7 Aug 2017 23:47:49 -0000 1.2 +++ openacs-4/packages/acs-core-docs/www/aolserver4.adp 8 Nov 2017 09:42:10 -0000 1.3 @@ -9,39 +9,37 @@ rightLink="openacs" rightLabel="Next">

-Install AOLserver 4

-

by Malte Sussdorff -

-OpenACS docs are written by the named authors, and may be edited by -OpenACS documentation staff.
    +Install AOLserver 4
<authorblurb>

by Malte +Sussdorff +

</authorblurb>

  1. Check suitability of previously installed -TCL. Start Tcl (type tclsh or find it using +TCL.  Start Tcl (type tclsh or find it using which tclsh).

     [root root]% info exists tcl_platform(threaded)
 1
 [root root]% info patchlevel
 8.4.7
 [root root]%
-tclsh
+tclsh
 info exists tcl_platform(threaded)
 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.4 or higher, then installing Tcl from source is optional.

    Retrieve -Tcl 8.4 (or higher). Download and install Tcl +Tcl 8.4 (or higher).  Download and install Tcl 8.4 from source

    Note for Debian users: 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 on the Install Postgres page). You'll have to use /usr/lib/tcl8.4/ instead of /usr/local/lib when you try to find the Tcl libraries, however.

    If you have not installed Tcl already, download the latest Tcl version from Sourceforge

    -Debian:apt-get -install tcl8.4 tcl8.4-dev and proceed to the -next step. In that step, replace --with-tcl=/usr/local/lib/ with +Debian:apt-get install tcl8.4 +tcl8.4-dev and proceed to the next step. In that +step, replace --with-tcl=/usr/local/lib/ with --with-tcl=/usr/lib/tcl8.4.

    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 @@ -54,16 +52,16 @@ [root unix]# ./configure --enable-threads [root unix]# make install [root root]# -cd /usr/local/src +cd /usr/local/src wget http://heanet.dl.sourceforge.net/sourceforge/tcl/tcl8.4.9-src.tar.gz tar xfz tcl8.4.9-src.tar.gz cd tcl8.4.9/unix ./configure --enable-threads -make install +make install

  2. -Retrieve AOLserver. Download the +Retrieve AOLserver.  Download the AOLserver from CVS.

     [root root]# cd /usr/local/src
 [root src]# mkdir aolserver40r10
@@ -78,7 +76,7 @@
 [root aolserver]# tar xvfz tDOM-0.7.8.tar.gz
 [root aolserver]# cvs -z3 -d:pserver:anonymous\@cvs.sourceforge.net:/cvsroot/tcllib co -r tcllib-1-8 tcllib
 [root root]# 
-cd /usr/local/src
+cd /usr/local/src
 mkdir aolserver40r10
 cd aolserver40r10
 cvs -z3 -d:pserver:anonymous\@cvs.sourceforge.net:/cvsroot/aolserver co -r aolserver_v40_r10 AOLserver
@@ -88,20 +86,20 @@
 cvs -z3 -d:pserver:anonymous\@cvs.sourceforge.net:/cvsroot/aolserver co -r v2_7 nsoracle
 wget http://www.tdom.org/files/tDOM-0.8.0.tar.gz
 tar xvfz tDOM-0.8.0.tar.gz
-cvs -z3 -d:pserver:anonymous\@cvs.sourceforge.net:/cvsroot/tcllib co -r tcllib-1-8 tcllib
+cvs -z3 -d:pserver:anonymous\@cvs.sourceforge.net:/cvsroot/tcllib co -r tcllib-1-8 tcllib

  3. Configure, compile and install -AOLserver. Many people need to run more than +AOLserver.  Many people need to run more than one version of AOLserver in parallel. This section accommodates future upgrades by installing AOLserver 4 in /usr/local/aolserver40r9.

     [root aolserver]# cd /usr/local/src/aolserver40r10/aolserver
 [root aolserver]# ./configure --prefix=/usr/local/aolserver40r10 --with-tcl=/usr/local/lib/
-[root aolserver]# make installcd /usr/local/src/aolserver40r10/aolserver
+[root aolserver]# make installcd /usr/local/src/aolserver40r10/aolserver
 ./configure --prefix=/usr/local/aolserver40r10 --with-tcl=/usr/local/lib/
 make install
-
+

    If you are using gcc 4 or later, see http://openacs.org/forums/message-view?message_id=309814

    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 @@ -115,15 +113,12 @@

    Configure, compile and install the modules. 

    1. -

      -Install nscache

      +
      Install nscache
       [root aolserver]# cd /usr/local/src/aolserver40r10/nscache
 [root nscache]# make install AOLSERVER=/usr/local/aolserver
    2. -

      -Install nsoracle (if you want to -use Oracle)

      +
      Install nsoracle (if you want to use Oracle)
       [root nscache]# cd ../nsoracle
 [root nsoracle]# make install AOLSERVER=/usr/local/aolserver
 
      OpenACS looks for the Oracle driver at
@@ -132,9 +127,7 @@
 (ln -s nsoracle.so
 ora8.so) to fix it.
    3. -

      -Install nspostgres (if you want -to use Postgres)

      +
      Install nspostgres (if you want to use Postgres)
       [root nscache]# cd ../nspostgres
 [root nspostgres]# export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/pgsql/lib:/usr/local/aolserver/lib
 [root nspostgres]# make install POSTGRES=LSB ACS=1 INST=/usr/local/aolserver  AOLSERVER=/usr/local/aolserver
@@ -155,8 +148,7 @@
 MODLIBS = -L$(PGLIB) -lpq -lnsdb
    4. -

      -Install nssha1

      +
      Install nssha1
       [root nspostgres]# cd ../nssha1
 
      Now install nssha1:
       [root nssha1]# make install AOLSERVER=/usr/local/aolserver
@@ -166,8 +158,7 @@
 // typedef unsigned char u_int8_t;
    5. -

      -Install tDOM

      +
      Install tDOM
       [root nssha1]# cd ../tDOM-0.8.0/unix
 
      Edit the CONFIG file.
 Uncomment the instructions meant for AOLserver 4, but edit it to
@@ -180,8 +171,7 @@
 [root unix]# make install
    6. -

      -Install TCLLIB

      +
      Install TCLLIB
       [root nssha1]# cd ../tcllib
 
      Configure and compile TCLLIB
       [root unix]# ./configure -prefix=/usr/local/aolserver40r10
@@ -192,7 +182,7 @@

    7. Add a database-specific wrapper -script. This script sets database environment +script.  This script sets database environment variables before starting AOLserver; this allows the AOLserver instance to communicate with the database. There is one script for Oracle and one for PostgreSQL. They do not conflict. If you plan to @@ -208,34 +198,35 @@ [root bin]# cp /tmp/openacs-5.9.0/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle [root bin]# chmod 750 nsd-oracle [root bin]# -cd /usr/local/aolserver/bin +cd /usr/local/aolserver/bin cp /var/tmp/openacs-5.9.0/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle -chmod 750 nsd-oracle +chmod 750 nsd-oracle

    8. PostgreSQL

       [root aolserver]# cd /usr/local/aolserver/bin
 [root bin]# cp /var/tmp/openacs-5.9.0/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres
 [root bin]# chmod 755 nsd-postgres
 [root bin]#
-cd /usr/local/aolserver/bin
+cd /usr/local/aolserver/bin
 cp /var/tmp/openacs-5.9.0/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres
-chmod 755 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.

  4. -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 +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)

  5. +-b yourip:yourport +switch)

  6. Test AOLserver.

    7. -
($‌Id: aolserver4.xml,v 1.31.2.3 2017/04/22 -17:18:48 gustafn Exp $)
+

($‌Id: aolserver4.xml,v 1.32 2017/08/07 +23:47:54 gustafn Exp $)