project-openubl/analytics

Fuse (on Spring Boot) to create a prototype to integrate JPA (with external DB), JMA (AMQ Broker), Drools (remote invocation), Rest APIs, Swagger.

Installation

OKD

1. install OKD 3.11 following these instructions
2. oc cluster up
3. oc login -u system:admin
4. oc project openshift

Red Hat Registry Service Account

1. Set up and download an Openshift registry service account following the instructions from https://access.redhat.com/RegistryAuthentication#registry-service-accounts-for-shared-environments-4
2. oc create -f <secret>.yaml (<secret> is the name of the downloaded Openshift registry service account)
3. oc secrets link default <secret> --for=pull
4. oc secrets link builder <secret> --for=pull

Red Hat Decision Manager

Instructions from https://access.redhat.com/documentation/en-us/red_hat_decision_manager/7.3/html-single/deploying_a_red_hat_decision_manager_authoring_or_managed_server_environment_on_red_hat_openshift_container_platform/index#dm-openshift-prepare-con

1. Download from https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?downloadType=distributions&product=rhdm&productChanged=yes and unzip
2. oc create -f ./Downloads/rhdm-7.3-openshift-templates/rhdm73-image-streams.yaml
3. oc import-image rhdm73-decisioncentral-openshift:1.0
4. oc import-image rhdm73-kieserver-openshift:1.0

Red Hat AMQ Broker

Instructions from https://access.redhat.com/documentation/en-us/red_hat_amq/7.3/html-single/deploying_amq_broker_on_openshift_container_platform/index#installing-broker-ocp_broker-ocp

1. oc replace --force -f https://raw.githubusercontent.com/jboss-container-images/jboss-amq-7-broker-openshift-image/73-7.3.0.GA/amq-broker-7-image-streams.yaml
2. oc import-image amq-broker-7/amq-broker-73-openshift --from=registry.redhat.io/amq-broker-7/amq-broker-73-openshift --confirm
3. for template in amq-broker-73-basic.yaml amq-broker-73-ssl.yaml amq-broker-73-custom.yaml amq-broker-73-persistence.yaml amq-broker-73-persistence-ssl.yaml amq-broker-73-persistence-clustered.yaml amq-broker-73-persistence-clustered-ssl.yaml; do oc replace --force -f https://raw.githubusercontent.com/jboss-container-images/jboss-amq-7-broker-openshift-image/73-7.3.0.GA/templates/${template}; done

Red Hat Fuse

Instructions from https://access.redhat.com/documentation/en-us/red_hat_fuse/7.3/html-single/fuse_on_openshift_guide/index#get-started-admin-install

1. BASEURL=https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-730065-redhat-00002
2. oc create -n openshift -f ${BASEURL}/fis-image-streams.json
3. for template in eap-camel-amq-template.json eap-camel-cdi-template.json eap-camel-cxf-jaxrs-template.json eap-camel-cxf-jaxws-template.json eap-camel-jpa-template.json karaf-camel-amq-template.json karaf-camel-log-template.json karaf-camel-rest-sql-template.json karaf-cxf-rest-template.json spring-boot-camel-amq-template.json spring-boot-camel-config-template.json spring-boot-camel-drools-template.json spring-boot-camel-infinispan-template.json spring-boot-camel-rest-sql-template.json spring-boot-camel-teiid-template.json spring-boot-camel-template.json spring-boot-camel-xa-template.json spring-boot-camel-xml-template.json spring-boot-cxf-jaxrs-template.json spring-boot-cxf-jaxws-template.json ; do oc create -n openshift -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-730065-redhat-00002/quickstarts/${template}; done

Deployment

OCP templates

Using OCP Web UI

1. click on Create Project button to create a new project
2. use migration-analytics as value for the name
3. once the project has been created and added to the list of the available project, click on migration-analytics
4. from the migration-analytics Overview page, click on Import YAML / JSON button
5. copy and paste the content of the analytics_template.json (using the Raw button will let you have the plain text version of this file)
6. click on Create button
7. check that Process the template is selected (no need to select Save template)
8. click on Continue button
9. click on Create button (No need to change the form values unless the user wants to customize them)

Using oc command line tool

1. oc login -u developer
2. oc new-project migration-analytics
3. oc create -f <secret>.yaml
4. oc secrets link default <secret> --for=pull
5. oc secrets link builder <secret> --for=pull
6. oc process -f https://raw.githubusercontent.com/project-xavier/xavier-integration/master/src/main/resources/okd/analytics_template.json| oc create -f -

Decision Manager

1. go to Application -> Routes page and click on the URL in the Hostname column beside the myapp-rhdmcentr service
2. login with adminUser-SxNhwF2!
3. click on Design link
4. click on Import Project button
5. in the Repository URL field paste https://github.com/project-xavier/xavier-analytics.git
6. select sample-analytics box and click the OK button on the upper right side
7. once the import has finished, click the Build & Install button from the upper right Build menu
8. once the build has been successfully done, click on the Deploy button

Manage

PostgreSQL

1. Go to Resources -> Secrets page and select postgresql secret for the list of the secrets
2. Select Reveal Secret link to get the database-name value
3. Go to PostgreSQL pod's Terminal tab to log in doing psql <database-name>
4. To get the report entries persisted execute select * from report_data_model;
5. To DELETE ALL the report entries execute truncate table report_data_model;

AMQ Broker

AMQ Web Console

Camel routes

To enable the DEBUG level for logging, please add the environment variable logging.level.org (or whatever package you want) with value DEBUG to the the analytics-integration deployment configuration.

Undeploy

1. oc delete all,pvc,secrets -l application=migration-analytics -n migration-analytics

References