Introduction

These instructions only apply if you are being advised to use the script within the release notes of a Razuna version!

For this release we have made some changes to the database structure. These changes require your database to be updated BEFORE it can be imported to the new Razuna instance. Therefore you will need to run this Update script.

For your convenience we have also included the option to backup the updated database for restoring with the Backup function on this page. Please follow the instruction below precisely.

As always, please make a backup of your database BEFORE running the Update script! (just to be on the safe side)

Getting the Update & Export script and running the page

Within the new Razuna release you will find a folder called "export". Copy this folder and its whole content into your older Razuna instance. Example: Say you are moving from Razuna 1.4.1 to Razuna 1.4.2 you will grab the "export" folder from 1.4.2 and copy it into your Razuna 1.4.1 folder.

Then simply navigate to the export folder, e.g. http://localhost:8080/razuna/export and you should see a page like the following:

Updating your current database

To update your database simply click on the "Update" button. This action will open a small window where you can follow the progress of the update. Sometimes, it looks like the update came to a halt, please do not close the window or interfere with the update in any way. Simply wait!

You can and you should, check the update progress in the separate log file. The log file can be found on the "/razuna/WEB-INF/bluedragon/cflog" folder. The current file is the one with the current date and time and the file name.

After you have updated the database you can export it in order to move it to the new Razuna instance.

Exporting the database

Exporting the database does actually save the current database point to a internal database structure. This structure can then be used to import to the new Razuna instance.

Click on the "Export" button to start the export. Again a new window will open and show you the progress of the export action. Sometimes, it looks like the update came to a halt, please do not close the window or interfere with the update in any way. Simply wait!

You can and you should, check the update progress in the separate log file. The log file can be found on the "/razuna/WEB-INF/bluedragon/cflog" folder. The current file is the one with the current date and time and the file name.

Moving the backup database to the new Razuna instance

In order to move the backup database to your new Razuna instance you should stop your current Razuna server. This will safely shutdown the backup datase and your Razuna server.

In order for your new instance to see your backup you should move the content of your "backup" directory (the one in your "export" folder) to the ADMIN "backup" directory of your NEW Razuna instance. The backup directory is located at "/razuna/admin". Make sure that you copy all files of the name "razuna_backup.h2.db" and "razuna_backup.trace.db" and also the folder called "razuna_backup.lobs.db"!

To restore your database to the new Razuna instance either run the firsttime setup or restore the database within the Razuna Administration.