Appendix A - Installing Linux and Docker

To install Harmony Connect Connector, you need to have Linux and DockerClosed Docker is a set of platform as a service products that use OS-level virtualization to deliver software in packages called containers. on your computer.

Follow the steps below to install them.

Installations

For the list of the supported Linux operating systems, see sk178065.

This example uses the Ubuntu Linux Server for the Virtual System.

  1. Download the compatible version of the Ubuntu Server from https://ubuntu.com/download/server.

    Select Option 2 - Manual server installation.

  2. Provision your Virtual Machine with the recommended specification from Requirements and start the installation process.

  3. Follow the official Ubuntu tutorial from https://ubuntu.com/tutorials/install-ubuntu-server#4-choose-your-language.

  4. In the Network connections step, edit the IP Address to allow for a static IP address.

  5. Set the subnet, IP address, gateway, DNS and domain information. Make sure that you use the proper formats.

  6. In the Configure proxy step, set the proxy information if applicable.

  7. In the Archive mirror step, keep the default mirror for system updates and packages.

  8. For Storage configuration, keep the default storage configuration.

  9. In the Profile setup step, enter the sudo user profile information and select Done.

  10. In the SSH setup step, choose to install OpenSSH Server that allows you to establish an SSH connection with the server for further configuration.

  11. In the Featured Server Snaps step, do not select Docker. You have to install it separately.

    The Ubuntu Server downloads and installs updates. This can take a few minutes.

  12. Reboot the server, when all updates installation is complete.

For installation instructions, refer to https://docs.docker.com/engine/install/ubuntu/.

Useful Docker Commands

Before you can use the container and image commands, you have to understand that a Docker image is not the same as a Docker container.

There are many internet resources that explain the difference, so you can refer to them, for example, https://phoenixnap.com/kb/docker-image-vs-container.

Then define if you want to work with your container or with the image.

Container Commands

Usage: docker container<my_command>

Command

Description

create

Create a container from an image

start

Start an existing container

run

Create a new container and start it

ls

List running containers

inspect

See information about a container

logs

Print logs

stop

Gracefully stop running container

kill

Stop immediately the main process in container

rm

Delete a stopped container

Image Commands

Usage: docker image <my_command>

Command

Description

create

Create a container from an image

build

Build the image

push

Push the image to a remote registry

ls

List images

history

See intermediate image info

inspect

See information about the image, including the layers

rm

Delete the image

Miscellaneous Commands

Command

Description

docker version

List info about your Docker client and server versions

docker login

Log into a Docker registry

docker system prune

Delete all unused containers, unused networks, and dangling (unrelated) images