---
title: "Step 7: Upgrading Web Application"
slug: "iobeya-431-on-prem-step-7-upgrading-the-web-application"
updated: 2025-03-25T08:52:01Z
published: 2025-03-25T08:52:01Z
canonical: "help.iobeya.com/iobeya-431-on-prem-step-7-upgrading-the-web-application"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.iobeya.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Step 7: Upgrading Web Application

> [!WARNING]
> Warning:
> 
> - Make sure that a backup of the platform has been created before you upgrade the iObeya database scheme.
> - Use the [Backup and restore](/product/docs/iobeya-431-on-prem-backup-and-restore) section to create your backup.

Follow these steps to update the iObeya web application on Tomcat:

1. In a terminal window, log in with the user account used to run Tomcat.
2. Stop Tomcat.
3. Empty **work** folder of Tomcat.
4. Delete old version of the JDBC drivers from **path_to_tomcat_directory/lib/** directory of Tomcat.
5. Copy the new JDBC drivers into the **path_to_tomcat_directory/lib/** directory of Tomcat.
  - For MySQL: [MySQL: Download Connector/J](https://dev.mysql.com/downloads/connector/j/)
  - For MariaDB: [MariaDB: Download Connector/J](https://mariadb.com/kb/en/about-mariadb-connector-j/)
  - For Oracle: [Oracle: Download JDBC drivers](https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html)

> [!NOTE]
> Note:
> 
> - Check the iObeya technical requirements to identify which version of the JDBC drivers you should use according to your database server.
> - From our experience, we get better performance with the MariaDB JDBC connector compared to the MySQL JDBC connector.
6. Delete old versions of the add-ons from the plugins folder in the iObeya data directory (Example: /var/iobeya/data/plugins/)
7. Rename the old iObeya DocBase folder to DocBase-oldVersion (Example: iobeya-4.16 for iObeya 4.16)
8. Move the iobeya directory contained in the new package to be the new DocBase directory (Example: /var/iobeya/webapp/4.20.1/)

> [!WARNING]
> Warning:
> 
> As of iObeya 4.16, all the standard add-ons are now packaged in the web application.
> 
> However, if you have installed any custom add-ons on your iObeya platform, refer to [Updating an add-on](/product/docs/fr/iobeya-431-on-prem-installing-or-updating-an-add-on) to update an add-on.
9. Rename the old context file **ROOT.xml** and old **log4j2.xml** file to back them up.

Example: When you upgrade from iObeya 4.16, rename them ROOT.xml.4.16 and log4j2.xml.4.16.
10. Put the new **ROOT.xml** into the **path_to_tomcat_directory/conf/Catalina/localhost** directory of Tomcat.
11. Put the new **log4j2.xml** file into the **log4j2FilePath** folder you configured in the **ROOT.xml**.
12. Verify all the directory you defined in the new **ROOT.xml** exists:
  - the base directory,
  - the data directory,
  - the assets directory,
  - the logs directory,
  - the index directory,
  - the plugins properties directory.