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.
-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@@ -48,9 +48,10 @@ tarball”.
-Compile AOLserver. Compile and install -AOLserver. First, prepare the installation directory and the source -code. The message about BUILD-MODULES can be ignored.
+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@@ -65,7 +66,7 @@ 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:+tarball's default value with our default value,/usr/local/aolserver:[root aolserver]#echo "/usr/local/aolserver" > conf-inst[root aolserver]#@@ -111,12 +112,12 @@ build errors.
-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
@@ -141,9 +142,10 @@
-Install tDOM. Download the tDOM tarball, -unpack it, adjust the configuration file to match our patched -distribution of aolserver, and compile it.
+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 @@ -206,13 +208,14 @@ (OPTIONAL)
Install nspam (OPTIONAL)
-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 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.
+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 +webgroup. The +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[root aolserver]#chown -R root.web log servers[root aolserver]#chmod -R g+w log servers@@ -235,8 +238,8 @@ create one for this test. Typeecho "Welcome to AOLserver" > /usr/local/aolserver40r8/servers/server1/pages/index.html-Now, we'll run a quick test to ensure AOLserver is running -correctly. We'll use the sample config file provided with +
Now, we'll run a quick test to ensure AOLserver is running +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.
@@ -247,21 +250,21 @@ -- 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 -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 administrative -panel of AOLserver won't load. We don't plan to use it and can -ignore that error as well. Any other warning or error is unexpected -and probably a problem.
Test to see if AOLserver is working by starting
MozillaorLynxon the same +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 +administrative panel of AOLserver won't load. We don't plan +to use it and can ignore that error as well. Any other warning or +error is unexpected and probably a problem.
Test to see if AOLserver is working by starting
MozillaorLynxon the same 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.+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-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 +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:
@@ -274,10 +277,10 @@ 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 @@ -289,9 +292,9 @@ 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 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 addressdoesn't appear to be +
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] @@ -300,8 +303,8 @@
Install Analog web file analyzer. (OPTIONAL)