The self-hosted version of OfficeMaps consists primarily of the OfficeMaps folder (assuming web sites and files etc. are still contained within) and the SQL Database.
The overview of the upgrade process is:
Download and copy upgrade package to the web server;
Back up current sites and database;
Replace the existing OfficeMapsWeb and OfficeMapsWebAPI folders, retaining the current configuration folders contained within.
For releases version 2.10 or greater, .Net Framework version 4.8 must be installed on the server. This must be done prior to performing the upgrade and may require a restart when complete.
Download and copy upgrade package to the web server
Download the latest upgrade package. OfficeMaps support will be able to supply you with the relevant link; contact us at firstname.lastname@example.org
Copy and extract the Zip file to a folder on the web server, e.g. under the OfficeMaps\Downloads folder.
If the full package was downloaded (rather than the upgrade) then the Config subfolders for OfficeMapsWeb and OfficeMapsWebAPI should be removed to prevent accidental overwriting. The upgrade package is exactly the same as the full package except the Config folders are not included.
Back up OfficeMaps database
Because some upgrades modify the database, it is critical that the database is backed up prior to performing upgrades.
Back up current OfficeMaps Websites
The entire OfficeMaps folder can be backed up, though only the two website folders will be modified. The OfficeMapsWeb and OfficeMapsWebAPI folders at a minimum should be backed up. A quick way to do this can be to right click each folder and select Send to Zip.
Performing the Upgrade
There may be an outage during the upgrade process, so warning staff or choosing an out of hours time may be recommended.
Select all files and folders in the OfficeMapsWebAPI folder, deselect the Config folder then delete all other files leaving only the Config folder.
Navigate to the OfficeMapsWebAPI folder inside the extracted package and select all files.
Then paste them to the OfficeMaps\OfficeMapsWebAPI folder where currently only the Config folder remains.
Then repeat the same process with the OfficeMapsWeb folder.
Select all files and folders in the OfficeMapsWeb folder, deselect the Config folder then delete all other files leaving only the Config folder.
Navigate to the OfficeMapsWeb folder inside the extracted package and select all files.
Then paste them to the OfficeMaps\OfficeMapsWeb folder where currently only the Config folder remains.
Launch and test OfficeMaps
Simply browse to the OfficeMaps site to confirm that it works.
After the upgrade, the first launch could take a minute or longer before it responds.
Recovery steps for failed upgrade
To restore the previous version of OfficeMaps you will need to first restore the original websites, then restore the database. It is important for the order to be correct, otherwise the newer version may upgrade the database again.
Restore/replace the original OfficeMapsWebAPI folder
Remove the contents of the folder, and either extract the backup Zip file or recopy the original folder back. Repeat the process for the original OfficeMaps web folder.
Restore the OfficeMaps Database
People may need to refresh their browsers to force reload the prior version of the website.