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.1.2.2 -r1.1.2.3 --- openacs-4/packages/acs-core-docs/www/aolserver4.html 18 Dec 2003 10:04:26 -0000 1.1.2.2 +++ openacs-4/packages/acs-core-docs/www/aolserver4.html 6 Jan 2004 14:19:53 -0000 1.1.2.3 @@ -1,46 +1,80 @@ -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 AOLserver.�Download the aolserver from CVS.

    [root root]# cd /usr/local/src
    -[root src]# mkdir aolserver
    -[root src]# cd aolserver
    -[root /usr/local/src/aolserver]# cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co  -r aolserver_v40_r2 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 nsrewrite
    -[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 nsxml
    -[root aolserver]# wget http://www.tdom.org/tDOM-0.7.8.tar.gz
    -[root aolserver]# tar xvfz tDOM-0.7.8.tar.gz
    -[root aolserver]# 
    -cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co -r aolserver_v40_r2 aolserver
    +        
  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

    [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 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
    +./configure --enable-threads
    +make install
    +
    +      
  2. Retrieve AOLserver.�Download the aolserver from CVS.

    [root root]# cd /usr/local/src
    +[root src]# mkdir aolserver
    +[root src]# cd aolserver
    +[root aolserver]# cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co  -r aolserver_v40_r2 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 nsrewrite
    +[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 nsxml
    +[root aolserver]# wget http://www.tdom.org/tDOM-0.7.8.tar.gz
    +[root aolserver]# tar xvfz tDOM-0.7.8.tar.gz
    +[root root]# 
    +cd /usr/local/src
    +mkdir aolserver
    +cd aolserver
    +cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co -r aolserver_v40_r2 aolserver
     cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co nscache
     cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co nsrewrite
     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 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.�

    [root aolserver]# cd aolserver
    -[root aolserver]# cd aolserver
    -[root aolserver]# ./configure --with-tcl=/usr/local/lib/
    -[root aolserver]# make install
  4. Configure, compile and install the modules.� -

    1. Install nscache

      [root /usr/local/src/aolserver/aolserver]# cd ../nscache
      -[root /usr/local/src/aolserver/nscache]# make install
    2. Install nsrewrite

      [root /usr/local/src/aolserver/nscache]# cd ../nsrewrite
      -[root /usr/local/src/aolserver/nsrewrite]# make install
    3. Install nsoracle (if you want to use Oracle)

      [root /usr/local/src/aolserver/nscache]# cd ../nsoracle
      -[root /usr/local/src/aolserver/nsrewrite]# make install

      Steps so far

      cd /usr/local/src/aolserver/
      +tar xvfz tDOM-0.7.8.tar.gz
    4. Configure, compile and install AOLserver.�

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

    5. Configure, compile and install the modules.� +

      1. Install nscache

        [root /usr/local/src/aolserver/aolserver]# cd ../nscache
        +[root /usr/local/src/aolserver/nscache]# make install
      2. Install nsrewrite

        [root /usr/local/src/aolserver/nscache]# cd ../nsrewrite
        +[root /usr/local/src/aolserver/nsrewrite]# make install
      3. Install nsoracle (if you want to use Oracle)

        [root /usr/local/src/aolserver/nscache]# cd ../nsoracle
        +[root /usr/local/src/aolserver/nsrewrite]# make install

        Steps so far

        cd /usr/local/src/aolserver/
         ./configure --with-tcl=/usr/local/lib/
         make install
         cd ../nscache
         make install
         cd ../nsrewrite
         make install
         cd ../nsoracle
        -make install
      4. Install nspostgres (if you want to use Postgres)

        [root nsrewrite]# cd ../nspostgres
        -[root nspostgres]# sudo make install POSTGRES=/usr/local/pgsql ACS=1 

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

        [root nspostgres]# sudo 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
      5. Install nssha1

        [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
      6. 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/aolserver --with-tcl=/usr/local/lib

        Now you can compile and configure tDOM

        [root unix]# sh CONFIG
        -[root unix]# make install

      -

    6. Test AOLserver.

    ($Id$)
View comments on this page at openacs.org
+make install
  • Install nspostgres (if you want to use Postgres)

    [root nsrewrite]# cd ../nspostgres
    +[root nspostgres]# sudo make install POSTGRES=/usr/local/pgsql ACS=1 INST=/usr/local/aolserver 

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

    [root nspostgres]# sudo 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
  • Install nssha1

    [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
  • 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/aolserver --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/aolserver/bin
      +[root bin]# cp /tmp//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 /tmp//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 /tmp//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 /tmp//packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres
      +chmod 755 nsd-postgres
  • Test AOLserver.

  • ($Id$)
    View comments on this page at openacs.org