Installing OfficeMaps

Installing OfficeMaps

Please refer to the articles Server Requirements and Installation Pre-Start Check before continuing.

Performing the Installation
Download the latest version of the OfficeMaps full package (e.g. OfficeMaps2.3.1.zip).
Download the latest version of the OfficeMaps Windows application (either MSI or loose file version, some servers block Installer packages via Group Policy).
Ensure you have your OfficeMaps Instance file and starting template, these will be supplied by OfficeMaps Support in another zip package.
Extract the contents of the OfficeMaps full zip package and move the OfficeMaps folder (and contained folders) to the location where you wish to place the OfficeMaps web sites (e.g. C:\OfficeMaps)

Launch the OfficeMaps Windows application.



Click the ... to browse to the Base Installation folder.



This will populate the OfficeMapsWebApi and OfficeMapsWeb config path lines. Alternatively, they can be browsed to manually. These values will be set to the child folders OfficeMapsWebApi and OfficeMapsWeb by default.



Main Configuration Page

Configure URLs



Enter or paste the URLs that will be used for OfficeMaps. These will be the DNS names that were created prefixed by http:// (or https:// if you plan to use SSL and have a certificate installed). Values must be entered for Web API and Web but values are only recommended for Intranet and Kiosk. These recommended values which enable the intranet plugin or embedded kiosk links must be different from what was entered for Web.

Click Save. 
Click Create Site - for the Web Api. This will create the web site and Application Pool named OfficeMapsWebApi.
If the URL began with http:// the dialog on the left will be displayed. If instead it was https:// you will see the dialog on the right which contains a warning that you must select the certificate for the web site binding before proceeding.



Click Create Site - for the Web. This will create the Website and Application Pool named OfficeMapsWeb. It will also add any of the other specified bindings to this site.

SSL Binding Configuration
If any of the sites used SSL and https:// you may need to perform the following:
Open IIS Manager.
Click on the relevant OfficeMaps web site, e.g. OfficeMapsWebApi then click Bindings on the Actions tab.



Click Edit on each Binding, then select the required certificate from the SSL Certificate list and change the IP Address if required.



SQL Server Integrated Authentication
If you are planning to use Integrated Authentication for the SQL Connection, then the OfficeMapsApi Application Pool Identity will need to be changed:
Open IIS Manager.
Click Application Pools.
Select the OfficeMapsWebApi Application Pool.
On the Actions tab, click Advanced Settings.



In the Process Model section, click on the ... beside Identity. You can the specify either the built-in Account or the custom account that will be used to connect to SQL Server.



Database - SQL Connection String
Changes to the connection string are recommended by clicking Configure.

y


NOTE: If using Windows Authentication, the Test button may fail as it will be running under the identity of the currently logged in user. Clicking Test may fail if the person does not have permission to the SQL Database and a successful test does not guarantee that the web site will have permission. During the installation at least, it is recommended that the person installing OfficeMaps be granted permission to the OfficeMaps database.

Validate Instance
Click Validate Instance. If the SQL connection string is valid and OfficeMaps does not have a configured instance the Add Instance button will be displayed.



Click Add Instance to perform the final part of the installation.



Add Instance



The values for Instance Configuration File and Instance Template File will only be supplied to customers who are performing a new on premise installation.

 
Instance Configuration File: Browse to the file extracted from zip with the extension .ominstance.
Instance Template File:  Browse to the file extracted from zip with the extension .omtemplate.
Instance Code:  This value must be exactly what was entered when created. You should be notified what code should be entered. Alternatively, the Instance configuration file name will either be named or begin with the value entered during signup. If the file name of the zip packages you have been sent contain the text "Radix" followed by a number, please disregard this text for the purposes of determining your Instance Code.
Password: This is for the initial user (OMAdmin) that gets created. It is important to remember this password at least until other accounts are set up. There will an account created automatically for the person named during the signup. They may be sent a welcome email depending on the internet/firewall settings on the web server. 

Click Add Instance. This may take a few minutes as it forces the web application to restart to ensure it loads the latest configuration changes.



If successful, it should appear similar to above. You should now be able to login to the OfficeMaps instance.

    • Related Articles

    • Contacting OfficeMaps Support

      If you would like to contact OfficeMaps for support you can reach us in one of three different ways:   Log a Ticket: Enter the details of your request at the following site: https://help.officemaps.com/portal/newticket. Email: Email us at ...
    • OfficeMaps and GDPR

      The General Data Protection Regulation (GDPR) is a new European privacy regulation. The GDPR was introduced to strengthen the security and protection of personal data in the EU and standardizes EU data protection law. It applies to any organization ...
    • OfficeMaps Supported Browsers

      OfficeMaps supports Safari 13+ and the current versions of Firefox, Chrome, and Microsoft Edge. Please note: Legacy Edge is no longer supported. For more information about Legacy Edge, please consult the following article from ...
    • 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 ...
    • 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 ...