Skip to content

Deployment Guide_Single Node

Katharina Bassler edited this page Jun 22, 2023 · 3 revisions

Single-node Deployment Guide

For testing and developing purposes, a single-node setup can be achieved for both the prosEO Control Instance and the prosEO Processing Facility on a MacOS or Windows machine with sufficient RAM and disk capacity.

Pre-Requisites

The target machine must have unrestricted access to resources on the Internet.

Ensure that the machine has the minimum hardware requirements:

  • CPUs: At least 4 cores
  • RAM: At least 16 GB
  • Disk: At least 200 GB of storage

High-level Step-by-Step Guide

Follow the steps below for a successful single-node deployment. For more detailed instructions, refer to deploy-single-node/README.md.

  1. Install Docker and Kubernetes: Download Docker and Kubernetes from their respective official websites and install them. Ensure the installed versions are compatible with prosEO.
  2. Deploy and run a Kubernetes Dashboard: The Kubernetes dashboard provides a user-friendly interface to monitor your cluster, which is responsible for the actual data processing. Follow the instructions in the official Kubernetes documentation to deploy and run the dashboard.
  3. Build the prosEO Control Instance: the prosEO Control Instance consists of several microservices for which images specific to the environment and use case need to be created using the Dockerfiles and application.yml.template files in deploy-single-node/proseo-images/proseo-components/*.
  4. Deploy and run the prosEO Control Instance: Once the Control Instance is built, deploy and run it using the commands specified in the README.
  5. Install and run the prosEO Command Line Interface: The prosEO CLI allows for easy interaction with the prosEO system.
  6. Create a Planner Account: To manage and plan the execution of tasks, create a planner account.
  7. Configure a prosEO (test) mission: Create and configure a test mission in prosEO. This will allow you to simulate the actual operation of the software.
  8. Set up the Kubernetes Cluster with the Storage Manager and a file system cache: Set up the cluster, storage manager, and file system cache.
  9. Configure the prosEO Processing Facility: The final step involves setting up the prosEO Processing Facility, which will process the Earth observation data.

Deployment Testing

Ensure the successful deployment by conducting appropriate tests. A minimum recommendation are:

  • CLI tests
  • GUI tests
  • PRIP tests eg. via Postman

Troubleshooting and Support

For any issues encountered during the deployment, refer to the deployment FAQ. For further technical support, contact tangobravo62.

Clone this wiki locally