Skip to main content

Custom Sub-Directory

David Knapman
Updated
 

Background

The SureView Web UI is installed in [Immix folder]\Web\ImmixCC which gets served at the URL example.com/immixCC. This may not be desirable for all customers who may wish to customise the sub-directory (/immicCC) where the SureView UI is loaded from.

 

Setting up the Sub-Directory

Pre-Requisites

To use a custom sub directory you need to be running at least UI version 1.4.18604.0

If you are using the Views map plugin you will also need to have at least version 1.0.0.30

 

IIS Manager

We recommend not directly changing the name of the sub directory the Web UI is served from as this has a few problems:

  1. Old links (e.g. in SitRep reports) will no longer work
  2. The SureView installer will not be able to find the web UI.

To change the sub-directory for SureView we recommend the IIS Virtual Directory feature.

On the Application Tier server, open the IIS Manager and expand the server name on the left. Next expand the sites and right click on Default Web Site.

mceclip0.png

Select Add Virtual Directory. Fill in the Alias as the custom sub-directory you wish to use and the Physical path as [Immix folder]\Web\ImmixCC (default C:\Program Files (x86)\Immix Cloud\Web\ImmixCC). You can use the `...` button to open a folder browser dialog to find the Immix folder. Once those values are correctly populated you can click okay.

2.png

To verify these settings select View Virtual Directories from the Actions menu on the right hand side.

3.png

There should now be a second virtual directory entry with the custom sub-directory we just added. The values for the Physical Path should match for both entries. There is no need to remove the /ImmixCC entry.
4.png

Mobile app

The mobile app is set-up in such a way to correctly work out where the SureView UI is running. The first time you run the mobile app you will be greeted with a screen similar to the following:

5.jpg

Click on the option for SureView Enterprise Endpoint and you will be asked to type in the endopoint. Simply fill in the full SureView URL e.g. example.com/svs. This ensures that the mobile app can communicate correctly with SureView.

6.jpg

If you need to update this option after setting up the mobile app, simply log out and click the SureView logo in the top right corner. This will take you to the options menu where you can adjust the endpoint as explained above.
7.jpg

Situation Report (SitRep) template

The SitRep template is customisable to fit any branding requirements you require. If you are making use of the situation report you will need to customise the link. The template can be found in `[Immix Folder]\API\Templates\IncidentReport.html`. You will need to customise the link (<a href=...) from the following lines to match your custom sub-directory.

<body>
  <img src="{{TemplatePath}}/SureView-logo.png" />
  <br />
  <h1>SureView Situation Report</h1>
  {{#if Request.IncludeLink}}
    <a href="http://deployment.sureviewsystems.com/ImmixCC/#!SiteMonitor?eventId={{Request.EventID}}">View Event</a>
  {{/if}}
...

e.g.

<body>
  <img src="{{TemplatePath}}/SureView-logo.png" />
  <br />
  <h1>SureView Situation Report</h1>
  {{#if Request.IncludeLink}}
    <a href="https://example.com/svs/#!SiteMonitor?eventId={{Request.EventID}}">View Event</a>
  {{/if}}

Related articles

Comments

0 comments

Please sign in to leave a comment.