Database upgrade

The information below applies to installations with data sources that are using a database as their data store.

Some Remote Desktop Manager releases must alter the database structure. These are performed automatically for you but it is a best practice to perform a backup of your data source beforehand. Additionally, if you are in a team environment, you must be the sole user connected to the database during the upgrade.

Follow these steps for a successful version update:

1. Ensure you are the sole user of the database during the upgrade process. If you environment allows for offline use, have your team switch to the offline mode, or have them switch to another data source.
2. Back up your database using the database tools.
3. Install the desired version of Remote Desktop Manager, using a portable (USB) deployment model may be desirable if you are doing this on your personal workstation.
4. Open Remote Desktop Manager while logged on as a user with administrative rights. You must also be SYSDBA or DB_OWNER.
5. You may be prompted with an upgrade message when your data source is accessed. If so, accept the upgrade.
6. If you were not prompted with an upgrade message, locate your data source to upgrade in File – Data sources and open its property window.
7. Switch to the Upgrade tab, then click on Update database.
8. Wait for a confirmation dialog.
9. Close the dialog.
10. Ensure your Remote Desktop Manager application is currently using that data source.
11. Press Ctrl+F5 to force a full refresh.
12. Validate the content and perform a check of the technologies that are critical in your environment.
13. Update the client software on all workstations.

1. Ensure you are the sole user of the database during the upgrade process. If you environment allows for offline use, have your team switch to the offline mode, or have them switch to another data source.
2. Back up your database using the database tools.
3. Open Remote Desktop Manager macOS while logged on as a user with administrative rights. You must also be SYSDBA or DB_OWNER.
4. You may be prompted with an upgrade message when your data source is accessed. If so, accept the upgrade.
5. If you were not prompted with an upgrade message, locate your data source to upgrade in File – Data sources and open its property window.

   

6. Switch to the Upgrade tab, then click on Update database.

   

7. Wait for a confirmation dialog.
8. Close the dialog.
9. Ensure your Remote Desktop Manager macOS application is currently using that data source.
10. Press Cmd+F5 to force a full refresh.
11. Validate the content and perform a check of the technologies that are critical in your environment.
12. Update the client software on all workstations.