Follow

Offline Map Visualization for QUIN-C/FTK/LAB/ENT 7.4

Created by: Paul van Ramesdonk
Created date:
Last Updated date:

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

Prerequisite

AccessData Products use the klokantech-basic style for maps and the mapserver needs to be installed with the correct style for our products to work.

There is a prerequisite that a mapserver 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

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.

<appSettings>
    <add key="MapUrlAddress" value="http://192.168.73.111:8080/styles/klokantech-basic/{0}/{1}/{2}.png?key=NfJesSlkkenWB8pLWRBa" />
</appSettings>

example:

online.JPG

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://192.168.73.111:8080/styles/klokantech-basic/{z}/{x}/{y}.png?key=NfJesSlkkenWB8pLWRBa" />

Example:

Quin-C_Offline.JPG

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

offline_QUINC_desktop_74.JPG

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:

offline_QUINC_desktop_74-ol-js.JPG

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)

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:

offline_QUINC_Investigator_74.JPG

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.

 

Installing Local Map-Server on Linux VM

The steps below is to install a local map-server onto a Linux VM. 

Customers need to have purchased the license from MapTiler Data and downloaded the planet map file prior to continuing.

Prerequisite

Install a VM using Linux as the OS. The reason for this is that Docker doesn't run from within a Windows VM. Depending on the type of installation you have done, you may need to install additional packages. For instance if curl is not installed you will need to first install the package to allow you to use the curl command. The installation of the Map Server is pretty straight-forward. If you have VMTools, you need to install them as well if you wish to drag the MBTILES file to the VM from your Host machine. The VM needs access to the internet in order to pull any packages.

Note: If you are dragging and dropping to the VM you need to note that the file is first copied to the cache directory and then to the directory it is actually being copied to. As a result the VM needs to be created with at least more that double the Planet Maps file size otherwise the copying will fail.

Example used below was as follows: Ubuntu OS. 

VM Specs: 150GB HDD(The mbtiles file is 51GB in size so you need to have enough space on the VM), 2 CPU's, 2 Ethernet (1 NAT, 1 for host only network for local IP)

Steps

1) Download and install Docker from within a terminal

curl -sSL https://get.docker.com/ | sh

2) You can test the docker installation using that age old first programming text hello-world printing

sudo docker run hello-world

3) Copy the file to the Linux users home directory once it has finished check that it copied correctly the filename I have is 2017-07-03_planet_z0_z14.mbtiles as an example

4) Once the planet tiles have been placed on the Linux machine, need to pull the map-server code. This is the same command to be used to start the map-server every time.

 sudo docker run -it -v $(pwd):/data -p 8080:80 store/klokantech/openmaptiles-server-dev:1.4-free

5) Once the code has been pulled, it will read the contents of the home directory if that is where the above command was run from. You should see something similar to the example below. It needs to detect the mbtiles file and then install it, you should wait till you get the message installation Wizard started at http://:::80/

Installation_found.JPG

6) Open the browser, you can either use http://localhost:8080 or the <ip address>:8080 or FQDN:8080

start-screen.JPG

7) Once you click on start above it will take you to the Region Screen, it should have picked up your map tiles file

tiles_found_.JPG

8) Select Continue, by default all the styles are checked, we only need Klokantech Basic, so you can un-check the rest

Style.JPG

9) Next screen is the Setting page, once again everything is check by default, we only require Server raster map tiles, you can un-check the other options, Select the Save & Run the Server button when you are happy

settings.JPG

10) You should now be at the Publish Screen

publish.JPG

11)

published.JPG

12) At this point you can log into the machine where you have installed FTL/LAB/ENT/QUIN-C and check that you can connect to the map server by opening the browser and pointing it to the mapserver.

example using the browser on the Enterprise VM to connect to the map server

confirm_working_from_FTK.JPG

13) You will then need to make the appropriate changes to the configuration files depending on the installation as detailed in the earlier sections above.

14) Please note that you will either need to relaunch the map server once the Linux machine is rebooted, or you need to script it to start automatically when the Linux machine is started.

 

Installing Local Map-Server on Linux VM-Offline

The steps below is to install a local map-server onto a Linux VM. 

Customers need to have purchased the license from MapTiler Data and downloaded the planet map file prior to continuing.

To be able to install the Linux VM that is to be used as an Offline mapserver, you will need to have docker installed on a machine that can connect to the internet (i.e. Online), you need to be able to pull the Klokantech Map Container and then copy that to the Offline machine. You also need to download the Docker packages and copy that to the offline machine to be installed.

Prerequisite

