Installing IW Monitor Docker on Host

Host and Network Requirements

Host requirements


Note


It is recommended to have a high-speed, high bandwidth internet connection for installation of Docker and the IW Monitor image file.


If an internet connection is not available, the Docker application and IW Monitor image file can be installed manually. See Installing and Running Docker Container.

Make sure the following host requirements are met to run the Docker container:

Operating System

Windows 7 or later

Mac OS X 10.9.x or later

Linux (32-bit or 64-bit):

  • Ubuntu 14.04 or later

  • Debian 9 or later

  • OpenSuSE 14.2 or later
  • Fedora Linux 19 or later

Docker Application

Yes

Yes

Yes

Base System

Virtual machine or bare metal

Virtual machine or bare metal

Virtual machine or bare metal

Processor

Intel Core i7 or Xeon (any frequency and mandatory minimum of four cores)

Intel Core i7 or Xeon (any frequency and mandatory minimum of four cores)

Intel Core i7 or Xeon (any frequency and mandatory minimum of four cores)

RAM

16 GB minimum

16 GB minimum

16 GB minimum

Hard Disk

100 GB minimum*

1 TB or greater recommended

100 GB minimum*

1 TB or greater recommended

100 GB minimum*

1 TB or greater recommended

High speed connection to local networks and devices

Preferred

Preferred

Preferred

Screen Resolution

1024 x 768 pixel minimum

1024 x 768 pixel minimum

1024 x 768 pixel minimum


Note


Using a hard disk of at least 100 GB capacity is recommended. If a hard disk of less than 100 GB capacity must be used, adjust the maximum capacity available for statistics storage as mentioned in Defining Hard Disk Storage Capacity and Overwrite Cycle Period for the IW Monitor Statistics Database.


Browser requirements

Use the latest version of a supported web browsers to access the IW Monitor:

Browser

Supported Version

Mozilla Firefox

Latest

Microsoft Internet Explorer

Latest

Microsoft Edge

Latest

Google Chrome

Latest

Apple Safari

Latest


Note


If needed, upgrade your browser to the latest version.


Installing Docker on Host

A Docker image is a standard, self-contained unit of software that packages code and its dependencies that lets the application run quickly and reliably from one computing environment to another. Docker images become containers at runtime when they run on the Docker engine.

Prerequisites to install Docker on the IW Monitor host

When Docker is installed on the IW Monitor host, make sure that the host's CPU supports virtualization and second-level address translation (SLAT).

Note


Intel’s version of SLAT is called EPT (Extended page tables).


To check if the host's processor or processors meets the requirement:
  1. Go to Microsoft Sysinternals, download the Coreinfo package.

  2. Unzip the downloaded program folder to the root of the host's: C:\ drive

  3. Open the command prompt using administrator privileges.

  4. Enter the command: coreinfo.exe -v

    • If an Intel CPU supports SLAT, an asterisk (*) is shown in the EPT row (below):

    • If your CPU does not support SLAT, a dash (-) is shown in the EPT row.

To check if CPU supports SLAT:
  1. Go to Intel Product Specification.

  2. Select the respective CPU, and check its specifications.

Installing and Running Docker Container


Important


Before you install and run the docker container on a Microsoft operating system, make sure that Microsoft virtual machine capability (Hyper V) is running. Also, VMware is supported.

Important


Do not install the Docker container on your local computer. Docker must only be installed on the host assigned to run the IW Monitor. To view the minimum hardware specifications of the host, see Host and Network Requirements.



Note


Oracle VM VirtualBox is not supported.


Downloading and installing the Docker application

Procedure


Step 1

Go to the Docker application download page.

Step 2

Download the correct Docker application package.

Step 3

Install the Docker application on the IW Monitor host.


Downloading the IW Monitor Image

Procedure


Step 1

Go to software downloads.

Step 2

Download the IW Monitor image file (iw-monitor-dockerv1. x.x.tar).


Loading the IW Monitor Image File to the IW Monitor Server

Procedure


Step 1

Open a command-line window.

Step 2

Enter the command: docker load -i iw-monitor-dockerv1. x.x.tar

Step 3

Enter the command to check if the IW Monitor image file is loaded: docker images

A list of the Docker image files currently installed on the IW Monitor host are shown.

Step 4

To get the image ID value for the IW Monitor image file:

  1. Open a command-line window.

  2. Enter the command: docker images

    A list of the Docker image files currently installed on the IW Monitor host are shown.

  3. Search the REPOSITORY column of the Docker image file list for the iw-monitor image file.

    Make a note of the IMAGE ID value of the IW Monitor Docker image.

Running the Docker Container for the First Time

Procedure


Step 1

Open a command-line window.

Step 2

Enter the command: docker run -d --name iw_monitor -p 8443:8443 --restart always X where X is the IMAGE ID value of the IW Monitor Docker image.

Note

 
By default, the port numbers of the IW Monitor which runs on within the Docker container are:
  • Port 8443 (https with SSL)

  • Encryption / HTTPS is required

Note

 
If you fail to use the default host port numbers due to security policy settings or the needed host port is assigned to another service, modify the docker run command to include an unused host port.

Note

 

For example, a run command that specifies port 3000: docker run -d --name iw_monitor -p 3000:8443 iw_monitor

Step 3

If you have modified the Docker run command to specify a different host port, then you must specify the port number used by IW Monitor. For more information, see Adding Devices to the IW Monitor.

Step 4

Open the web bowser.

Step 5

Navigate to the URL https://X:Y where X is the IP address of the IW Monitor host, and Y is the host port number.

IW Monitor Docker container is successfully launched and the welcome page is shown as below:

Logging to the IW Monitor for the First Time

Procedure


Step 1

Open the web browser.

Step 2

Enter the URL with IP address and port number of the computer on which the IW Monitor image file: https://[IP address]:[host port number]

If you are running IW Monitor for the first time, the following initialization page appears:

Step 3

Fill your first name, last name, e-mail address and login password in the respective fields.

Step 4

Click Next.

The Add new device screen appears.

Step 5

(Optional) If required, fill the IP address of the IW Monitor server in the Server IP field and port number in Port field.

Step 6

Fill the IP addresses of all the devices that you want to monitor in the IP addresses field.

Note

 
Press Enter after entering each IP address, including the last IP address.

Step 7

Click Associate devices.

A confirmation screen appears showing that the devices are associated with the IW Monitor interface.

Step 8

Click Close.

The list of devices associated with the IW Monitor interface are shown as below:

Step 9

Make sure that all the devices are listed on the screen. If any device is missing, follow the steps to add the device:

  1. Click Add Device.

    The Add new device screen appears.

  2. Fill the IP address of the devices in the IP addresses field.

  3. Click Save.

    A confirmation screen appears showing that the devices are associated with the IW Monitor interface.
  4. Click Close.

Step 10

Click Next.

The IW Monitor analyzes the network and once the network analysis is complete and then the Complete screen appears:

Step 11

Click Done to complete the network setup.

The IW Monitor dashboard appears: