Docker on Windows Installation Guide

This documentation is archived.

All new implementation please use the following documentation link: https://help.lingk.io/en/articles/128-on-premise-adapter-powered-by-apache-nifi-installation-guide

Docker on Windows Installation Guide for Lingk REST Adapter

This guide will walk you through preparing your Windows installation for a Docker installation that will support the installation of the Lingk Adapter on Windows. For this install, you will need to install and/or download:

1. Windows 10 Insider Edition

2. Docker for Windows

3. Download the Lingk Rest Adapter installation files

Windows 10 Insider Edition

Windows Insider is an open software testing program by Microsoft that allows users who already own a valid license of Windows 10 or Windows Server 2016 to sign up for pre-release builds of the operating system previously only accessible to developers (https://insider.windows.com/en-us/getting-started/). The current Windows Insider version is needed to ensure the proper functioning of Linux-based Docker commands within Windows Docker containers.

Docker for Windows

To install Docker for Windows, visit https://www.docker.com/get-docker and download the version of your choice (CE or Enterprise).

Once downloaded, run the installer and follow the on-screen prompts. When prompted to enable features such as Hyper-V, you must select Yes to ensure proper execution of the Lingk REST Adapter containers.

After the installation has completed, you will see an icon on the desktop for Docker for Windows. Double-click it.

Double click this to set up Docker as a service on your machine.

Once Docker is installed and running (check for the gray Docker icon in the System Tray). NOTE: It may take a few minutes for the Docker service to start.

Test your Docker installation by opening PowerShell and trying:

> docker ps

You should also be able to test Docker containers by running Hello World.

> docker run hello-world

Open the Docker settings by right-clicking the Docker icon in the System Tray. You will see a screen that looks like the following:You will have to edit the Network and Proxies settings within Docker to enable Local Machine access to the Lingk REST Adapter once it installed.

First, click on Network, where you should see a screen such as the following:Ensure that you have supplied a subnet address and subnet mask value. The defaults (such as above) are sufficient.

Next, click Proxies. You will need to supply an IP address for HTTP and HTTPS. The default values (shown below) are sufficient.These settings must be in place to get around an issue where Windows' port forwarding to Docker containers does not work properly when trying to view Web output on the machine Docker is installed on.

You are now ready to return to the main Lingk REST Adapter document and install the Lingk REST Adapter. Once the REST Adapter is installed, you will be able to test your installation via the IP below where you should see a screen that looks like the one below:

.