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.3 -r1.4 --- openacs-4/packages/acs-core-docs/www/aolserver.adp 8 Nov 2017 09:42:10 -0000 1.3 +++ openacs-4/packages/acs-core-docs/www/aolserver.adp 25 Apr 2018 08:38:27 -0000 1.4 @@ -3,12 +3,11 @@ Install AOLserver 3.3oacs1 -
+ leftLink="install-ldap-radius" leftLabel="Prev" + title="Appendix B. Install +additional supporting software" + rightLink="credits" rightLabel="Next"> +

Install AOLserver 3.3oacs1

<authorblurb>

by Vinod Kurup

</authorblurb>

We recommend the use of AOLserver 4.0.1 or later. These @@ -19,10 +18,9 @@ but if not, you should stick to installing from source.

  1. -Unpack the Aolserver tarball.  -Download the aolserver tarball -and unpack it.

    -[root root]# cd /usr/local/src
+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
            => `aolserver3.3oacs1.tar.gz'
@@ -40,16 +38,13 @@
 wget --passive http://uptime.openacs.org/aolserver-openacs/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”.
    
+get with the section called “Unpack the OpenACS
+tarball”.

  2. -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
+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
@@ -63,10 +58,8 @@
 properly.
    
 conf-inst should contain the
 location where AOLserver is to be installed. Overwrite the
-tarball's default value with our default value, /usr/local/aolserver:
    -[root aolserver]# echo "/usr/local/aolserver" > conf-inst
-[root aolserver]#
-
    
+tarball's default value with our default value, /usr/local/aolserver:
    [root aolserver]# echo "/usr/local/aolserver" > conf-inst
+[root aolserver]#
    
 conf-make should contain the
 name of the GNU Make command on your system. It defaults to
 gmake. Debian users:
@@ -77,8 +70,7 @@
 AOLserver 3.3+ad13 and postgresql from apt-get may need to make
 these symlinks: ln -s
 /usr/include/postgresql/ /usr/include/pgsql and ln -s /usr/lib/postgresql
-/usr/local/pgsql)
    -[root aolserver]# export POSTGRES=/usr/local/pgsql; ./conf
+/usr/local/pgsql)
    [root aolserver]# export POSTGRES=/usr/local/pgsql; ./conf
 Building in /usr/local/aolserver
 with the following modules:
 AOLserver
@@ -99,8 +91,7 @@
 Creating  ...
 ==================================================================
 Done Building Sat Mar  8 10:31:35 PST 2003
-[root aolserver]# 
-
    This takes about 5 minutes. It builds aolserver, several
+[root aolserver]# 
    This takes about 5 minutes. It builds aolserver, several
 modules, and the database driver. (Upgraders, note that the
 postgres database driver has changed from postgres.so to
 nspostgres.so). All of the results are logged to files in
@@ -109,15 +100,14 @@
 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
+
        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]#
@@ -126,8 +116,7 @@
 chmod 750 nsd-oracle
      • -

        PostgreSQL

        -[root aolserver]# cd /usr/local/aolserver/bin
+
        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]#
@@ -139,11 +128,9 @@

    • -Install tDOM.  Download the -tDOM +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
+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'
@@ -168,15 +155,12 @@
 # aolsrc="/usr/src/aolserver-3.4"
 # ../configure --enable-threads --disable-tdomalloc \
 #   --with-aolserver=$aolsrc \
-#   --with-tcl=$aolsrc/tcl8.3.4/unix 
-
      to
      +#   --with-tcl=$aolsrc/tcl8.3.4/unix 
      to
       # ----------------------------------------------------
 aolsrc="/usr/local/src/aolserver/aolserver"
 ../configure --enable-threads --disable-tdomalloc \
   --with-aolserver=$aolsrc \
-  --with-tcl=$aolsrc/tcl8.3.2/unix
-
      And configure and compile:
      -[root unix]# sh CONFIG
+  --with-tcl=$aolsrc/tcl8.3.2/unix
      And configure and compile:
      [root unix]# sh CONFIG
 creating cache ./config.cache
 checking for memmove... yes
   (many lines omitted)
@@ -212,8 +196,7 @@
 sample-config.tcl configuration writes to the default log
 locations, so we need to give it permission to do so or it will
 fail. Grant the web group
-permission to write to /usr/local/aolserver/log and /usr/local/aolserver/servers.
      -[root root]# cd /usr/local/aolserver
+permission to write to /usr/local/aolserver/log and /usr/local/aolserver/servers.
      [root root]# cd /usr/local/aolserver
 [root aolserver]# chown -R root.web log servers
 [root aolserver]# chmod -R g+w log servers
 [root aolserver]# ls -l
@@ -239,15 +222,13 @@
 correctly. We'll use the sample config file provided with
 AOLserver. This file will attempt to guess your IP address and
 hostname. It will then start up the server at port 8000 of that IP
-address.
      -[root aolserver]# ./bin/nsd -t sample-config.tcl -u nobody -g web
+address.
      [root aolserver]# ./bin/nsd -t sample-config.tcl -u nobody -g web
 [root aolserver]# [08/Mar/2003:15:07:18][31175.8192][-main-] Notice: config.tcl: starting to read config file...
 [08/Mar/2003:15:07:18][31175.8192][-main-] Warning: config.tcl: nsssl not loaded -- key/cert files do not exist.
 [08/Mar/2003:15:07:18][31175.8192][-main-] Warning: config.tcl: nscp not loaded
 -- user/password is not set.
 [08/Mar/2003:15:07:18][31175.8192][-main-] Notice: config.tcl: finished reading
-config file.
-
      The first warning, about nsssl, can be ignored. We won't be
+config file.
      The first warning, about nsssl, can be ignored. We won't be
 using nsssl; we'll be using nsopenssl instead, and we
 haven't fully configured it yet. The nscp warning refers to the
 fact that, without a user and password in the config file, the
@@ -257,57 +238,50 @@
 computer and surfing over to your web page. If you
 browse from another computer and the sample config file didn't
 guess your hostname or ip correctly, you'll get a false
-negative test.
      -[root aolserver]# lynx localhost:8000
+negative test.
      [root aolserver]# lynx localhost:8000
 
      You should see a "Welcome to AOLserver" page. If this
 doesn't work, try going to http://127.0.0.1:8000/. If this still
 doesn't work, check out the Troubleshooting
 AOLserver section below. Note that you will not be able to
 browse to the web page from another machine, because AOLserver is
-only listening to the local address.
      Shutdown the test server:
      -[root aolserver]# killall nsd
-[root aolserver]#
-
      The killall command will
+only listening to the local address.
      Shutdown the test server:
      [root aolserver]# killall nsd
+[root aolserver]#
      The killall command will
 kill all processes with the name nsd, but clearly this is not a good tool to
 use for managing your services in general. We cover this topic in
 the Keep AOLserver
 alive section.

    • -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 +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:

       [01/Jun/2000:12:11:20][5914.4051][-nssock-] Notice: nssock: listening on http://localhost.localdomain:8000 (127.0.0.1:8000)
-[01/Jun/2000:12:11:20][5914.4051][-nssock-] Notice: accepting connections
-

      If you can find these lines, try entering the URL the server is +[01/Jun/2000:12:11:20][5914.4051][-nssock-] Notice: accepting connections

      If you can find these lines, try entering the URL the server is listening on. If you cannot find these lines, there must be an error somewhere in the file. Search for lines beginning with the word Error instead of Notice.

      The sample-config.tcl file grabs your address and hostname from your OS settings.

       set hostname        [ns_info hostname]
-set address         [ns_info address]
-

      If you get an error that nssock can't get the requested +set address [ns_info address]

      If you get an error that nssock can't get the requested address, you can set these manually. If you type 0.0.0.0, AOLserver will try to listen on all available addresses. Note: ns_info address doesn't appear to be supported in current versions of AOLserver.

       set hostname        [ns_info hostname]
 #set address         [ns_info address]
-set address 0.0.0.0
-
      +set address 0.0.0.0

    • Install Analog web file analyzer. (OPTIONAL)

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

- \ No newline at end of file + rightLink="credits" rightLabel="Next" rightTitle="Appendix C. Credits" + homeLink="index" homeLabel="Home" + upLink="install-more-software" upLabel="Up"> + \ No newline at end of file