Install a VM using Linux as the OS. The reason for this is that Docker doesn't run from within a Windows VM. Depending on the type of installation you have done, you may need to install additional packages. For instance if curl is not installed you will need to first install the package to allow you to use the curl command. The installation of the Map Server is pretty straight-forward. If you have VMTools, you need to install them as well if you wish to drag the MBTILES file to the VM from your Host machine. The VM needs access to the internet in order to pull any packages.

Note: If you are dragging and dropping to the VM you need to note that the file is first copied to the cache directory and then to the directory it is actually being copied to. As a result the VM needs to be created with at least more that double the Planet Maps file size otherwise the copying will fail.

Example used below was as follows: Ubuntu OS. 

VM Specs: 150GB HDD(The mbtiles file is 51GB in size so you need to have enough space on the VM), 2 CPU's, 2 Ethernet (1 NAT, 1 for host only network for local IP)

Steps to be performed on the Online server

1) Once the machine has been installed, Install curl if it gives you a 'curl not found error

sudo apt install curl

2) Download and install Docker from within a terminal

curl -sSL https://get.docker.com/ | sh

3) You can test the docker installation using that age old first programming text hello-world printing

sudo docker run hello-world

4) Pull the Klokantech Container using Docker

sudo docker pull store/klokantech/openmaptiles-server-dev:1.4-free

5) Save the container, this is required to be copied to the OFFLINE server in the next step

 sudo docker save -o mapserver_offline.tar store/klokantech/openmaptiles-server-dev

6) File is created with only root being able to read and write. Add the same rights to the group and other users

sudo chmod 666 mapserver_offline.tar

The container is ready to be copied to the offline Linux server

Steps to be performed on the Offline server-Prerequisites

1) You need to download the Docker Packages, you need to download the correct packages for the correct Linux version, if you are using Ubuntu 20.04 then you need to download the files for Focal. You need a machine (Windows,MAC or Linux) to be online to be able to download from the Internet

https://download.docker.com/linux/ubuntu/dists/focal/pool/stable/amd64/

2) You need to download 3 files the containerd.io, the docker-ce and docker-ce-cli packages

An example below of the latest stable files (when this was written)

https://download.docker.com/linux/ubuntu/dists/focal/pool/stable/amd64/containerd.io_1.3.7-1_amd64.deb
https://download.docker.com/linux/ubuntu/dists/focal/pool/stable/amd64/docker-ce-cli_19.03.13~3-0~ubuntu-focal_amd64.deb
https://download.docker.com/linux/ubuntu/dists/focal/pool/stable/amd64/docker-ce_19.03.13~3-0~ubuntu-focal_amd64.deb

The 3 docker package files, the mbtiles file and the klokantech container file all need to be copied to the offline server. place in the home directory.

Steps to be performed on the Offline server

1)  Install docker packages

sudo dpkg -i containerd.io_1.3.7-1_amd64.deb docker-ce-cli_19.03.13_3-0_ubuntu-focal_amd64.deb docker-ce_19.03.13_3-0_ubuntu-focal_amd64.deb

Example: (remember to elevate privileges to root)

Offline_Docker_install.JPG

2) Load the Klokantech Container. This was created on the Online server and then copied

sudo docker load -i mapserver_offline.tar

Example of output

Offline_klokantech_load.JPG

3) Start the docker container (ensure that the mbtiles file is placed in the home directory

 sudo docker run -it -v $(pwd):/data -p 8080:80 store/klokantech/openmaptiles-server-dev:1.4-free

4) Once the code has been pulled it will read the contents of the home directory if that is where the above command was run from. You should see something similar to the example below. It needs to detect the map tiles file and then install it, you should wait till you get the message installation Wizard started at http://:::80/

Installation_found.JPG

5) Open the browser, you can either use http://localhost:8080 or the <ip address>:8080 or FQDN:8080

start-screen.JPG

6) Once you click on start above it will take you to the Region Screen, it should have picked up your map tiles file

tiles_found_.JPG

7) Select Continue, by default all the styles are checked, we only need Klokantech Basic, so you can un-check the rest

Style.JPG

8) Next screen is the Setting page, once again everything is check by default, we only require Server raster map tiles, you can un-check the other options, Select the Save & Run the Server button when you are happy

settings.JPG

9) You should now be at the Publish Screen

published.JPG

10)

published.JPG

11) At this point you can log into the machine where you have installed FTL/LAB/ENT/QUIN-C and check that you can connect to the map server by opening the browser and pointing it to the mapserver.

Example using the browser on the Enterprise VM to connect to the map server

confirm_working_from_FTK.JPG

12) You will then need to make the appropriate changes to the configuration files depending on the installation as detailed in the earlier sections above.

13) Please note that you will either need to relaunch the map server once the Linux machine is rebooted, or you need to script it to start automatically when the Linux machine is started.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Powered by Zendesk