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.3 -r1.8.2.4 --- openacs-4/packages/acs-core-docs/www/aolserver4.html 12 Jun 2004 11:01:55 -0000 1.8.2.3 +++ openacs-4/packages/acs-core-docs/www/aolserver4.html 5 Jul 2004 19:47:30 -0000 1.8.2.4 @@ -1,17 +1,17 @@ -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. 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.5-src.tar.gz
    -[root src]# tar xfz tcl8.4.5-src.tar.gz
    -[root src]# cd tcl8.4.5/unix
    +[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 unix]# ./configure --enable-threads
     [root unix]# make install
     [root root]# 
     cd /usr/local/src
    -wget http://heanet.dl.sourceforge.net/sourceforge/tcl/tcl8.4.5-src.tar.gz
    -tar xfz tcl8.4.5-src.tar.gz
    -cd tcl8.4.5/unix
    +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
     ./configure --enable-threads
     make install
           
  2. Retrieve AOLserver.�Download the aolserver from CVS.

    [root root]# cd /usr/local/src
    @@ -22,7 +22,7 @@
     [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
    -[root aolserver]# cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co nsoracle
    +[root aolserver]# cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co -r v2_7 nsoracle
     [root aolserver]# cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co nsxml
     [root aolserver]# wget http://www.tdom.org/tDOM-0.7.8.tar.gz
     [root aolserver]# tar xvfz tDOM-0.7.8.tar.gz
    @@ -34,7 +34,7 @@
     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 nsoracle
    +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
  3. 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
    @@ -61,22 +61,22 @@
     // typedef unsigned char u_int8_t;

    Now install nssha1:

    [root nssha1]# make install
  4. Install tDOM

    [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
     [root unix]# make install

-

  • Add a database-specific wrapper script.�This script +

  • 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
      -[root bin]# cp /tmp/openacs-5.1.0/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle
      +[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
      -cp /tmp/openacs-5.1.0/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle
      +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
      -[root bin]# cp /tmp/openacs-5.1.0/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres
      +[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
      -cp /tmp/openacs-5.1.0/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres
      +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)

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