QuickStart for Spring Framework on OpenShift with JBoss EAP 6
Java CSS Shell
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 13 commits ahead, 2 commits behind fabianofranz:master.
Latest commit 4b54614 Oct 10, 2014
Failed to load latest commit information.
.openshift V2 cart compatibility Jun 3, 2013
src EAP 6.3 support Jul 17, 2014
.gitignore Improved README.md and .gitignore Jul 3, 2012
README.md update documentation May 19, 2014
pom.xml datasource mapping May 15, 2014


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 https://www.openshift.com 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://github.com/openshift/spring-eap6-quickstart.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 (http://creativecommons.org/publicdomain/zero/1.0/)