Step 7: Upgrading the web application

Warning:

• Make sure that a backup of the platform has been created before you upgrade the iObeya database scheme.

• Use the 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

   • For MariaDB: MariaDB: Download Connector/J

   • For Oracle: Oracle: Download JDBC drivers

     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:

   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 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.