Documentation forOrion Platform

Docker Swarm requirements, deployment command examples, and container removal steps

This Orion Platform topic applies only to the following products:

SAMVMAN

Docker Swarm is one of the environments supported by the Container Monitoring feature.

To monitor Docker Swarm containers in the Orion Platform, you'll need:

  • Docker Engine 17.12 or later
  • Docker Compose file format 3.5 or later
  • SSH access to the master server
  • Sudo privileges on the master server
  • A weaveworks/scope:1.13.2 image in the Docker repository.

Required ports include:

  • 4043: Container port (internal Docker communication).
  • 6784: Report/wave status (internal Docker communication).
  • 80: Used to download the configuration file from the Orion server.

    An alternative to using port 80 is to download the file manually and send it to the Docker host.

Docker Swarm installation commands

When you add a container service, the Manage Container Service wizard generates commands that you can copy to the Windows Clipboard. Connect to the master server via SSH, open a command line, and run commands to:

  • Download a cman-swarm.yaml file,
  • Set the hostname in the file to the master server, and
  • Start a service named "sw" to deploy an sw_orionmonitor container to each server in the swarm.

Delete Docker Swarm containers and container images from nodes

Before you delete a container service in the Orion Web Console, remove Orion containers and images from the nodes (or cluster of nodes) manually.

  1. Connect to the node via SSH.
  2. Run the following commands to remove the sw_orionaggregator and sw_orionmonitor containers:
    sudo docker service rm sw_orionaggregator
    sudo docker service rm sw_orionmonitor
  3. Run the following command to get a list of images and note the IDs for docker.dev.local/scope2orion and weaveworks/scope:latest.
    sudo docker images
  4. Run the following command for each image:
    sudo docker rmi [image_id]

The service status switches to Down on the Container Services page. Now you can delete the container service by selecting its check box and clicking Delete.