Index: openacs-4/packages/acs-core-docs/www/install-nsopenssl.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-nsopenssl.adp,v diff -u -r1.4 -r1.5 --- openacs-4/packages/acs-core-docs/www/install-nsopenssl.adp 25 Apr 2018 08:38:27 -0000 1.4 +++ openacs-4/packages/acs-core-docs/www/install-nsopenssl.adp 3 Sep 2024 15:37:32 -0000 1.5 @@ -1,17 +1,23 @@ -{/doc/acs-core-docs {ACS Core Documentation}} {Install nsopenssl} +{/doc/acs-core-docs/ {ACS Core Documentation}} {Install nsopenssl} Install nsopenssl +

-Install nsopenssl

<authorblurb>

By Joel Aufrecht and -Malte Sussdorff -

</authorblurb>

This AOLserver module is required if you want people to connect +Install nsopenssl

+

By Joel Aufrecht and Malte Sussdorff +

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

This AOLserver module is required if you want people to connect to your site via https. These commands compile nsopenssl and install it, along with a Tcl helper script to handle https connections. You will also need ssl certificates. Because those @@ -32,20 +38,20 @@ [root nsopenssl-2.1]# cp nsopenssl.so /usr/local/aolserver/bin [root nsopenssl-2.1]# cp https.tcl /usr/local/aolserver/modules/tcl/ [root nsopenssl-2.1]# -cd /usr/local/src/aolserver +cd /usr/local/src/aolserver wget --passive http://www.scottg.net/download/nsopenssl-2.1.tar.gz tar xzf nsopenssl-2.1.tar.gz cd nsopenssl-2.1 make OPENSSL=/usr/local/ssl cp nsopenssl.so /usr/local/aolserver/bin -cp https.tcl /usr/local/aolserver/modules/tcl/ -

For Debian (more information):

apt-get install libssl-dev
+cp https.tcl /usr/local/aolserver/modules/tcl/
+

For Debian (more information):

apt-get install libssl-dev
 cd /usr/local/src/aolserver
 tar xzf /tmp/nsopenssl-2.1.tar.gz
 cd nsopenssl-2.1
 make OPENSSL=/usr/lib/ssl
 cp nsopenssl.so /usr/local/aolserver/bin
-cp https.tcl /usr/local/aolserver/modules/tcl/
+cp https.tcl /usr/local/aolserver/modules/tcl/

Install on AOLserver4

You will need the AOLserver4 source in /usr/local/src/aolserver/aolserver and @@ -54,7 +60,7 @@ with AOLSERVER=/point/to/aolserver. We are including both here, because while this module still requires INST, if one just uses AOLSERVER, the default value would be used and -could intefere with another existing installation.

FreeBSD note: build nsopenssl with gmake install OPENSSL=/usr/local/openssl +could interfere with another existing installation.

FreeBSD note: build nsopenssl with gmake install OPENSSL=/usr/local/openssl AOLSERVER=/usr/local/aolserver4r10 

[root bin]# cd /usr/local/src/aolserver
 [root aolserver]# cvs -d:pserver:anonymous\@cvs.sourceforge.net:/cvsroot/aolserver login
@@ -65,32 +71,32 @@
 (many lines omitted)
 [root nsopenssl-2.1]# make install OPENSSL=/usr/local/ssl AOLSERVER=/usr/local/aolserver4r10 INST=/usr/local/aolserver4r10
 [root nsopenssl-2.1]#
-cd /usr/local/src/aolserver
+cd /usr/local/src/aolserver
 cvs -d:pserver:anonymous\@cvs.sourceforge.net:/cvsroot/aolserver login
 cvs -d:pserver:anonymous\@cvs.sourceforge.net:/cvsroot/aolserver co nsopenssl
 cd nsopenssl
 make OPENSSL=/usr/local/ssl 
-make install OPENSSL=/usr/local/ssl AOLSERVER=/usr/local/aolserver AOLSERVER=/usr/local/aolserver4r10
+make install OPENSSL=/usr/local/ssl AOLSERVER=/usr/local/aolserver AOLSERVER=/usr/local/aolserver4r10

If you have problems starting your server with nsopenssl.so due to missing libssl.so.0.9.7 (or lower), you have to create symlinks

 [root nsopenssl]# cd /usr/local/aolserver/lib
 [root lib]# ln -s /usr/local/ssl/lib/libssl.so.0.9.7 libssl.so.0.9.7
 [root lib]# ln -s /usr/local/ssl/lib/libcrypto.so.0.9.7 libcrypto.so.0.9.7
 [root lib]#
-cd /usr/local/aolserver/lib
+cd /usr/local/aolserver/lib
 ln -s /usr/local/ssl/lib/libssl.so.0.9.7 libssl.so.0.9.7
 ln -s /usr/local/ssl/lib/libcrypto.so.0.9.7 libcrypto.so.0.9.7
-
+

SSL support must be enabled separately in each OpenACS server (Generate ssl certificates.

If your ports for SSL are privileged (below 1024), you will have to start AOLserver with prebinds for both your HTTP and your HTTPS -port (usually by adding -b your_ip:your_http_port,your_ip:your_https_port - to -the nsd call. If you are using daemontools, this can be changed in -your etc/daemontools/run -file).

To enable SSL support in your server, make sure your +port (usually by adding -b +your_ip:your_http_port,your_ip:your_https_port + to the +nsd call. If you are using daemontools, this can be changed in your +etc/daemontools/run file).

To enable SSL support in your server, make sure your etc/config.tcl file has a section on "OpenSSL 3 with AOLserver4". If that section is not present, try looking at the README file in /usr/local/src/aolserver/nsopenssl.