Skip to main content

Brainspace

(Optional) Setup Portainer

The Docker Swarm deployment of Brainspace can be managed and monitored entirely from the command line, but if you would like to use a graphical user interface, we recommend using Portainer.

Portainer CE is an open-source tool that can be used to monitor and administer a Docker Swarm. It is completely optional to use with Brainspace but could be useful for administrators who would prefer a GUI interface over the command line. There is also a paid version of the tool that provides support and additional features, but the community edition is sufficient for most cases.

To install Portainer with the UI, see: https://docs.portainer.io/start/install-ce/server/swarm/linux.

  1. Download Portainer stack config files.

  2. Deploy the Portainer stack and visit the UI at https://<BRS 7 hostname>:9443 to get started.

If you install Portainer on the application host, it should have access to the Brainspace Docker Swarm cluster automatically.

A single Portainer UI can be used to monitor several Brainspace 7 instances. If you’d like to see all of the Brainspace instances monitored on a single UI, you just need to add the additional clusters to the Portainer UI setup above.

To add additional Brainspace Docker Swarm Clusters to the Portainer UI, deploy the Portainer agent on the other clusters’ application host (leader), and then add a new “Environment” through the Portainer UI.

To install just the agent on a different cluster, use the config file in the Brainspace deployment zip file named portainer-agent-only.yml:

docker stack deploy -c portainer-agent-only.yml portainer

Next, add a new Environment, and select “Docker Swarm”.

BRS7_Docker_Swarm_Environment_Setup.png