Joget DX Preview Release Available for Download

Check out Joget DX, the next generation successor to Joget Workflow for faster, simpler digital transformation.

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
Connection URL: mysql://$OPENSHIFT_MYSQL_DB_HOST:$OPENSHIFT_MYSQL_DB_PORT/
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
URL: https://jogetv5-yourAccount.rhcloud.com/phpmyadmin/
Waiting for your DNS name to be available ... done
Cloning into 'jogetv5'...
Warning: Permanently added the RSA host key for IP address '54.175.209.46' 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.
  URL:        http://jogetv5-yourAccount.rhcloud.com/
Run 'rhc show-app jogetv5' for more details about your app.

Set working environment variable for Joget Workflow

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
echo ${OPENSHIFT_DATA_DIR}

A line will be printed out. Copy the value.

Getting environment variable value
echo ${OPENSHIFT_DATA_DIR}
/var/lib/openshift/115e25277628e1c35b000238/app-root/data/

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 Workflow

In your PuTTY SSH session, Execute the following commands.

export JOGET_VERSION=5.0.1
cd ~/app-root/data
wget http://dev.joget.org/downloads/enterprise/joget-enterprise-linux-$JOGET_VERSION.tar.gz
tar xvfz joget-enterprise-linux-$JOGET_VERSION.tar.gz
cd joget-enterprise-linux-$JOGET_VERSION;
apache-ant-1.7.1/bin/ant setup -Dprofile.name=default -Ddb.name=jwdb -Ddb.host=$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 Workflow

Once we executed the last command earlier "mv apache-tomcat-8.0.20/webapps/jw* ~/jbossews/webapps/", Joget Workflow 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 Workflow) 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-127.4.8.1-8080"]
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 Workflow in your web browser by pointing to your designated URL (e.g. https://jogetv5-yourAccount.rhcloud.com/jw/)

 
  • No labels