Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Quickstart for Spring Framework on OpenShift with JBoss EAP 6

branch: master

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.1 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 -a spring -t jbosseap-6.0

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/resources/META-INF/persistence.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.