Docker Data Collector

For the Ad Astra Apps, clients will set up Docker Data Collector on their servers to collect and push data to Ad Astra. 

Prerequisites

Clients must have a server or virtual machine with these requirements:

• Linux OS with Docker Engine installed; latest Ubuntu or CentOS recommended
• Network Connectivity to Student Information System (SIS)
• Outbound network connection to:
  • https://controller.adastra.live

  • https://adastra-prod-data-ingestion.s3.amazonaws.com/ 

  • https://sqs.us-east-1.amazonaws.com/ 

  • Please see Network Diagram below
• Minimum System Requirements:

Installation Steps

1. Install Docker Engine
   • See Docker Engine install instructions based on your chosen distro.
     https://docs.docker.com/engine/install/
     • For Oracle Linux 8 or 9 linux distro
       • You may install podman from the AppStream repository.
       • #dnf install-y podman
       • Substitute podman in the commands below where you see docker
   • (Optional) Review Docker Engine post-install steps for applicable changes you may want to make. https://docs.docker.com/engine/install/linux-postinstall/
   • NOTE: There should be no reason to configure TLS support for inbound connection - we don't expose any inbound ports currently. 
2. Verify network connectivity to SSIS and https://controller.adastra.live
3. Install Data Collector via Docker Engine
   
   Example Docker Engine command to install data collector: 
   
4. An Ad Astra team member will supply credential information below:
   • TOKEN
   • ID
   • LABEL
5. Ad Astra occasionally updates the Data Collector Docker Engine Container and recommends you periodically `Docker Engine pull` and restart the Data Collector Agent. One option is to use `Watchtower` to automatically update the Data Collector container to the latest version:
   
   NETWORK DIAGRAM