Upgrade of Spring to version 5

Owned by Samuel Githengi
Last updated: May 26, 2020
2 min read

OpenSRP server is now running on the latest version of Spring 5.

OpenSRP server now runs using the spring 5, JDK 11 and tomcat 9 which are latest stable version of each product.

Its also supports deployment on Ubuntu 18.04 using current playbooks. Ubuntu 16.04 is however still supported and its possible deploy OpenSRP version 2.0 on Ubuntu 16.04

 

Deprecated Libraries

  1. Couch db unless using Atom feed and dhis2 sync functionalities

  2. Couchdb lucene

  3. Mysql or Maria db

  4. Active MQ

  5. Quartz scheduling

  6. Motech

  7. Lambda J

  8. Jackson version 1.x databind

  9. Internal OpenSRP libraries e.g opensrp-server-register, opensrp-server-reporting, opensrp-server-form

Added Maven profiles

  1. atomfeed. This was added to enable atomfeed module between OpenSRP and OpenMRS

  2. dhis2-sync. This was added to enable to enable sync of reports to DHIS2.

Enabling the 2 profiles still requires couch db to deployed

Changes to Playbooks Inventories

Playbooks have been configured to deploy OpenJDK-11 and tomcat by default.

If you still need to deploy version 1.x of OpenSRP add the below variables to the inventories

opensrp_java_packages: openjdk-8-jre opensrp_tomcat_version: 7

The variables configures OpenJDK 8 and tomcat 7 which are required for version 1.x of OpenSRP.

If version 2.x is being deployed then the variables do not defined since the role defaults will be used which will install OpenJDK 11 and tomcat 9.

Remove file in the below group_vars folders. Also remove their definition in the hosts file for your inventory. If running dhis2 sync or atomfeed retain opensrp-couchdb-servers group vars

  1. opensrp-couchdb-servers

  2. opensrp-activemq-servers

Running OpenSRP v2.x on Ubuntu 18.04

To be able to run OpenSRP on ubuntu 18.04 while using playbooks the below variables will need to be defined.

collectd_version: "5.7.*" monit_version: "1:5.*"

These allows downloading of the correct versions for the target packages on Ubuntu 18.04

Deploying version 2.x on a server with version 1.x deployed

If deploying OpenSRP version 2.x on a server that has version 1.x deployed the below needs to be implemented before running playbooks.

  1. Delete or move the folder /home/opensrp/tomcat-opensrp

  2. Stop the service tomcat7-opensrp

  3. Run playbooks to deploy version 2.x of OpenSRP