How to Configure Tomcat for Development Roy Ellis Principal QA Engineer, Progress OpenEdge Agenda Overview Installation of Tomcat Configuring WSA Configuring AIA Configuring WebSpeed Summary Q&A 2 How to Configure Tomcat for Development © 2007 Progress Software Corporation Tomcat Apache’s Java Servlet Engine Price is right Platform neutral Progress tests with Tomcat Tomcat is the Reference JSE Works great! No GUI management tools It’s a JSE not a web server 3 How to Configure Tomcat for Development © 2007 Progress Software Corporation WSA Web Services Adapter Quickly gets your OpenEdge® application into 4 the Web Services paradigm Heterogeneous connectivity Language and platform independent Standard, well-defined, and flexible client interface model How to Configure Tomcat for Development © 2007 Progress Software Corporation AIA AppServer Internet Adapter Provides Internet access for clients to access 5 an AppServer™ or Sonic Adapter application Only change to client code needed is the connection parameters Safe and easy (HTTP and HTTPS support) Accessible to ABL client, .NET™ Open Client, or Java™ Open Client. How to Configure Tomcat for Development © 2007 Progress Software Corporation WebSpeed CGI Messenger Quickest way to build Web-based 6 applications Easy to Web-enable existing OpenEdge application Highly extensible and familiar UI (web browser) Many new technologies on the web (AJAX) How to Configure Tomcat for Development © 2007 Progress Software Corporation Agenda Overview Installation of Tomcat Configuring WSA Configuring AIA Configuring WebSpeed Summary Q&A 7 How to Configure Tomcat for Development © 2007 Progress Software Corporation Installation of Tomcat http://tomcat.apache.org/ Either zip file for Windows and tar.gz file for Unix Download Tomcat 5.0.28 for 10.1B Download Tomcat 5.5.23 for 10.1C Older versions of Progress? • 4.1.+ for 9.1+ and 10.0+ • YMMV 8 How to Configure Tomcat for Development © 2007 Progress Software Corporation Installation of Tomcat Add the JAVA_HOME to the <tomcat_InstallDir>\bin\catalina.bat (sh) Start Tomcat JSE • Start Run – <tomcat_InstallDir>\bin\catalina.bat start • <tomcat_InstallDir>/bin/catalina.sh start Test Tomcat • http://localhost:8080 9 How to Configure Tomcat for Development © 2007 Progress Software Corporation Installation of Tomcat 10 How to Configure Tomcat for Development © 2007 Progress Software Corporation Installation of Tomcat 11 How to Configure Tomcat for Development © 2007 Progress Software Corporation Installing Tomcat 12 How to Configure Tomcat for Development © 2007 Progress Software Corporation Agenda Overviews Installation of Tomcat Configuring WSA Configuring AIA Configuring WebSpeed Summary Q&A 13 How to Configure Tomcat for Development © 2007 Progress Software Corporation WSA Configuration Tomcat modifications: Copy $DLC\servlets\wsa to <tomcat_InstallDir>\webapps Modify the <tomcat_InstallDir>\ webapps\wsa\WEB-INF\web.xml • Be sure Admin authentication and authorization is commented out Turn off “Require Web Services Authorization” 14 How to Configure Tomcat for Development © 2007 Progress Software Corporation WSA Configuration 15 How to Configure Tomcat for Development © 2007 Progress Software Corporation WSA Configuration 16 How to Configure Tomcat for Development © 2007 Progress Software Corporation WSA Configuration 17 How to Configure Tomcat for Development © 2007 Progress Software Corporation WSA Administration 18 How to Configure Tomcat for Development © 2007 Progress Software Corporation WSA Administration 19 How to Configure Tomcat for Development © 2007 Progress Software Corporation WSA Administration 20 How to Configure Tomcat for Development © 2007 Progress Software Corporation WSA Installation 21 How to Configure Tomcat for Development © 2007 Progress Software Corporation WSA Demonstration 22 How to Configure Tomcat for Development © 2007 Progress Software Corporation Agenda Overviews Installation of Tomcat Configuring WSA Configuring AIA Configuring WebSpeed Summary Q&A 23 How to Configure Tomcat for Development © 2007 Progress Software Corporation AIA Configuration Tomcat modifications: Add Progress environment variables to the catalina.bat (.sh) file • DLC • WRKDIR • Library Path (if UNIX, platform specific value) Copy $DLC\servlets\aia 24 <tomcat_InstallDir>\webapps Turn off “HTTPS Enabled” Turn on “Internal Administrative Command” How to Configure Tomcat for Development © 2007 Progress Software Corporation AIA Configuration 25 How to Configure Tomcat for Development © 2007 Progress Software Corporation AIA Configuration 26 How to Configure Tomcat for Development © 2007 Progress Software Corporation AIA Configuration 27 How to Configure Tomcat for Development © 2007 Progress Software Corporation AIA Configuration 28 How to Configure Tomcat for Development © 2007 Progress Software Corporation AIA Configuration 29 How to Configure Tomcat for Development © 2007 Progress Software Corporation AIA Configuration 30 How to Configure Tomcat for Development © 2007 Progress Software Corporation AIA Demonstration 31 How to Configure Tomcat for Development © 2007 Progress Software Corporation Agenda Overviews Installation of Tomcat Configuring WSA Configuring AIA Configuring WebSpeed Summary Q&A 32 How to Configure Tomcat for Development © 2007 Progress Software Corporation WebSpeed Configuration Tomcat modifications: 33 Add DLC and WRKDIR to catalina.bat (.sh) file Remove comments around CGI section of <tomcat_InstallDir>\conf\web.xml Add passShellEnvironment parameter set to “true” (Tomcat version 5.5+ only) Remove comments around CGI <servlet-mapping> section Rename <tomcat_InstallDir>\server\lib\servletscgi.renametojar to servlets-cgi.jar How to Configure Tomcat for Development © 2007 Progress Software Corporation WebSpeed Configuration Tomcat modifications: Create CGI directory 34 <tomcat_InstallDir>\webapps\ROOT\WEBINF\cgi Add messenger script to CGI directory (wspd_cgi.sh for Unix and quickcgi.pl for Windows) Turn on “Allow Administration Command” How to Configure Tomcat for Development © 2007 Progress Software Corporation WebSpeed Configuration 35 How to Configure Tomcat for Development © 2007 Progress Software Corporation WebSpeed Configuration 36 How to Configure Tomcat for Development © 2007 Progress Software Corporation WebSpeed Configuration 37 How to Configure Tomcat for Development © 2007 Progress Software Corporation WebSpeed Configuration 38 How to Configure Tomcat for Development © 2007 Progress Software Corporation WebSpeed Configuration 39 How to Configure Tomcat for Development © 2007 Progress Software Corporation WebSpeed Configuration 40 How to Configure Tomcat for Development © 2007 Progress Software Corporation WebSpeed Configuration 41 How to Configure Tomcat for Development © 2007 Progress Software Corporation WebSpeed Configuration 42 How to Configure Tomcat for Development © 2007 Progress Software Corporation WebSpeed Configuration 43 How to Configure Tomcat for Development © 2007 Progress Software Corporation WebSpeed Demonstration 44 How to Configure Tomcat for Development © 2007 Progress Software Corporation Agenda Overviews Installation of Tomcat Configuring WSA Configuring AIA Configuring WebSpeed Summary Q&A 45 How to Configure Tomcat for Development © 2007 Progress Software Corporation Summary WSA, AIA, and WebSpeed can enhance your 46 OpenEdge application Tomcat is easily available and is straight forward to use Configuring the WSA, AIA, and WebSpeed for development is not difficult How to Configure Tomcat for Development © 2007 Progress Software Corporation For More Information, go to… Tomcat documentation • http://tomcat.apache.org/tomcat-5.5doc/index.html Tomcat FAQ • http://tomcat.apache.org/faq/ Which version of Tomcat to choose • http://tomcat.apache.org/whichversion.html Perl information • http://www.perl.org/ 47 How to Configure Tomcat for Development © 2007 Progress Software Corporation Agenda Overviews Installation of Tomcat Configuring WSA Configuring AIA Configuring WebSpeed Summary Q&A 48 How to Configure Tomcat for Development © 2007 Progress Software Corporation Questions? 49 How to Configure Tomcat for Development © 2007 Progress Software Corporation Thank you for your time 50 How to Configure Tomcat for Development © 2007 Progress Software Corporation 51 How to Configure Tomcat for Development © 2007 Progress Software Corporation