| Prev | Chapter�3.�Installing on Unix/Linux | Next |
|---|
+
This page assumes you have downloaded aolserver to to -/tmp/aolserver3.3oacs1.tar.gz. If not, -get it. It also assumes you are following the 5.0.0-P or 5.0.0-O Reference Platform installation, using Red Hat 8.0. Places where other systems are different are noted.
- As root, untar +
Unpack the Aolserver tarball.�Download the aolserver tarball to /tmp/aolserver3.3oacs1.tar.gz. As root, untar aolserver3.3oacs1.tar.gz into /usr/local/src. -
[root@yourserver root]# cd /usr/local/src [root@yourserver src]# tar xzf /tmp/aolserver3.3oacs1.tar.gz [root@yourserver src]#cd /usr/local/src -tar xzf /tmp/aolserver3.3oacs1.tar.gz
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 +tar xzf /tmp/aolserver3.3oacs1.tar.gz
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@yourserver root]# cd /usr/local/src/aolserver [root@yourserver aolserver]# ./conf-clean cat: BUILD-MODULES: No such file or directory @@ -65,25 +61,64 @@ ================================================================== Done Building Sat Mar 8 10:31:35 PST 2003 [root@yourserver 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 /usr/local/src/aolserver/log. If you run into problems running AOLserver, check these files for build errors.
Add a database-specific wrapper script. This script + 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 /usr/local/src/aolserver/log. If you run into problems running AOLserver, check these files for 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@yourserver aolserver]# cd /usr/local/aolserver/bin -[root@yourserver bin]# cp /tmp/openacs-5.0.0/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle +[root@yourserver bin]# cp /tmp/openacs-4.7.0d/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle [root@yourserver bin]# chmod 750 nsd-oracle [root@yourserver bin]#cd /usr/local/aolserver/bin -cp /tmp/openacs-5.0.0/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle +cp /tmp/openacs-4.7.0d/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle chmod 750 nsd-oracle
PostGreSQL
[root@yourserver aolserver]# cd /usr/local/aolserver/bin -[root@yourserver bin]# cp /tmp/openacs-5.0.0/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres +[root@yourserver bin]# cp /tmp/openacs-4.7.0d/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres [root@yourserver bin]# chmod 755 nsd-postgres [root@yourserver bin]#cd /usr/local/aolserver/bin -cp /tmp/openacs-5.0.0/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres -chmod 755 nsd-postgres
Install nsopenssl - (OPTIONAL)
Install Full Text Search with OpenFTS (OPTIONAL)
In order to test AOLserver, we'll run it using the +cp /tmp/openacs-4.7.0d/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres +chmod 755 nsd-postgres
Install tDOM.�Download the tDOM + tarball to + /tmp/tDOM-0.7.7.tar.gz, + unpack it, adjust the configuration file to match our patched + distribution of aolserver, and compile it.
[root@yourserver root]# cd /usr/local/src +[root@yourserver src]# tar xzf /tmp/tDOM-0.7.7.tar.gz +[root@yourserver src]# cd tDOM-0.7.7/unix +[root@yourserver unix]# +cd /usr/local/src +tar xzf /tmp/tDOM-0.7.7.tar.gz +cd unix
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
+
# ---------------------------------------------------- +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@yourserver unix]# sh CONFIG +creating cache ./config.cache +checking for memmove... yes + (many lines omitted) +creating Makefile +creating tdomConfig.sh +[root@yourserver unix]# make +gcc -pipe -DHAVE_UNISTD_H=1 -DHAVE_LIMITS_H=1 -DTCL_THREADS=1 +-DHAVE_GETCWD=1 -DHAVE_OPENDIR=1 -DHAVE_STRSTR=1 -DHAVE_STRTOL=1 + (many lines omitted) + -Wl,-rpath,/usr/local/lib -o tcldomsh;\ +fi +[root@yourserver unix]# cp libtdom0.7.7.so /usr/local/aolserver/bin/ +sh CONFIG +make +cp libtdom0.7.7.so /usr/local/aolserver/bin/
+
Install nsopenssl + (OPTIONAL)
Install Full Text Search with OpenFTS (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 @@ -143,12 +178,11 @@ 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. -
If you can't view the welcome page, it's likely there's a +
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.2051][-nssock-] Notice: nssock: listening on http://localhost.localdomain:8000 (127.0.0.1:8000) [01/Jun/2000:12:11:20][5914.2051][-nssock-] Notice: accepting connections
@@ -177,5 +211,5 @@
set hostname [ns_info hostname] #set address [ns_info address] -set address 0.0.0.0
Install - Analog web file analyzer. (OPTIONAL)
Install + Analog web file analyzer. (OPTIONAL)