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.27 -r1.28 --- openacs-4/packages/acs-core-docs/www/aolserver4.html 27 Oct 2014 16:39:16 -0000 1.27 +++ openacs-4/packages/acs-core-docs/www/aolserver4.html 7 Aug 2017 23:47:49 -0000 1.28 @@ -1,8 +1,8 @@ -Install AOLserver 4

Install AOLserver 4

by Malte Sussdorff

+Install AOLserver 4

Install AOLserver 4

by Malte Sussdorff

OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. -
  1. Check suitability of previously installed TCL. Start tcl (type tclsh or find it using which tclsh). +

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

    [root root]% info exists tcl_platform(threaded)
     1
     [root root]% info patchlevel
    @@ -12,14 +12,14 @@
     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. + 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 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: + 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 @@ -37,7 +37,7 @@ cd tcl8.4.9/unix ./configure --enable-threads make install -

  2. Retrieve AOLserver. Download the aolserver from CVS.

    [root root]# cd /usr/local/src
    +      
  3. Retrieve AOLserver. Download the AOLserver from CVS.

    [root root]# cd /usr/local/src
     [root src]# mkdir aolserver40r10
     [root src]# cd aolserver40r10
     [root aolserver]# cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver login
    @@ -53,14 +53,14 @@
     cd /usr/local/src
     mkdir aolserver40r10
     cd aolserver40r10
    -cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co -r aolserver_v40_r10 aolserver
    +cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co -r aolserver_v40_r10 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
     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
  4. 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/aolserver40r9.

    [root aolserver]# cd /usr/local/src/aolserver40r10/aolserver
    +cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/tcllib co -r tcllib-1-8 tcllib
  5. Configure, compile and install 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 install
     cd /usr/local/src/aolserver40r10/aolserver
    @@ -82,7 +82,7 @@
                     ldd /usr/local/src/aolserver40r10/nspostgres/nspostgres.so
                   

    If you run into problems with libpq.a do the following (and repeat the step above)

    [root nspostgres]# ranlib /usr/local/pgsql/lib/libpq.a

    If you run into problems with the linker, edit the Makefile. Add -lnsdb to the MODLIBS var.

    MODLIBS = -L$(PGLIB) -lpq -lnsdb
  6. Install nssha1

    [root nspostgres]# cd ../nssha1

    Now install nssha1:

    [root nssha1]# make install AOLSERVER=/usr/local/aolserver

    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;
  7. 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 look like this:

    ../configure --enable-threads --disable-tdomalloc
    -          --prefix=/usr/local/aolserver --with-tcl=/usr/local/lib

    Note that the location of the Tcl library may vary on differnt platforms (e.g. for Debian 3.0: --with-tcl=/usr/lib/tcl8.4)

    Now you can compile and configure tDOM

    [root unix]# sh CONFIG
    +          --prefix=/usr/local/aolserver --with-tcl=/usr/local/lib

    Note that the location of the Tcl library may vary on different platforms (e.g. for Debian 3.0: --with-tcl=/usr/lib/tcl8.4)

    Now you can compile and configure tDOM

    [root unix]# sh CONFIG
     [root unix]# make install
  8. Install TCLLIB

    [root nssha1]# cd ../tcllib

    Configure and compile TCLLIB

    [root unix]# ./configure -prefix=/usr/local/aolserver40r10
     [root unix]# make install

  • Add a database-specific wrapper script. This script @@ -100,16 +100,16 @@ maintainers: this should be moved to the next page and integrated into the text there)

    • Oracle

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

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

  • Test AOLserver.

  • ($Id$)
    View comments on this page at openacs.org
    + /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)

  • Test AOLserver.

  • ($Id$)