http-session-counter-openshift

This project in an Example of externalized HTTP session from JBoss EAP to JBoss Data Grid in Openshift environment.

There is a simple counter that was incremented on every request and the value is preserved after a restart of the application server that hosts the simple web app.

Configuration

In order to use it in an xPaaS enviroment, like Openshift, you should perform the following steps:

Set up Openshift environment

1. Download minishift from here https://developers.redhat.com/products/cdk/download/
2. Set up the CDK minishift environment: $ minishift setup-cdk.
3. Start a local cluster environment: $ minishift start --cpus 4 --memory 6144.
4. Create a demo project: $ oc new-project http-session-externalization --display-name="HTTP Session Externalization into JDG" --description="Project to demonstrate how to externalize EAP HTTP sessions into a remote JDG cluster"

Install and configure the JBoss Data Grid

5. Create the JBoss Data Grid enviroment: $ oc new-app --template=datagrid71-basic -p CACHE_NAMES=http-session-cache -p MEMCACHED_CACHE=memcached
6. Scale to cluster size of three after ensuring the first single pod came up correctly: $ oc scale --replicas=3 dc datagrid-app

Install and configure the JBoss EAP

7. Install JBoss EAP and deploy the application related to this repository: $ oc new-app --template=eap71-basic-s2i -p SOURCE_REPOSITORY_URL=https://github.com/mvocale/http-session-counter-openshift.git -p SOURCE_REPOSITORY_REF= -p CONTEXT_DIR= -e JGROUPS_PING_PROTOCOL=openshift.DNS_PING -e OPENSHIFT_DNS_PING_SERVICE_NAME=eap-app-ping -e OPENSHIFT_DNS_PING_SERVICE_PORT=8888 -e CACHE_NAME=http-session-cache
8. Scale to cluster size of two after ensuring the first single pod came up correctly: $ oc scale --replicas=2 dc eap-app

Test the application

9. Test the application using the $routePath/http-session-counter where $routePath is the result of the command $ oc get routes. The value of the counter must be 1.
10. Enable the Network tool of the Developer Tools and then re-run/refresh the same url, the counter is now set to 2.
11. Now capture the cURL command for the network call by right-clicking on the entry and choosing Copy as cURL.
12. Paste the cURL command in terminal and run it couple of times: you should obtain 3
13. Destroy and recreate the EAP pods:
    $ oc scale --replicas=0 dc eap-app (This will shutdown all the EAP pods)
    $ oc scale --replicas=2 dc eap-app (This will create two fresh new EAP pods)
    
14. Now go back to the window/terminal where you ran the step # 11 and re-run the same curl command. You should see the value incremented but the node name should be different.