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