Install AOLserver 4

+ +Install AOLserver 4

Prev	Chapter�3.�Complete Installation	Next

Install AOLserver 4

by Malte Sussdorff

OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff.

Check suitability of previously installed TCL.�Start tcl (type tclsh or find it using which tclsh). @@ -45,8 +46,8 @@ [root aolserver]# cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co nspostgres [root aolserver]# cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co nssha1 [root aolserver]# cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/aolserver co -r v2_7 nsoracle -[root aolserver]# wget http://www.tdom.org/tDOM-0.7.8.tar.gz -[root aolserver]# tar xvfz tDOM-0.7.8.tar.gz +[root aolserver]# wget http://www.tdom.org/files/tDOM-0.8.0.tar.gz +[root aolserver]# tar xvfz tDOM-0.8.0.tar.gz [root root]# cd /usr/local/src mkdir aolserver40r10 @@ -63,26 +64,23 @@ cd /usr/local/src/aolserver40r10/aolserver ./configure --prefix=/usr/local/aolserver40r10 --with-tcl=/usr/local/lib/ make install -
If this is the only version of AOLserver in use, or is the default version, create a symlink. If not, then be sure to use /usr/local/aolserver40r10 instead of /usr/local/aolserver in future steps and check any scripts and makefiles you run to ensure they use the correct path.
```
[root aolserver]# ln -s /usr/local/aolserver40r10 /usr/local/aolserver
```
Configure, compile and install the modules.� +
If you are using gcc 4 or later, see http://openacs.org/forums/message-view?message_id=309814
If this is the only version of AOLserver in use, or is the default version, create a symlink. If not, then be sure to use /usr/local/aolserver40r10 instead of /usr/local/aolserver in the steps below and check both scripts and makefiles to ensure they use the correct path.
```
[root aolserver]# ln -s /usr/local/aolserver40r10 /usr/local/aolserver
```

Configure, compile and install the modules.�

OpenACS looks for the Oracle driver at /usr/local/aolserver/bin/ora8.so, but some versions of nsoracle may create nsoracle.so instead. In that case, you can symlink (ln -s nsoracle.so ora8.so) to fix it.

Install nscache

[root aolserver]# cd /usr/local/src/aolserver40r10/nscache
-[root nscache]# make install AOLSERVER=/usr/local/aolserver40r10

Install nsoracle (if you want to use Oracle)

[root nscache]# cd ../nsoracle
-[root nsoracle]# make install AOLSERVER=/usr/local/aolserver40r10

Install nspostgres (if you want to use Postgres)

[root nscache]# cd ../nspostgres
-[root nspostgres]# export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/pgsql/lib[root nspostgres]# make install POSTGRES=LSB ACS=1 INST=/usr/local/aolserver40r10  AOLSERVER=/usr/local/aolserver40r10
+[root nscache]# make install AOLSERVER=/usr/local/aolserver

Install nsoracle (if you want to use Oracle)

[root nscache]# cd ../nsoracle
+[root nsoracle]# make install AOLSERVER=/usr/local/aolserver

