Red Hat OpenShift Express

From Documentation

Red Hat OpenShift Express

Get Your OpenShift Ready

  • Apply a new OpenShift account if you don't have Red Hat Network (RHN) account.
  • Refer to OpenShift User Guide for installing required client tools.
    1. Prerequisites for Red Hat Enterprise Linux or Fedora:
    2. Prerequisites for Other Linuxes:
      • Root access
      • Ruby 1.8 or higher installed or available to be installed
      • Install the required packages: git, ruby, rubygems, and the ruby 1.8 development package.
    3. Prerequisites for Mac:
      • git
    4. Prerequisites for Windows:
      • Cygwin with the following optional components:
        • openssh
        • ruby
        • make
        • gcc
        • git
      • RubyGems

Create a OpenShift domain name

Run rhc-create-domain command to create a unique domain name for your applications.

$ rhc-create-domain -n DomainName -l rhlogin -p password
  • -n DomainName — specifies the domain that you want to create. This must contain a maximum of 16 alphanumeric characters.
  • -l rhlogin — your OpenShift Express or RHN account.
  • -p password — your OpenShift Express or RHN password.

Create a Maven Application

Run rhc-create-app command and OpenShift will create a maven project with default page automatically.

$ rhc-create-app -a AppName -t Type -l rhlogin -p password
  • -a AppName — The name of the application to create (maximum of 32 alphanumeric characters).
  • -t Type — The framework type to create. OpenShift Express currently supports the following application types:
    • php-5.3 — for PHP applications
    • wsgi-3.2 — for Web Server Gateway Interface applications
    • rack-1.1 — for Ruby Webserver Interface applications
    • perl-5.10 — for Perl applications
    • jbossas-7.0 — for JBoss AS applications (used for ZK project)
    • raw-0.1 — a raw cartridge type used to create applications of no specific type
  • -l rhlogin — your OpenShift Express or RHN account.
  • -p password — your OpenShift Express or RHN password.

Visit to see the default OpenShift page.

Import into Eclipse IDE (Optional)

  • Run the command to support to Eclipse.
$ mvn eclipse:eclipse
  • Refer here to import into Eclipse.

Deploy changes to OpenShift

To deploy an application to the cloud, you must make changes in the git directory location specified during the application creation process.
There are two options to deploy changes. You can use either option to deploy your application.

Option 1: Uploading content in a Maven src structure

This option is simple and recommended. Just push the source code with "git push" command.

$ cd AppName
$ git add .
$ git commit -a -m "Commit Message"
$ git push origin master

Then OpenShift will build your project on cloud. Visit to see your application.

Option 2: Uploading prebuilt content

To avoid OpenShift build your project automatically, you have to remove pom.xml file.

$ cd AppName
$ git rm -r pom.xml

Then copy the prebuilt war file into deployments folder and rename to ROOT.war[1]

$ cp target/prebuilt.war deployments/ROOT.war
$ git add .
$ git commit -a -m "Commit Message"
$ git push origin master

Visit to see the result

  1. By default the warName is ROOT within the pom.xml file. This will render the webapp contents at
    If you change the warName in pom.xml to app_name or if the warName in deployments folder is app_name.war, then your base URL would become

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.