September 2020

LOGI COMPOSER TRIAL

Docker Setup Guide

Page 1 + LogiAnalytics.com

September 2020

Logi Composer Trial

Getting Started

Logi Composer is the first out-of-the-box development environment for embedded analytics. The Logi Composer trial software utilizes Docker and Docker Compose to get you up and running in quickly on your desktop environment. The following instructions provide you with guidance on configuring your environment to work with the Logi Composer trial software.

Logi Composer trial software is available for download from https://github.com/LogiComposer/Try.

Contents Minimum Requirements: ...........................................................................................................................................2

System: ...................................................................................................................................................................2

Software: ................................................................................................................................................................2

Prepare Environment: ................................................................................................................................................3

Install and Configure Docker Desktop: ...................................................................................................................3

Clone or Download Composer Trial compose package ..........................................................................................6

Run Composer software .........................................................................................................................................8

Troubleshooting steps for Docker Desktop on Windows: ..........................................................................................9

Page 2 + LogiAnalytics.com

September 2020

Operating System Requirements

For optimum performance, please use the recommended system requirements below for your operating system.

Windows

Quad-core CPU 8GB RAM (16 GB Recommended) 40Gb+ Disk space Windows 10 64-bit Pro with Hyper-V support TCP Port 8080 should be open and available

Mac Quad-core CPU 8GB RAM (16 GB Recommended) 40Gb+ Disk space TCP Port 8080 should be open and available

Quad-core CPU 8GB RAM (16 GB Recommended) 40Gb+ Disk space Ubuntu 18.04+ or CentOS 7 recommended TCP Port 8080 should be open and available

Software Requirements Docker Desktop (with support for Docker Compose) Git UI (optional)

Linux

Page 3 + LogiAnalytics.com

September 2020

Download and Install Docker Desktop

Windows and Macs Users:

1. Download and install Docker Desktop from https://www.docker.com/products/docker-desktop Docker Desktop requires Hyper-V, which is only available on Windows 10 Pro and above, as well as Windows Servers. Docker Desktop comes packaged with Docker Engine and Docker Compose.

Note: Windows 10 Home may not support Hyper-V, unless installing latest Preview Release with Windows Subsystem for Linux.

2. Configure Docker environment to provide at least 2 CPUs and 4GB of RAM (8GB is recommended).

Page 4 + LogiAnalytics.com

September 2020

3. Allow sharing of host file system. This allows container configurations and data to persist beyond systemrestarts.

For Linux systems, please follow the installations below for Docker Engine and Docker Compose:

1. Docker Engine - https://docs.docker.com/engine/install/2. Docker Compose - https://docs.docker.com/compose/install/

Page 6 + LogiAnalytics.com

September 2020

Clone or Download Logi Composer Trial Compose Package

Clone https://github.com/LogiComposer/Try repository using your favorite Git UI or shell:

# git clone https://github.com/LogiComposer/Try

Note: If you do not have git software, download repository to a directory or folder.

Run Composer Software Follow instructions on https://github.com/LogiComposer/Try to start and stop Logi Composer instance.

1. Open a PowerShell instance.2. Change directory to location of downloaded directory3. Run try-logicomposer.ps1 shell script.

cd latest

./try-logicomposer.ps1 up --build --detach

Note: Environment can take 5 to 10 minutes to start.

Page 7 + LogiAnalytics.com

September 2020

1. Open a Terminal instance.2. Change directory to location of downloaded directory3. Run try-logicomposer.sh shell script.

cd latest ./try-logicomposer.sh up --build --detach

Note: Environment can take 5 to 10 minutes to start.

Page 8 + LogiAnalytics.com

September 2020

View Logi Composer's User Interface in Browser

Open a browser tab and go to: https://localhost:8080

Page 9 + LogiAnalytics.com

September 2020

Troubleshooting steps for Docker Desktop on WindowsCommon issues with corporate systems is that Windows PowerShell is restricted to execute shell scripts.

Docker Desktop relies on PowerShell scripts to create and manage a Docker engine environment. See

https://github.com/docker/for-win/issues/1348 for details on how to configure.

1. PowerShell Language Mode needs to be adjusted from ConstrainedLanguage to FullLanguage. See https://

docs.microsoft.com/en-

us/powershell/module/microsoft.powershell.core/about/about_language_modes?view=powershell-7 for

making change.

2. Registry Update may be required, if above configuration does not work. Set:HKLM\System\CurrentControlSet\Control\SESSION

MANAGER\Environment\__PSLockdownPolicy value to 0.

Note that these steps should be taken with your IT department’s consent and in line with your corporate policy.