# Important Breaking Upgrades **URL:** \ **Category:** Development\ **Tags:** dev\ **Created:** [February 21, 2025, 10:29am UTC](https://talk.openelis-global.org/t/important-breaking-upgrades/1176 "2025-02-21T10:29:33Z")\ **Posts on this page:** 10\ **Page:** 1
**Author:** ![Moses\_Mutesasira](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.openelis-global.org/moses_mutesasira/32/72_2.png) [@Moses\_Mutesasira](https://talk.openelis-global.org/u/Moses_Mutesasira)\ **Post date:** [February 21, 2025, 10:29am UTC](https://talk.openelis-global.org/t/important-breaking-upgrades/1176/1 "2025-02-21T10:29:33Z")
Hello Community , Following the Release of [3.1.0.4](https://talk.openelis-global.org/t/openelis-global2-3-1-0-4-release/1169/1) , We are soon going to do an Upgrade **(3.2.0.0)** that will be breaking your existing PRs and Local changes. The [Upgrade](https://github.com/I-TECH-UW/OpenELIS-Global-2/pull/1500) involves upgrading to Java 21 ,Tomcat 10 , Spring 6.x , hiberanate 6.x , Jarkata EE api ### What to do 1. You will Upgrade to Java 21 2. The main breaking change is the Java EE upgrade Youll have to update your imports from `javax` to `jarkata`. ie Note that the rest of the [development process](https://github.com/I-TECH-UW/OpenELIS-Global-2?tab=readme-ov-file#running-openelis-global2-using-docker-compose-with-locally-compiledbuilt-artifacts-ie-the-war-file-and-react-code) remains the same . The current verion **(3.1.0.4)** will be mantained on branch [3.1.x](https://github.com/I-TECH-UW/OpenELIS-Global-2/tree/develop_3.1.x) cc @caseyi @calebslane @Herbert @reagan ---
**Author:** ![Moses\_Mutesasira](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.openelis-global.org/moses_mutesasira/32/72_2.png) [@Moses\_Mutesasira](https://talk.openelis-global.org/u/Moses_Mutesasira)\ **Post date:** [February 21, 2025, 10:41am UTC](https://talk.openelis-global.org/t/important-breaking-upgrades/1176/2 "2025-02-21T10:41:21Z")
---
**Author:** ![Agaba\_Derrick\_Junior](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.openelis-global.org/agaba_derrick_junior/32/503_2.png) [@Agaba\_Derrick\_Junior](https://talk.openelis-global.org/u/Agaba_Derrick_Junior)\ **Post date:** [February 21, 2025, 12:11pm UTC](https://talk.openelis-global.org/t/important-breaking-upgrades/1176/3 "2025-02-21T12:11:52Z")
Noted ! @Moses_Mutesasira thanx for update ! This means the next changes we are to push should be redirected to branch 3.1.x ---
**Author:** ![tasksolver](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.openelis-global.org/tasksolver/32/1067_2.png) [@tasksolver](https://talk.openelis-global.org/u/tasksolver)\ **Post date:** [February 21, 2025, 1:51pm UTC](https://talk.openelis-global.org/t/important-breaking-upgrades/1176/4 "2025-02-21T13:51:59Z")
thanks @Moses_Mutesasira and the team for the updates, ---
**Author:** ![Hashir\_Akbar](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.openelis-global.org/hashir_akbar/32/709_2.png) [@Hashir\_Akbar](https://talk.openelis-global.org/u/Hashir_Akbar)\ **Post date:** [February 22, 2025, 4:20am UTC](https://talk.openelis-global.org/t/important-breaking-upgrades/1176/5 "2025-02-22T04:20:10Z")
Thanks for the update!! ---
**Author:** ![Moses\_Mutesasira](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.openelis-global.org/moses_mutesasira/32/72_2.png) [@Moses\_Mutesasira](https://talk.openelis-global.org/u/Moses_Mutesasira)\ **Post date:** [February 23, 2025, 7:24am UTC](https://talk.openelis-global.org/t/important-breaking-upgrades/1176/6 "2025-02-23T07:24:53Z")
> [@Agaba\_Derrick\_Junior](#): > > Noted ! @Moses_Mutesasira thanx for update ! > This means the next changes we are to push should be redirected to branch 3.1.x Not really , we will still be working on `develop` and only back port impontant fixes to `3.1.x` ---
**Author:** ![segujja\_joseph](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.openelis-global.org/segujja_joseph/32/78_2.png) [@segujja\_joseph](https://talk.openelis-global.org/u/segujja_joseph)\ **Post date:** [February 24, 2025, 1:40pm UTC](https://talk.openelis-global.org/t/important-breaking-upgrades/1176/7 "2025-02-24T13:40:50Z")
thank you for the updates ---
**Author:** ![Moses\_Mutesasira](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.openelis-global.org/moses_mutesasira/32/72_2.png) [@Moses\_Mutesasira](https://talk.openelis-global.org/u/Moses_Mutesasira)\ **Post date:** [February 26, 2025, 5:33pm UTC](https://talk.openelis-global.org/t/important-breaking-upgrades/1176/8 "2025-02-26T17:33:30Z")
The Breaking [changes](https://github.com/I-TECH-UW/OpenELIS-Global-2/pull/1500) have been merged. To update your local dev enviroment , first follow these steps listed above > [@Moses\_Mutesasira](#): > > ### What to do > > 1. You will Upgrade to Java 21 > 2. The main breaking change is the Java EE upgrade > Youll have to update your imports from `javax` to `jarkata`. ie > > | Old (Java EE / javax) | New (Jakarta EE 9+) | > | --- | --- | > | javax.servlet.\* | jakarta.servlet.\* | > | javax.persistence.\* | jakarta.persistence.\* | > | javax.validation.\* | jakarta.validation.\* | > | javax.xml.bind.\* | jakarta.xml.bind.\* | Then 1. Pull the latest merged changes `git pull origin` 2. Pull the latest docker changes ,because we made chages to the base webb app image ` docker-compose -f dev.docker-compose.yml pull oe.openelis.org` Then Follow the usual [dev steps](https://github.com/I-TECH-UW/OpenELIS-Global-2?tab=readme-ov-file#running-openelis-global2-using-docker-compose-with-locally-compiledbuilt-artifacts-ie-the-war-file-and-react-code) ---
**Author:** ![Agaba\_Derrick\_Junior](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.openelis-global.org/agaba_derrick_junior/32/503_2.png) [@Agaba\_Derrick\_Junior](https://talk.openelis-global.org/u/Agaba_Derrick_Junior)\ **Post date:** [February 27, 2025, 8:35am UTC](https://talk.openelis-global.org/t/important-breaking-upgrades/1176/9 "2025-02-27T08:35:46Z")
the most important thing to take caution of is that you cant rebuild with the existing submodules we first remove the existing sub modules > ```auto > git submodule deinit -f . > rm -rf .git/modules/ > > ``` then update the submodules following the new changes `git submodule update --init --recursive` then follow the rest of the procedure in the [readme](https://github.com/I-TECH-UW/OpenELIS-Global-2?tab=readme-ov-file#running-openelis-global2-using-docker-compose-with-locally-compiledbuilt-artifacts-ie-the-war-file-and-react-code) ---
**Author:** ![Moses\_Mutesasira](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.openelis-global.org/moses_mutesasira/32/72_2.png) [@Moses\_Mutesasira](https://talk.openelis-global.org/u/Moses_Mutesasira)\ **Post date:** [February 27, 2025, 8:38am UTC](https://talk.openelis-global.org/t/important-breaking-upgrades/1176/10 "2025-02-27T08:38:17Z")
Thanks @Agaba_Derrick_Junior for the catch. The submodules were updated too