I've been running OpenBD behind IIS since OpenBD version 1.3. I have made it work on IIS6, IIS7, and IIS7.5. Admittedly, I've always just sorted winged it till it worked and when it's all said and done, it still feels a bit like a hack. Maybe someone more knowledgeable can chime in an clean up some of this mess. Anyhow, here's the general outline I've been using to accomplish this:
1. Install IIS on the machine 2. Install the latest OpenBD for windows from http://openbd.viviotech.net/ During the install, use all default values except for the passwords Make sure the checkbox for the IIS connector is checked 3. Put your app in a new folder in c:\openbd\tomcat\webapps (c:\openbd\tomcat\webapps\yourappname) 4. Create a new site in IIS Set the site's physical path to your app's path. (c:\openbd\tomcat\webapps\yourappname) Let IIS create a new Application Pool (named after your app by default) Set the "Connect As..." to use an account with administrator privileges. Hit the Test Settings... button to make sure IIS isn't complaining 5. In IIS, create a virtual directory named "jakarta" and point it to c:\openbd\connector 6. In IIS, edit the Bindings for your site to include the domain name you intend to use (www.yourappname.com) 7. In IIS, find the Default Document settings for your site and add "index.cfm" to the list 8. In IIS, find the Handler Mappings settings for your site (this step is only required if you use cfchart in your app) - Add a Managed Handler and enter the following settings: - Request path: *.cfchart - Type: BonCodeIIS.BonCodeCallHandler,BonCodeIIS,Version=1.0.0.0,Culture=neutral,PublicKeyToken=ad590a40d40745cf - Name: BonCode-Tomcat-CFCHART-Handler - If cfchart isn't working, get the string from the BonCode-Tomcat-CFM-Handler settings that were installed by the viviotech installer 9. Open Windows Services and then open the Apache Tomcat OpenBD service - On the Log On tab, set it to Log on as: "This Account" and enter the credentials you used in step #4 - If you try to do this in the OpenBD-Tomcat Service Control app, the service will fail to start because this app does not have the privileges required to save this setting 10. Open c:\openbd\tomcat\conf\server.xml in a text editor - Near the bottom of the file, direct above the line containing "</Engine>" define a virtual host using the following xml: <Host name="www.yourappname.com" appBase="webapps"> <Context path="" docBase="C:\openbd\tomcat\webapps\yourappname" useHttpOnly="true" /> <Context path="/" docBase="C:\openbd\tomcat\webapps\yourappname" useHttpOnly="true" /> </Host> 11. Restart IIS and restart the OpenBD Tomcat Service 12. You can access your app using the address specified in the IIS bindings (from step #6) 13. You can access the OpenBD Administrator webapp using the following URL only from the local machine: - http://localhost:8888/bluedragon/administrator - If you wish to upgrade to the newest version of OpenBD, don't bother making any changes here just yet The steps above will get you up and running on OpenBD version 2.02 behind IIS. If you want to upgrade to the newest version, this is where things get really hacky feeling: 1. Shut down the Tomcat service 2. Install Java jdk 3. Delete everything inside of the folder c:\openbd\tomcat\webapps\ROOT 4. Download the newest OpenBD .war file from http://openbd.org and place in the ROOT folder from step #2 5. From command line, navigate to the ROOT folder and enter the following command: - "c:\Program Files\Java\jdk1.7.0_55\bin"\jar -xvf openbd.war - your path may differ depending on your jdk version 6. Open c:\openbd\tomcat\conf\web.xml in a text editor - Find the line that reads "<param-value>$${catalina.home}/../conf/bluedragon.xml</param-value>" - Change it to read "<param-value>$${catalina.home}/../tomcat/webapps/ROOT/WEB-INF/bluedragon/bluedragon.xml</param-value>" 7. Delete all of the files inside of c:\openbd\lib 8. Copy all of the files from C:\openbd\tomcat\webapps\ROOT\WEB-INF\lib to c:\openbd\lib 9. If you use any custom jars, put them in c:\openbd\lib 10. Start the Tomcat service One important thing to note: if you upgrade to the newest version of OpenBD, then all changes inside of the Bluedragon Administrator app will require a restart of the service to take effect. I figure there is a setting somewhere that monitors for changes to the bluedragon.xml file that applies settings changes on the fly. However, by default, c:\openbd\conf\bluedragon.xml is the file being monitored while C:\openbd\tomcat\webapps\ROOT\WEB-INF\bluedragon\bluedragon.xml is the file being used by your app. If I figured out how to fix this, I will post an update. If anyone else knows how to correct this, I would be very interested. While this hiccup is not a deal-breaker, it is a bit inconvenient to have to restart the service. -- -- online documentation: http://openbd.org/manual/ http://groups.google.com/group/openbd?hl=en --- You received this message because you are subscribed to the Google Groups "Open BlueDragon" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.
