Index: openacs-4/packages/acs-core-docs/www/aolserver.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/aolserver.adp,v diff -u -N -r1.5 -r1.5.2.1 --- openacs-4/packages/acs-core-docs/www/aolserver.adp 24 May 2018 06:54:57 -0000 1.5 +++ openacs-4/packages/acs-core-docs/www/aolserver.adp 2 Mar 2019 19:30:04 -0000 1.5.2.1 @@ -1,5 +1,5 @@ -{/doc/acs-core-docs {ACS Core Documentation}} {Install AOLserver 3.3oacs1} +{/doc/acs-core-docs/ {ACS Core Documentation}} {Install AOLserver 3.3oacs1} Install AOLserver 3.3oacs1

-Install AOLserver 3.3oacs1

<authorblurb>

by Vinod Kurup -

</authorblurb>

We recommend the use of AOLserver 4.0.1 or later. These +Install AOLserver 3.3oacs1

+

by Vinod Kurup +

+OpenACS docs are written by the named authors, and may be edited by +OpenACS documentation staff.

We recommend the use of AOLserver 4.0.1 or later. These instructions are retained as a resource.

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. -Unpack the Aolserver tarball.  Download -the aolserver tarball +Unpack the Aolserver tarball. Download the +aolserver tarball and unpack it.

    [root root]# cd /usr/local/src
     [root src]# wget --passive http://uptime.openacs.org/aolserver-openacs/aolserver3.3oacs1.tar.gz
     --15:38:08--  http://uptime.openacs.org/aolserver-openacs/aolserver3.3oacs1.tar.gz
    @@ -34,24 +37,24 @@
     15:39:05 (66.56 KB/s) - `aolserver3.3oacs1.tar.gz' saved [3858074/3858074]
     [root src]# tar xzf aolserver3.3oacs1.tar.gz
     [root src]#
    -cd /usr/local/src
    +cd /usr/local/src
     wget --passive http://uptime.openacs.org/aolserver-openacs/aolserver3.3oacs1.tar.gz
    -tar xzf aolserver3.3oacs1.tar.gz
    +tar xzf aolserver3.3oacs1.tar.gz
     

    This section also relies on some OpenACS files, which you can get with the section called “Unpack the OpenACS tarball”.

  2. -Compile AOLserver.  Compile and install +Compile AOLserver. Compile and install AOLserver. First, prepare the installation directory and the source code. The message about BUILD-MODULES can be ignored.

    root\@yourserver root]# mkdir -p /usr/local/aolserver
     [root root]# cd /usr/local/src/aolserver
     [root aolserver]# ./conf-clean
     cat: BUILD-MODULES: No such file or directory
     Done.
    -[root aolserver]#mkdir -p /usr/local/aolserver
    +[root aolserver]#mkdir -p /usr/local/aolserver
     cd /usr/local/src/aolserver
    -./conf-clean
    +./conf-clean
     

    If you are using Oracle, edit conf-db and change postgresql to oracle, or to the word both if you want both drivers installed. In order to get nsoracle to compile, you may need to su - oracle, and then su (without the -) root to set the environment variables @@ -100,37 +103,37 @@ build errors.

  3. -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.

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

        [root aolserver]# cd /usr/local/aolserver/bin
         [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
        +cd /usr/local/aolserver/bin
         cp /var/tmp/openacs-5.9.0/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres
        -chmod 755 nsd-postgres
        +chmod 755 nsd-postgres
         
    • -Install tDOM.  Download the tDOM -tarball, unpack it, adjust the configuration file to match our -patched distribution of aolserver, and compile it.

      [root root]# cd /usr/local/src
      +Install tDOM. Download the tDOM tarball,
      +unpack it, adjust the configuration file to match our patched
      +distribution of AOLserver, and compile it.

      [root root]# cd /usr/local/src
       [root src]# wget --passive http://www.tdom.org/tDOM-0.7.8.tar.gz
       --16:40:58--  http://www.tdom.org/tDOM-0.7.8.tar.gz
                  => `tDOM-0.7.8.tar.gz'
      @@ -146,10 +149,10 @@
       [root src]# tar xzf tDOM-0.7.8.tar.gz
       [root src]# cd tDOM-0.7.8/unix
       [root unix]#
      -cd /usr/local/src
      +cd /usr/local/src
       wget --passive http://www.tdom.org/tDOM-0.7.8.tar.gz
       tar xzf tDOM-0.7.8.tar.gz
      -cd tDOM-0.7.8/unix
      +cd tDOM-0.7.8/unix
       

      Edit the file CONFIG and change this section:

       # ----------------------------------------------------
       # aolsrc="/usr/src/aolserver-3.4"
      @@ -177,19 +180,19 @@
       [root bin]# ln -s libtdom0.7.8.so libtdom.so
       [root bin]#
       
      -sh CONFIG
      +sh CONFIG
       make
       cp libtdom0.7.8.so /usr/local/aolserver/bin/
       cd /usr/local/aolserver/bin
      -ln -s libtdom0.7.8.so libtdom.so
      +ln -s libtdom0.7.8.so libtdom.so
       
    • Install nsopenssl (OPTIONAL)

    • Install Full Text Search with OpenFTS (OPTIONAL)

    • Install nspam (OPTIONAL)

    • -Test AOLserver.  In order to test +Test AOLserver. In order to test AOLserver, we'll run it using the sample-config.tcl file provided in the AOLserver distribution, under the nobody user and web group. The @@ -209,11 +212,11 @@ -rw-r--r-- 1 root root 7320 Mar 31 2001 sample-config.tcl drwxrwsr-x 3 root web 4096 Mar 8 10:31 servers [root aolserver]# - + cd /usr/local/aolserver chown -R root.web log servers chmod -R g+w log servers -ls -l +ls -l

      Note: AOLserver4.x does not include a default start page, so we create one for this test. Type echo "Welcome to AOLserver" > @@ -252,8 +255,8 @@ alive section.

    • -Troubleshooting.  If you can't view -the welcome page, it's likely there's a problem with your +Troubleshooting. If you can't view the +welcome page, it's likely there's a problem with your server configuration. Start by viewing your AOLserver log, which is in /usr/local/aolserver/log/server.log. You should also try to find lines of the form:

      @@ -275,8 +278,8 @@
       
    • Install Analog web file analyzer. (OPTIONAL)

    • -

($‌Id: aolserver.xml,v 1.23 2017/08/07 -23:47:54 gustafn Exp $)

+
($‌Id: aolserver.xml,v 1.25 2018/09/30 15:53:28 +gustafn Exp $)