Skip to end of metadata
Go to start of metadata

Create new App

On your Windows command prompt, run this command to create a new OpenShift App.

We will call the app as jogetv5. You can change to a name that you prefer. We are installing 3 cartridges (tomcat7 mysql-5.5 phpmyadmin) on the creation of the App.

Create new App
rhc app-create jogetv5 tomcat7 mysql-5.5 phpmyadmin
Execution output
Using jbossews-2.0 (Tomcat 7 (JBoss EWS 2.0)) for 'tomcat7'
Using phpmyadmin-4 (phpMyAdmin 4.0) for 'phpmyadmin'
Application Options
Domain:     yourAccount
Cartridges: jbossews-2.0, mysql-5.5, phpmyadmin-4
Gear Size:  default
Scaling:    no
Creating application 'jogetv5' ... done
  MySQL 5.5 database added.  Please make note of these credentials:
       Root User: admin
   Root Password: 1234
   Database Name: jogetv5
You can manage your new MySQL database by also embedding phpmyadmin.
The phpmyadmin username and password will be the same as the MySQL credentials above.
Please make note of these MySQL credentials again:
  Root User: admin
  Root Password: 1234
Waiting for your DNS name to be available ... done
Cloning into 'jogetv5'...
Warning: Permanently added the RSA host key for IP address '' to the list of known hosts.
remote: Counting objects: 41, done.
remote: Compressing objects: 100% (32/32), done.
remote: Total 41 (delta 1), reused 41 (delta 1)
Receiving objects: 100% (41/41), 51.34 KiB | 0 bytes/s, done.
Resolving deltas: 100% (1/1), done.
Checking connectivity... done.
Your application 'jogetv5' is now available.
Run 'rhc show-app jogetv5' for more details about your app.

Set working environment variable for Joget 

SSH into your App. If you need help getting SSH to work on Windows, please see Remote Connection (SSH).

In your PuTTY SSH session, Execute the following command.

Getting environment variable value

A line will be printed out. Copy the value.

Getting environment variable value

Going back to your Windows command prompt, copy the value earlier and put into Dwflow.home variable the command below. Do remember to put your App name at the end too.

Set environment variable value
rhc env set JAVA_OPTS_EXT="-Djava.awt.headless=true -Dwflow.home=/var/lib/openshift/115e25277628e1c35b000238/app-root/data/wflow/" -a jogetv5
Execution output
Setting environment variable(s) ... done

Obtaining Joget 

In your PuTTY SSH session, Execute the following commands.

export JOGET_VERSION=5.0.1
cd ~/app-root/data
tar xvfz joget-enterprise-linux-$JOGET_VERSION.tar.gz
cd joget-enterprise-linux-$JOGET_VERSION;
apache-ant-1.7.1/bin/ant setup$OPENSHIFT_MYSQL_DB_HOST -Ddb.port=3306 -Ddb.user=$OPENSHIFT_MYSQL_DB_USERNAME -Ddb.password=$OPENSHIFT_MYSQL_DB_PASSWORD;
cp -rf wflow/ $OPENSHIFT_DATA_DIR/
mv apache-tomcat-8.0.20/webapps/jw* ~/jbossews/webapps/

Starting up Joget 

Once we executed the last command earlier "mv apache-tomcat-8.0.20/webapps/jw* ~/jbossews/webapps/", Joget webapp is being initialized right away.

However, it is highly recommended that we restart the server first to make sure that everything would works persistently.

Issue the following command in your Windows command prompt.

Restart App
rhc app-restart jogetv5

You can monitor its deployment of the web server by tailing the server log.

Execute the following command to tail the server log in PuTTY.

Tail server log
tail $OPENSHIFT_LOG_DIR\jbossews.log -f

You will see the following messages with "Server startup in x ms" indicating that the new web app (Joget) has been deployed.

Log messages
Jun 13, 2016 2:32:37 AM org.apache.catalina.startup.HostConfig deployWAR
INFO: Deployment of web application archive /var/lib/openshift/575e25277628e1c35b000238/app-root/runtime/dependencies/jbossews/webapps/jw.war has finished in 288,826 ms
Jun 13, 2016 2:32:37 AM org.apache.coyote.AbstractProtocol start
INFO: Starting ProtocolHandler ["http-bio-"]
Jun 13, 2016 2:32:38 AM org.apache.catalina.startup.Catalina start
INFO: Server startup in 298636 ms

Once the server is up, you can now browse to Joget in your web browser by pointing to your designated URL (e.g.

  • No labels