| Prev | Chapter�3.�Complete Installation | Next |
|---|
by Vinod Kurup
+Unpack the Aolserver tarball.�Download the aolserver tarball and unpack it.
[root@yourserver root]# cd /usr/local/src -[root@yourserver src]# wget --passive http://uptime.openacs.org/aolserver-openacs/aolserver3.3oacs1.tar.gz +
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'
Resolving uptime.openacs.org... done.
@@ -13,18 +13,18 @@
100%[====================================>] 3,858,074 66.56K/s ETA 00:00
15:39:05 (66.56 KB/s) - `aolserver3.3oacs1.tar.gz' saved [3858074/3858074]
-[root@yourserver src]# tar xzf aolserver3.3oacs1.tar.gz
-[root@yourserver src]#
-cd /usr/local/src
+[root src]# tar xzf aolserver3.3oacs1.tar.gz
+[root src]#
+cd /usr/local/src
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”.
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 +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”.
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@yourserver 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 @@ -35,8 +35,8 @@ the environment variables 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@yourserver aolserver]# echo "/usr/local/aolserver" > conf-inst -[root@yourserver aolserver]#
conf-make should contain the + 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: ln -s /usr/bin/make /usr/bin/gmake.
Set an environment variable that the nspostgres driver Makefile needs to compile correctly and run @@ -46,7 +46,7 @@ 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@yourserver aolserver]# export POSTGRES=/usr/local/pgsql; ./conf + and ln -s /usr/lib/postgresql /usr/local/pgsql)[root aolserver]# export POSTGRES=/usr/local/pgsql; ./conf Building in /usr/local/aolserver with the following modules: aolserver @@ -67,28 +67,28 @@ Creating ... ================================================================== Done Building Sat Mar 8 10:31:35 PST 2003 -[root@yourserver aolserver]#+[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 /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.0b4/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
+ to use both databases, install both.Oracle
[root aolserver]# cd /usr/local/aolserver/bin
+[root bin]# cp /tmp/openacs-5.0.0b4/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle
+[root bin]# chmod 750 nsd-oracle
+[root bin]#
+cd /usr/local/aolserver/bin
cp /tmp/openacs-5.0.0b4/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle
-chmod 750 nsd-oraclePostgreSQL
[root@yourserver aolserver]# cd /usr/local/aolserver/bin
-[root@yourserver bin]# cp /tmp/openacs-5.0.0b4/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
+chmod 750 nsd-oracle
PostgreSQL
[root aolserver]# cd /usr/local/aolserver/bin
+[root bin]# cp /tmp/openacs-5.0.0b4/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres
+[root bin]# chmod 755 nsd-postgres
+[root bin]#
+cd /usr/local/aolserver/bin
cp /tmp/openacs-5.0.0b4/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres
-chmod 755 nsd-postgres
Install tDOM.�Download the tDOM +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@yourserver root]# cd /usr/local/src -[root@yourserver src]# wget --passive http://www.tdom.org/tDOM-0.7.8.tar.gz + 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' Resolving www.tdom.org... done. @@ -100,42 +100,42 @@ 16:41:04 (138.06 KB/s) - `tDOM-0.7.8.tar.gz' saved [826613/826613] -[root@yourserver src]# tar xzf tDOM-0.7.8.tar.gz -[root@yourserver src]# cd tDOM-0.7.8/unix -[root@yourserver unix]# -cd /usr/local/src +[root src]# tar xzf tDOM-0.7.8.tar.gz +[root src]# cd tDOM-0.7.8/unix +[root unix]# +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/unixEdit the file CONFIG and change this section:
# ---------------------------------------------------- +cd tDOM-0.7.8/unixEdit 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/unixto
# ---------------------------------------------------- aolsrc="/usr/local/src/aolserver/aolserver" ../configure --enable-threads --disable-tdomalloc \ --with-aolserver=$aolsrc \ - --with-tcl=$aolsrc/tcl8.3.2/unixAnd configure and compile:
[root@yourserver unix]# sh CONFIG + --with-tcl=$aolsrc/tcl8.3.2/unixAnd configure and compile:
[root unix]# sh CONFIG creating cache ./config.cache checking for memmove... yes (many lines omitted) creating Makefile creating tdomConfig.sh -[root@yourserver unix]# make +[root 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.8.so /usr/local/aolserver/bin/ -[root@yourserver unix]# cd /usr/local/aolserver/bin/ -[root@yourserver bin]# ln -s libtdom0.7.8.so libtdom.so -[root@yourserver bin]# +[root unix]# cp libtdom0.7.8.so /usr/local/aolserver/bin/ +[root unix]# cd /usr/local/aolserver/bin/ +[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
Install nsopenssl +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 AOLserver, we'll run it using the sample-config.tcl file provided in the AOLserver distribution, under the nobody user and web @@ -144,10 +144,10 @@ or it will fail. Grant the web group permission to write to /usr/local/aolserver/log and - /usr/local/aolserver/servers.
[root@yourserver root]# cd /usr/local/aolserver -[root@yourserver aolserver]# chown -R root.web log servers -[root@yourserver aolserver]# chmod -R g+w log servers -[root@yourserver aolserver]# ls -l + /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 total 32 drwxr-sr-x 2 root root 4096 Mar 8 12:57 bin drwxr-xr-x 3 root root 4096 Mar 8 10:34 include @@ -156,17 +156,17 @@ drwxr-sr-x 3 root root 4096 Mar 8 10:31 modules -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@yourserver aolserver]# -+[root aolserver]# + cd /usr/local/aolserver chown -R root.web log servers chmod -R g+w log servers -ls -lNow, we'll run a quick test to ensure AOLserver is running +ls -l
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.
[root@yourserver aolserver]# ./bin/nsd -t sample-config.tcl -u nobody -g web
-[root@yourserver aolserver]# [08/Mar/2003:15:07:18][31175.8192][-main-] Notice: config.tcl: starting to read config file...
+ IP 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.
@@ -181,15 +181,15 @@
didn't guess your hostname or ip correctly, you'll get a
false negative test.
- [root@yourserver aolserver]# lynx localhost:8000
+
[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@yourserver aolserver]# killall nsd
-[root@yourserver aolserver]#
+
Shutdown the test server:
[root aolserver]# killall nsd
+[root aolserver]#
The killall command will kill
all processes with the name nsd,
@@ -230,4 +230,4 @@
set hostname [ns_info hostname]
#set address [ns_info address]
set address 0.0.0.0
Install - Analog web file analyzer. (OPTIONAL)