Overview

AccessData products work by default to the online openstreetmap.org server. This requires a connection to the internet.

Important: For customers that wish to use this functionality offline they will need to build a map server, and purchase the appropriate licensing directly from MapTiler Data (previously OpenMapTiles). AccessData does not sell MapTiler Licenses, Customer needs to purchase the licenses and install the MapTiler server themselves.

https://www.maptiler.com/server/

Prerequisite

AccessData Products use the basic style for maps and the MapTiler serve needs to be installed with the correct style for our products to work. We also use Rasterization so the application needs to support map display using Rasterization.


There is a prerequisite that a MapTiler server is installed,  the maps have been initialised, and that the server has been tested to be working correctly, prior to making any changes to the product specific files.


Cautionary Note: You can't Install Docker on a Windows VM. If you are using virtualisation you would need to have installed Docker on a local Linux VM and initialised the Maps


KBs related to On-Prem Mapserver installation

Installing Local(On-Prem) Map-Server On Linux VM-Using Docker

On-Prem MapTiler Server

Configuration Of Apache Or Nginx For HTTP To HTTPS Reverse Proxy For On-Premise MapTiler Server


Summary

If the installation is just QUIN-C then skip to that section below, there is no requirement to replace the ADG.Visualization.dll file


Steps for FTK/ENT/LAB

1) Make backup copies of the existing ADG.Visualization.dll and ftk.exe.config files located in 

C:\Program Files\AccessData\Forensic Tools\7.4\bin

2) Create a backup of the ftk.exe.config file to a backup location, this is required should you need to rollback or should any errors occur while performing the updates.


3) Edit ftk.exe.config and add the following lines, replace the IP with the IP address of the machine that has been installed as the map server. Please pay attention to the URL, even though the mapserver shows that the URL should contain z/x/y our code passes 0/1/2 as variables (FTK Versions before 7.5.2). 

<appSettings>
<add key="MapUrlAddress" value="http://mapserver:3650/api/maps/basic/{0}/{1}/{2}.png" />
</appSettings>

    

example Version 7.4 and Earlier


example Version 7.4.2 and Later Note: appsettings section already exists in later versions so you only need to add the key and not the entire section.

Steps for QUIN-C and QVIEW

 In 7.4 there are 3 (three) files that need to be updated:1 for QVIEW, 1 for QUIN-C Desktop and 1 for Investigator.

QVIEW Update

Changing QVIEW is fairly straightforward. you just need to change the configuration to point towards the mapserver.

1) Make a copy of the QUIN-C configuration file ADG.WeblabSelfHost.exe.config located in the bin directory to a backup location, this is required should you need to rollback, or should any errors occur while performing the updates.

C:\Program Files\AccessData\Forensic Tools\7.4\bin

2) Locate the OpenStreeMapTileServerUrl entry and change the URL to point to the mapserver, replace the mapserver with the IP or FQDN of the mapsserver, IP below for illustration purposes only

<add key="OpenStreeMapTileServerUrl" value="http://mapserver:3650/api/maps/basic/{z}/{x}/{y}.png" />

Example:

https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875834/original/Quin-C_Offline.JPG?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T164120Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=7ded0376b66d3c2287b33671c50b191bcb3c3eca582e66d07dfd3125f828d88d

3) Save the file and close it


4) Restart the QUIN-C Self Host service

 

QUINC Desktop Login Update

In QUIN-C 7.4 you can update the MAP URL from the Desktop login under Admin  -> System Administration -> System Values this will update the ol.js file for you. You need to check the change has actually been made in the file to be correct


1) Make a copy of the QUIN-C configuration file ol.js located in the maps directory to a backup location, this is required should you need to rollback or should any errors occur while performing the updates.

C:\Program Files\AccessData\Forensic Tools\7.4\bin\scripts\maps\

2) Log into the desktop as administrator navigate to Admin  -> System Administration -> System Values update the URL field for Map Server to the IP address or FQDN of the Mapserver (IP below for illustration purposes only), you need to include the Style in the URL as per the installation on the Mapserver. Select the save icon next to the field, it will give a red message pop-up saying you need to restart the services

https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875835/original/offline_QUINC_desktop_74.JPG?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T164120Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=b5c15a2c2563c3d47c36f35f65fc5b8a68c33c0509b1aa24600522f70571de00

3) Confirm the change is made correctly in the actual ol.js file 

0!==a.url?a.url:"http://192.168.10.154:8080/styles/klokantech-basic/{z}/{x}/{y}.png"

Example:

https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875836/original/offline_QUINC_desktop_74-ol-js.JPG?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T164120Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=16af13e958a5e58885b1f1aa8ce435503b0abb1ea6390a92be47676f4bd6d8c5

4) Once the value is confirmed correct restart the QUINC Self Host service.


5) Open the browser, clear the cache history.


QUINC Investigator Login Update (required for 7.4 Only)

With 7.4 there is a new script called for the investigator login which needs to be updated.


1) Make a copy of the QUIN-C configuration file login_investigationservice.js located in the services directory to a backup location, this is required should you need to rollback, or should any errors occur while performing the updates.

C:\Program Files\AccessData\Forensic Tools\7.4\bin\app\features\desktop\services\

2) Open the file and search for the tile.openstreetmap.org entry and modify it to point to the IP address or FQDN of the mapserver, remember to include the style installed on the mapserver. IP below for illustration purposes only

0!==a.url?a.url:"http://192.168.73.111:8080/styles/klokantech-basic/{z}/{x}/{y}.png"

Example:

https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875837/original/offline_QUINC_Investigator_74.JPG?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T164120Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=efcfef2a061de1fe1b14f94b5a100c1497ecc3b511a4b667944012a8495a5e26

3) Once the value is confirmed correct, save the file and restart the QUINC Self Host service.


4) Open the browser, clear the cache history.


Steps for FTKC and FTKPlus

Changing FTKPlus and FTKC is fairly straightforward. you just need to change the configuration to point towards the mapserver.


1) Make a copy of the FTKC (Exterro Service) configuration file ADG.WeblabSelfHost.exe.config located in the bin directory to a backup location, this is required should you need to rollback, or should any errors occur while performing the updates.

C:\Program Files\AccessData\Forensic Tools\7.5\bin

2) Locate the OpenStreetMapTileServerUrl entry and change the URL to point to the mapserver, replace the mapserver with the IP or FQDN of the mapsserver. In the example below the mapserver is called mapserver

<add key="OpenStreeMapTileServerUrl" value="http://mapserver:3650/api/maps/basic/{z}/{x}/{y}.png" />

3) Once the change has been made, save the ADG.WeblabSelfHost.exe.config file and exit.


4) Restart the "AccessData Exterro Self Host Service" in the Windows Services, wait for the service to show as "Running" before proceeding.


5) Note: if you are using HTTPS set to true you will need to configure reverse-proxy on the mapserver to be able to present the map data back to FTKC securely via HTTPS, the keys also need to be updated accordingly to use HTTPS. KB link is at the top of this KB.