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.12 -r1.1.2.13 --- openacs-4/packages/acs-core-docs/www/aolserver4.html 11 Feb 2004 11:19:46 -0000 1.1.2.12 +++ openacs-4/packages/acs-core-docs/www/aolserver4.html 8 Mar 2004 21:21:45 -0000 1.1.2.13 @@ -1,14 +1,7 @@ -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. -

- (Debian users: we do not recommend installing Debian packages for - Aolserver or Postgres. Several people have - reported problems while trying to install using apt-get - instead of from source. If you have the time to debug these - and submit what you did, that's great, but if not, you - should stick to installing from source. -

  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
    +        
  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
    @@ -20,14 +13,13 @@
     tar xfz tcl8.4.5-src.tar.gz
     cd tcl8.4.5/unix
     ./configure --enable-threads
    -make install
    -
    +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 src]# mkdir aolserver40r2
    +[root src]# cd aolserver40r2
    +[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_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
    @@ -36,52 +28,46 @@
     [root aolserver]# tar xvfz tDOM-0.7.8.tar.gz
     [root root]# 
     cd /usr/local/src
    -mkdir aolserver
    -cd aolserver
    +mkdir aolserver40r2
    +cd aolserver40r2
     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.�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/aolserver40r2.

      [root aolserver]# cd /usr/local/src/aolserver40r2/aolserver
      +[root aolserver]# ./configure --prefix=/usr/local/aolserver40r2 --with-tcl=/usr/local/lib/
      +[root aolserver]# make install
      +      cd /usr/local/src/aolserver40r2/aolserver
       ./configure --with-tcl=/usr/local/lib/
       make install
      -cd ../nscache
      -make install
      -cd ../nsrewrite
      -make install
      -cd ../nsoracle
      -make install
    5. 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
    6. Install nssha1

      [root nsrewrite]# cd ../nssha1
      +ln -s /usr/local/aolserver40r2 /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/aolserver40r2 instead of /usr/local/aolserver in future steps.

      [root aolserver]# ln -s /usr/local/aolserver40r2 /usr/local/aolserver
    7. Configure, compile and install the modules.� +

      1. Install nscache

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

        [root nscache]# cd ../nsoracle
        +[root nsoracle]# make install
      3. Install nspostgres (if you want to use Postgres)

        [root nsrewrite]# cd ../nspostgres
        +[root nspostgres]# make install POSTGRES=LSB ACS=1 INST=/usr/local/aolserver40r2 

        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.

        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
      4. 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
      5. 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
        +          --prefix=/usr/local/aolserver40r2 --with-tcl=/usr/local/lib

        Now you can compile and configure tDOM

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

    8. 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/openacs-5.0.2/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle
        +	  to use both databases, install both.

        • Oracle

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

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