Introduction

The ParaBank demo web application and associated web services (SOAP and REST) from Parasoft.

Build and Install

1. Build the ParaBank application using Maven (mvn clean install). After a successful build, deploy the parabank.war (located in /target) into an Apache Tomcat container.

NOTE: if using the coverage agent when running the functional/manual tests (see below), execute the build using "mvn -Dmaven.test.skip=true clean install jtest:monitor"

• ParaBank uses a built-in HyperSQL database. You must shut down all running instances of ParaBank and HyperSQL for the build to succeed. Otherwise several tests may fail, since there are a number of ports that are shared between the test instances and the real thing. See changing default ports.

Apache Tomcat notes

• Java 17 is recommended. Oracle JDK or Zulu OpenJDK is preferred.

• Apache Tomcat 9 is recommended.

• To prevent verbose cache warnings in the tomcat log::

Oct 06, 2016 3:53:33 PM org.apache.catalina.webresources.Cache getResource
WARNING: Unable to add the resource at [/WEB-INF/lib/wss4j-ws-security-stax-2.1.3.jar] to the cache because there was insufficient free space available after evicting expired cache entries - consider increasing the maximum size of the cache

Add the following to the <tomcat install>/config/context.xml make sure to place this block before </Context> tag. This setting will provide 100 MB for caching:

<Resources cachingAllowed="true" cacheMaxSize="102400" />

• To support clean re-deployments of ParaBank please add the following to the <Context> tag of the <tomcat install>/config/context.xml

<Context antiResourceLocking="true">

Changing default ports

HyperSQL listens on the default port number 9001. This port number can conflict with other instances of HyperSQL and may conflict with certain other applications such as the "Intel(R) Graphics Command Center Service". To change the port number to something else like 9002 , modify the following files located under "src/main/resources" or in a deployed WAR under "WEB-INF/classes":

• applicationContext-hsqldb.xml: This file configures HyperSQL. Look for the "hsqldb" bean and its "props". Add the following "prop", giving it the desired port number:

<prop key="server.port">9002</prop>

• jdbc.properties: This file configures the JDBC client connection used by ParaBank. Change "jdbc.url" to include the desired port number:

jdbc.url=jdbc:hsqldb:hsql://localhost:9002/parabank

• jdbcBookstore.properties: This file configures the JDBC client connection used by Bookstore. Change the following properties to include the desired port number:

jdbc.bookstoreURL=jdbc:hsqldb:hsql://localhost:9002/bookstore
jdbc.bookstorePort=9002

Apache ActiveMQ listens on the default port number 61616. This port number can conflict with other instances of ActiveMQ. To change the default port number to something else like 61617, modify the following file located under "src/main/resources" or in a deployed WAR under "WEB-INF/classes":

• applicationContext-jms.xml: This file configures ActiveMQ. Modify the port number in the "uri" for the transportConnector:

<amq:transportConnector uri="tcp://0.0.0.0:61617?transport.daemon=true" />

Test scripts

• All scripts exist in two flavors (.bat and .sh) for Windows and Linux respectively.
• All scripts should be executed from project directory and require the following Parasoft products (and versions) ** Parasoft DTP 5.3.2 ** Parasoft Jtest 10.3.2 ** Parasoft SOAtest 9.10.1

Script	Description
deploy-jtest-monitor(.sh|.bat)	Deploys the Jtest Monitor package (created using mvn goal jtest:monitor) into directory specified by APP_COVERAGE_DIR in `set-vars(.sh
jtest-ft-cov(.sh|.bat)	Executes Parasoft Jtest DTP Engine for processing monitored coverage during functional testing with SOAtest
jtest-mt-cov(.sh|.bat)	Uploads results from manual testing efforts (managed using the Parasoft Coverage Agent Manager) and processing coverage data captured during manual testing
jtest-sa-ut(.sh|.bat)	Executes Parasoft Jtest DTP Engine for Static Analysis and Unit Testing results/coverage
jtest-sa-ut-delta(.sh|.bat)	Same operation as `jtest-sa-ut(.sh
set-vars(.sh|.bat)	Utility script called by other scripts to consistently set BUILD_ID and the Project name sent to DTP
soatest(.sh|.bat)	Executes Parasoft SOAtest API and Web functional tests (including integration with Jtest DTP Engine for monitoring code coverage)

Setup

set-vars.(.sh|.bat): setup JTEST_HOME and SOATEST_HOME environment variable before running any script. all reports will be stored under target/report/ directory. on Windows, 7zip must be installed (default to C:\Program Files\7-zip) to run deploy-jtest-monitor.bat script.