Skip to content


Subversion checkout URL

You can clone with
Download ZIP
QuickStart for Spring Framework on OpenShift with JBoss EAP 6
Java CSS Shell
Pull request Compare This branch is 13 commits ahead, 2 commits behind fabianofranz:master.
Latest commit 4b54614 @bparees bparees Merge pull request #5 from brenton/master
EAP 6.3 support
Failed to load latest commit information.
.openshift V2 cart compatibility
deployments Creating template
src EAP 6.3 support
.gitignore Improved and .gitignore update documentation
pom.xml datasource mapping

Spring Framework on OpenShift with JBoss EAP 6

What is it?

This is a sample Maven 3 project to help you get your foot in the door developing with Spring on JBoss Enterprise Application Platform 6 or JBoss AS 7.1, deployable on OpenShift (PaaS by Red Hat).

This project is setup to allow you to create a compliant Spring 3.2 application using Spring MVC, JPA 2.0 and Bean Validation 1.0. It includes a persistence unit and some sample persistence and transaction code to introduce you to database access in enterprise Java.


1) Create an account at and follow the Getting Started guide to install the OpenShift command line tools.

2) Create a JBoss Enterprise Application Platform 6 app:

rhc app create spring jbosseap-6

3) Add this upstream repo:

cd spring
git remote add upstream -m master git://
git pull -s recursive -X theirs upstream master

4) Remove the default index.html file and commit:

git rm src/main/webapp/index.html
git commit -m 'Removed default index.html'

5) Then push the repo upstream:

git push

6) That's it, you can now browse to your application at:


Setting up a database

The example uses a H2 database configured and deployed by the application. You can easily change it to MySQL or PostgreSQL (available on OpenShift as cartridges):

1) Add a database cartridge to your OpenShift app (mysql-5.1 or postgresql-8.4):

rhc cartridge add -a spring -c mysql-5.1

2) Edit src/main/webapp/WEB-INF/jboss-web.xml to use the appropriate datasource (java:jboss/datasources/MysqlDS or java:jboss/datasources/PostgreSQLDS):


3) Commit and push your changes:

git commit -a -m 'Added MySQL database support'
git push


This code is dedicated to the public domain to the maximum extent permitted by applicable law, pursuant to CC0 (

Something went wrong with that request. Please try again.