Backup your data

The database

Please refer to your Database Server guide for more information or check out the Backup/Restore section of the documentation.

Your custom launchers

If you developed some custom launchers using the SDK, it's advised to backup all your source files, build scripts, binaries etc. before updating.
You can find all your launcher binaries in the <install directory>/bin/launchers/ folder.


Your custom reports

If you developed some custom XSLT reports, it's advised to backup all these XSLT (along with their associated resources i.e. images etc.) before updating.
You can find all your custom XSLT reports in the <install directory>/export folder.


Your visuals

If you customized your instance with custom splash screens, logo and icons, it's advised to backup all these resources before updating. You can find all your visuals in the <install directory>/visuals/ folder.






Update the fat client



Please click on the appropriate option below:

I have a Windows computer

I have a Linux or a MacOSX computer





Restore your data

Your custom launchers

If you developed some custom launchers using the SDK, and if you are updating to a major version (with changes in the SDK), you need to recompile all of them from their sources using the new SDK and to copy the binaries in the launchers folder (<install directory>/bin/launchers/).


Your custom reports

If you developed some custom XSLT reports, you need to add them in the new <install directory>/export/ folder.


Your visuals

If you customized your server with custom splash screens, logo and icons, just check they are still in the <install directory>/visuals folder (if not, copy your backuped files here).





Restart the service

Start XStudio a first time as admin

Start normally XStudio from <install directory>/bin/xstudio.exe or <install directory>/bin/xstudio.sh and log in as admin.
If you're updating to a major version, you MAY be asked again for your admin password to confirm you authorize the system to update the schema of the database. Just confirm and continue.

When the migration is completed, XStudio will re-start normally.

If a schema update was necessary, you can use the database integrity checker available from the menu Tools > Check database integrity to ensure everything's fine.


Check the settings and the user profiles

When some new features that need specific rights are added, their associated rights will be missing from the user profiles so these features are disabled "by default".

So when you update, don't forget to check the user profiles to see if you want to add some new rights to some of your profiles.

The same way, in a newer version some of the new features may require some global settings. These settings have all default values but it's a good idea to check those just after an update.