Self Hosted Upgrade Procedure

Self Hosted Upgrade Procedure

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 support@officemaps.com.
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.

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

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

    • Related Articles

    • Steps for Migration from a Self-Hosted Instance to Hosted OfficeMaps

      The process to move OfficeMaps from a self-hosted instance to a hosted one requires a number of steps. 1. Verify that your self-hosted instance is fully updated with all the system requirements to run the current self-hosted version of OfficeMaps. ...

    • Configuring Azure AD for self-hosted OfficeMaps

      This article is intended to provide network administrators with the steps required to enable Azure AD to integrate with self-hosted OfficeMaps. IMPORTANT: THIS ARTICLE IS ONLY FOR ON-PREMISE INSTANCES. DO NOT COMPLETE ANY OF THESE STEPS IF YOUR ...

    • Managing Users Migrating from a Self-Hosted to a Hosted Instance

      About Migrations Before a self-hosted instance can be migrated to a hosted instance, there are some questions that must be answered and actions taken in order to facilitate the migration. All users in self-hosted OfficeMaps will have a user name and ...

    • Changing your Plan Level/Number of People

      OfficeMaps is licensed in increments of 100 people.  For example a quantity of 2 allows up to 200 staff to be added to your OfficeMaps People directory.  To change the number of people for which your OfficeMaps account is licensed, follow these ...

    • Getting Started with Zapier and OfficeMaps

      Prerequisites: To enable a connection between OfficeMaps and Zapier, you will need to have signed up for each service.  You can signup for a free trial of OfficeMaps here. You can signup for a free trial of Zapier here. To enable the integration, you ...