andya 2004/03/26 06:25:30 Added: jk/native2/server/dsapi INSTALL-WIN32.txt INSTALL-LINUX.txt Log: Split INSTALL.txt into INSTALL-WIN32.txt and INSTALL-LINUX.txt Revision Changes Path 1.1 jakarta-tomcat-connectors/jk/native2/server/dsapi/INSTALL-WIN32.txt Index: INSTALL-WIN32.txt =================================================================== $Id: INSTALL-WIN32.txt,v 1.1 2004/03/26 14:25:30 andya Exp $ Installing the Domino Redirector on Win32 ----------------------------------------- If necessary build dsapi_redirector2.dll as per the instructions in BUILD.txt. Copy the DLL into the Domino program directory (this is the directory, which may be called something like C:\Lotus\Domino, that contains a file called nlnotes.exe). Shortly we will tell Domino where to find this file, but before we do that we need to make some registry entries. The simplest way is to edit the supplied file dsapi_redirector2.reg, which initially will look like this Windows Registry Editor Version 5.00 [HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Dsapi Redirector\2.0] "serverRoot"="D:\\Works\\Tomcat\\jakarta-tomcat-4.1.27" "workersFile"="conf\\workers2.properties" "tomcatStart"="bin\\startup.bat" "tomcatStop"="bin\\shutdown.bat" "tomcatTimeout"="30000" Change serverRoot to reflect the location of your Tomcat installation. The other filename parameters can either be relative to serverRoot or absolute paths. Once edited double click on dsapi_redirector2.reg to enter it into the registry. Automatically Starting Tomcat ----------------------------- The last three registry entries above provide commands that the redirector DLL will use to start and stop Tomcat when the Domino http server starts and stops respectively. If you don't require this behaviour these two lines can be omitted (or deleted if you've already placed them in the registry). The Workers File ---------------- If necessary take the sample workers2.properties file from jakarta- tomcat- connectors\jk\conf and place it in the location specified in the registry settings above (typically the conf directory of your Tomcat installation). Edit the file to suit your Tomcat setup. Configuring Domino ------------------ Finally we need to configure Domino to use the DSAPI extension DLL. For those who are unfamiliar with Domino server configuration most of a server's configurable behavior is dictated by a document called the "server document" in a database called the "Public Name and Address Book" or "NAB" for short (N.B. Lotus have renamed the NAB to "Domino Directory" from Domino 5 onwards). Each Domino server will have a NAB (called names.nsf) and each NAB will have a number of server documents including one for the current server. If you have not previously configured a Domino server you may need to refer to the supplied documentation, or you may need to pass this document to your tame Domino administrator. Assuming you know your way around a Domino server document what we're going to do is actually quite simple. Open the server document for this server, place it in Edit mode, then locate the DSAPI section and the 'DSAPI filter file names' field on the Internet Protocols tab, HTTP sub- tab. Add "dsapi_redirector2.dll" to the DSAPI field, then save and close the document. Restart Domino -------------- In order to get these settings to take effect and make sure that you haven't disrupted anything else you should now restart the Domino server. If the server is running as a service and you have changed any relevant system variables (JAVA_HOME, TOMCAT_HOME, CLASSPATH) since the last time you restarted the computer you should do a complete restart now because updates to system variables are not seen by services until after a reboot. If all goes well you should see something like this on the server console when the web server starts up. 14/11/2003 13:02:18 Attempting to start Tomcat: D:\Works\Tomcat\jakarta-tomcat-4.1.27\bin\startup.bat Using CATALINA_BASE: D:\Works\Tomcat\jakarta-tomcat-4.1.27 Using CATALINA_HOME: D:\Works\Tomcat\jakarta-tomcat-4.1.27 Using CATALINA_TMPDIR: D:\Works\Tomcat\jakarta-tomcat-4.1.27\temp Using JAVA_HOME: C:\JBuilder8\jdk1.4 14/11/2003 13:02:18 Apache Tomcat Interceptor (Jakarta/DSAPI/2.0.0) loaded 14/11/2003 13:02:19 HTTP Web Server started At about the same time Tomcat should open in a new window (assuming you enabled the autostart option in the registry settings). You should now be able to visit a URL that is handled by Tomcat. Something like http://name-of-server/servlet/SnoopServlet may be available, depending on how Tomcat is configured. If that all works you're done ;-) Mailing Lists ------------- There are two mailing lists dedicated to the Domino Tomcat redirector: domino-tomcat-l: http://nomen.tagish.co.uk/mailman/listinfo/domino-tomcat-l domino-tomcat-l is a general discussion list for issues with the redirector and also wider Tomcat/Domino integration issues such as calling the Domino Java API from a Tomcat servlet. I expect it to be fairly low volume so please subscribe if you're actively using the redirector. If you have an issue with the redirector please post it to the list where it will be seen not only by me but by other users who may be able to help with any problems. domino-tomcat-announce-l: http://nomen.tagish.co.uk/mailman/listinfo/domino-tomcat-announce-l: domino-tomcat-announce-l is for announcements about the Domino Tomcat redirector. Mainly this list will be used for new releases but serious bugs will also be posted to it. This list will be very low volume; only I can post to it. I wouldn't expect more than a few posts per month. For this reason if you'd like to keep track of new redirector versions please subscribe to this list. From now on this list will be the main place to find out about new versions. Please let me know if you have any problems. Andy Armstrong, <[EMAIL PROTECTED]> 1.1 jakarta-tomcat-connectors/jk/native2/server/dsapi/INSTALL-LINUX.txt Index: INSTALL-LINUX.txt =================================================================== $Id: INSTALL-LINUX.txt,v 1.1 2004/03/26 14:25:30 andya Exp $ Installing the Domino Redirector on Linux ----------------------------------------- If necessary build libtomcat2.so as per the instructions in BUILD.txt. Copy libtomcat2.so into the Domino program directory (this is the directory, which may be called something like /opt/lotus/notes/50120/linux, that contains a file called libnotes.so). Next edit libtomcat2.properies to reflect the location of your Tomcat installation and place the edited file in the domino data directory (typically something like /opt/lotus/notesdata). libtomcat2.properties looks like this: serverRoot=/usr/local/apache/tomcat workersFile=conf/workers2.properties tomcatStart=bin/startup.sh tomcatStop=bin/shutdown.sh tomcatTimeout=30000 Automatically Starting Tomcat ----------------------------- The last three lines in libtomcat2.properties provide commands that the redirector will use to start and stop Tomcat when the Domino http server starts and stops respectively. If you don't require this behaviour these three lines can be removed. Bear in mind that if you /do/ start Tomcat from the redirector it will run with the same UID as Domino. The Workers File ---------------- If necessary take the sample workers2.properties file from jakarta- tomcat- connectors\jk\conf and place it in the location specified in libtomcat2.properties (typically the conf directory of your Tomcat installation). Edit the file to suit your Tomcat setup. Configuring Domino ------------------ Finally we need to configure Domino to use the DSAPI extension. For those who are unfamiliar with Domino server configuration most of a server's configurable behavior is dictated by a document called the "server document" in a database called the "Public Name and Address Book" or "NAB" for short (N.B. Lotus have renamed the NAB to "Domino Directory" from Domino 5 onwards). Each Domino server will have a NAB (called names.nsf) and each NAB will have a number of server documents including one for the current server. If you have not previously configured a Domino server you may need to refer to the supplied documentation, or you may need to pass this document to your tame Domino administrator. Assuming you know your way around a Domino server document what we're going to do is actually quite simple. Open the server document for this server, place it in Edit mode, then locate the DSAPI section and the 'DSAPI filter file names' field on the Internet Protocols tab, HTTP sub- tab. Add "tomcat2" to the DSAPI field, then save and close the document. Not that Domino translates "tomcat2" into "libtomcat2.so". Restart Domino -------------- Restart the Domino HTTP server and you should see the redirector load. Mailing Lists ------------- There are two mailing lists dedicated to the Domino Tomcat redirector: domino-tomcat-l: http://nomen.tagish.co.uk/mailman/listinfo/domino-tomcat-l domino-tomcat-l is a general discussion list for issues with the redirector and also wider Tomcat/Domino integration issues such as calling the Domino Java API from a Tomcat servlet. I expect it to be fairly low volume so please subscribe if you're actively using the redirector. If you have an issue with the redirector please post it to the list where it will be seen not only by me but by other users who may be able to help with any problems. domino-tomcat-announce-l: http://nomen.tagish.co.uk/mailman/listinfo/domino-tomcat-announce-l: domino-tomcat-announce-l is for announcements about the Domino Tomcat redirector. Mainly this list will be used for new releases but serious bugs will also be posted to it. This list will be very low volume; only I can post to it. I wouldn't expect more than a few posts per month. For this reason if you'd like to keep track of new redirector versions please subscribe to this list. From now on this list will be the main place to find out about new versions. Please let me know if you have any problems. Andy Armstrong, <[EMAIL PROTECTED]>
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]