Install nspostgres (if you want to use Postgres)
```
[root nscache]# cd ../nspostgres
+[root nspostgres]# export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/pgsql/lib:/usr/local/aolserver/lib
+[root nspostgres]# make install POSTGRES=LSB ACS=1 INST=/usr/local/aolserver  AOLSERVER=/usr/local/aolserver
               
```
If you get errors like:
```
nspostgres.c: In function `Ns_PgTableList':
-nspostgres.c:679: warning: passing arg 3 of `Tcl_DStringAppend' as signed due to prototype
```
then PostGreSQL is probably not in the standard location. The location of PostGreSQL is very dependent on which method was used to install it. To correct the problem, replace LSB with the path to the path to your PostGreSQL installation. Often this is /usr/local/pgsql.
Another possibility is that you may need to set - the LD_LIBRARY_PATH environmental variable. You may - still get warnings, but sometimes this will fix things - enough to work.
```
[root nspostgres]# export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/pgsql/lib
-              
```
You can use the +nspostgres.c:679: warning: passing arg 3 of `Tcl_DStringAppend' as signed due to prototype
then PostGreSQL is probably not in the standard location. The location of PostGreSQL is very dependent on which method was used to install it. To correct the problem, replace LSB with the path to the path to your PostGreSQL installation. Often this is /usr/local/pgsql.
You can use the ldd command to verify that all libraries are linked in: - ldd /usr/local/src/aolserver40r8/nspostgres/nspostgres.so -
If you run into problems with libpq.a do the following (and repeat the step above)
```
[root nspostgres]# ranlib /usr/local/pgsql/lib/libpq.a
```
If you run into problems with the linker, edit the Makefile. Add -lnsdb to the MODLIBS var.
```
MODLIBS = -L$(PGLIB) -lpq -lnsdb
```

Install nssha1

[root nspostgres]# cd ../nssha1

Now install nssha1:

[root nssha1]# make install AOLSERVER=/usr/local/aolserver40r10

If the make fails you will have to edit nssha1.c. Comment out the following 2 lines (lines 139-140):

// typedef unsigned int u_int32_t;
-// typedef unsigned char u_int8_t;

Install tDOM

[root nssha1]# cd ../tDOM-0.7.8/unix

Edit the CONFIG file. Uncomment the instructions meant for AOLserver 4, but edit it to look like this:

../configure --enable-threads --disable-tdomalloc
-          --prefix=/usr/local/aolserver40r10 --with-tcl=/usr/local/lib

Now you can compile and configure tDOM

[root unix]# sh CONFIG + ldd /usr/local/src/aolserver40r10/nspostgres/nspostgres.so +

If you run into problems with libpq.a do the following (and repeat the step above)

[root nspostgres]# ranlib /usr/local/pgsql/lib/libpq.a

If you run into problems with the linker, edit the Makefile. Add -lnsdb to the MODLIBS var.

MODLIBS = -L$(PGLIB) -lpq -lnsdb

Install nssha1

[root nspostgres]# cd ../nssha1

Now install nssha1:

[root nssha1]# make install AOLSERVER=/usr/local/aolserver

If the make fails you will have to edit nssha1.c. Comment out the following 2 lines (lines 139-140):

// typedef unsigned int u_int32_t;
+// typedef unsigned char u_int8_t;

Install tDOM
```
[root nssha1]# cd ../tDOM-0.8.0/unix
```
Edit the CONFIG file. Uncomment the instructions meant for AOLserver 4, but edit it to look like this:
```
../configure --enable-threads --disable-tdomalloc
+          --prefix=/usr/local/aolserver --with-tcl=/usr/local/lib
```
Note that the location of the Tcl library may vary on differnt platforms (e.g. for Debian 3.0: --with-tcl=/usr/lib/tcl8.4)
Now you can compile and configure tDOM
```
[root unix]# sh CONFIG
 [root unix]# make install
```

Add a database-specific wrapper script.�This script sets database environment variables before starting @@ -96,17 +94,17 @@ OpenACS code, but don't forget to come back. (Note to maintainers: this should be moved to the next page and integrated into the text there) -

Oracle

[root aolserver]# cd /usr/local/aolserver40r8/bin -[root bin]# cp /tmp/openacs-5.2.0d1/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle +

Oracle

[root aolserver]# cd /usr/local/aolserver/bin
+[root bin]# cp /tmp/openacs-5.2.3b1/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle
 [root bin]# chmod 750 nsd-oracle
 [root bin]#
-cd /usr/local/aolserver40r10/bin
-cp /var/tmp/openacs-5.2.0d1/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle
-chmod 750 nsd-oracle

PostgreSQL

[root aolserver]# cd /usr/local/aolserver40r10/bin
-[root bin]# cp /var/tmp/openacs-5.2.0d1/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres
+cd /usr/local/aolserver/bin
+cp /var/tmp/openacs-5.2.3b1/packages/acs-core-docs/www/files/nsd-oracle.txt ./nsd-oracle
+chmod 750 nsd-oracle

PostgreSQL

[root aolserver]# cd /usr/local/aolserver/bin
+[root bin]# cp /var/tmp/openacs-5.2.3b1/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres
 [root bin]# chmod 755 nsd-postgres
 [root bin]#
-cd /usr/local/aolserver40r10/bin
-cp /var/tmp/openacs-5.2.0d1/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres
+cd /usr/local/aolserver/bin
+cp /var/tmp/openacs-5.2.3b1/packages/acs-core-docs/www/files/nsd-postgres.txt ./nsd-postgres
 chmod 755 nsd-postgres

You may need to edit these scripts if you are not using - /usr/local/aolserver as the directory of Aolserver4.

Change startup script (optional).�If you want to run AOLserver on a port below 1024 (normally, for a webserver you will use 80), you will have to change the /var/lib/aolserver/service0/etc/daemontools/run script according to the documentation found there (namely: Add the -b yourip:yourport switch)
Test AOLserver.

($Id$)

Prev	Home	Next
Install PostgreSQL	Up	Install OpenACS 5.2.0d1

docs@openacs.org

View comments on this page at openacs.org + /usr/local/aolserver as the directory of Aolserver4.

Change startup script (optional).�If you want to run AOLserver on a port below 1024 (normally, for a webserver you will use 80), you will have to change the /var/lib/aolserver/service0/etc/daemontools/run script according to the documentation found there (namely: Add the -b yourip:yourport switch)

Test AOLserver.

($Id$)