-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' @@ -43,16 +45,13 @@ wget --passive http://uptime.openacs.org/aolserver-openacs/aolserver3.3oacs1.tar.gz tar xzf aolserver3.3oacs1.tar.gzThis 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”.
-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-cleancat: BUILD-MODULES: No such file or directory @@ -66,10 +65,8 @@ properly.
conf-instshould 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-makeshould contain the name of the GNU Make command on your system. It defaults togmake. Debian users: @@ -80,8 +77,7 @@ AOLserver 3.3+ad13 and PostgreSQL from apt-get may need to make these symlinks:ln -s /usr/include/postgresql/ /usr/include/pgsqlandln -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; ./confBuilding in /usr/local/aolserver with the following modules: AOLserver @@ -102,8 +98,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 @@ -119,8 +114,7 @@ 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]# @@ -129,8 +123,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]# @@ -142,11 +135,9 @@
-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' @@ -166,20 +157,15 @@ 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 -Edit the file CONFIG and change this section:
-# ---------------------------------------------------- +Edit the file CONFIG and change this section:
# ---------------------------------------------------- # 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/unixto
# ---------------------------------------------------- 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/unixAnd configure and compile:
[root unix]#sh CONFIGcreating cache ./config.cache checking for memmove... yes (many lines omitted) @@ -215,8 +201,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 thewebgroup -permission to write to/usr/local/aolserver/logand/usr/local/aolserver/servers.-[root root]#cd /usr/local/aolserver+permission to write to/usr/local/aolserver/logand/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@@ -242,15 +227,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 @@ -260,46 +243,40 @@ 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:8000You 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
killallcommand will +only listening to the local address.Shutdown the test server:
[root aolserver]#killall nsd+[root aolserver]#The
killallcommand will kill all processes with the namensd, 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)