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 -r1.8.2.1 --- openacs-4/packages/acs-core-docs/www/aolserver4.html 4 Mar 2004 14:09:21 -0000 1.8 +++ openacs-4/packages/acs-core-docs/www/aolserver4.html 18 Apr 2004 11:55:50 -0000 1.8.2.1 @@ -1,4 +1,4 @@ -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
    @@ -48,7 +48,15 @@
     [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
    +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.

    Another possibility is that you may need to set + the LD_LIBRARY_PATH environmental variable. You may + still get warnings, but sometimes this will fix things + enough to work.

    [root nspostgres]# export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/pgsql/lib
    +              

    You can use the + ldd command to verify + that all libraries are linked in: + ldd 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
  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/aolserver40r2 --with-tcl=/usr/local/lib

    Now you can compile and configure tDOM

    [root unix]# sh CONFIG
    @@ -59,15 +67,16 @@
     	  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/aolserver40r2/bin
      -[root bin]# cp /tmp/openacs-5.1.0d2/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle
      +[root bin]# cp /tmp/openacs-5.1.0b1/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle
       [root bin]# chmod 750 nsd-oracle
       [root bin]#
       cd /usr/local/aolserver40r2/bin
      -cp /tmp/openacs-5.1.0d2/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle
      +cp /tmp/openacs-5.1.0b1/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.1.0d2/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres
      +[root bin]# cp /tmp/openacs-5.1.0b1/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres
       [root bin]# chmod 755 nsd-postgres
       [root bin]#
       cd /usr/local/aolserver40r2/bin
      -cp /tmp/openacs-5.1.0d2/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres
      -chmod 755 nsd-postgres
  7. 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)

  8. Test AOLserver.

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