Documentation forOrion Platform

Docker requirements, deployment script examples, and container removal steps

This Orion Platform topic applies only to the following products:

SAMVMAN

The Container Monitoring feature supports Docker, an open container platform designed to help build, ship, and run applications. The Docker Engine is the client-server application that serves as the core of the container runtime environment. It provide the foundation to run individual containers that each include:

  • An image file, which serves as a snapshot of the required application. This read-only file is a template with instructions for creating a Docker container.
  • A configuration file.

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

  • Docker Engine 17.12 or later.
  • A Compose YAML file, version 3.5 or later.
  • SSH access to the master server.
  • Sudo privileges on the master server.
  • A weaveworks/scope:1.8.0 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 installation script

When you add a container service, the Add Container Service wizard generates a script that you can copy to the Windows Clipboard. Connect to the master server via SSH, open a command line, and run the script, which looks something like this:

curl -o docker-compose.yaml #endpoint# 
sudo docker-compose up -d

SolarWinds recommends that you execute script commands in a directory that does not already have a docker-compose.yaml file. Consider creating a new Orion directory on the server where you can run script commands.

The script downloads the docker-compose.yaml file and runs it with superuser privileges.

Delete Docker containers and container images from nodes

Before you delete a container service in the Orion Web Console, delete the related Orion containers and images from the node manually with Docker commands.

  1. Connect to the node via SSH.
  2. Get the IDs for the sw_orionaggregator and sw_orionmonitor containers by running the following command:
    sudo docker ps | grep sw_
  3. To delete the sw_orionaggregator and sw_orionmonitor containers, run the following command for each ID:
    sudo docker stop [container_id]
    sudo docker rm [container_id]
    
  4. Get a list of images and note the IDs for the docker.dev.local/scope2orion and weaveworks/scope:latest containers by running the following command.
    sudo docker images
  5. Run the following command for each image ID and container acquired in step 4:
    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.

The scripts are not supported under any SolarWinds support program or service. The scripts are provided AS IS without warranty of any kind. SolarWinds further disclaims all warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. The risk arising out of the use or performance of the scripts and documentation stays with you. In no event shall SolarWinds or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the scripts or documentation.