Install¶

Prerequisites¶

System¶

The provisioning template targets a Linux deployment on a server/cluster meeting the following requirements:

Linux kernel >= 3.8
12 GB available in a storage pool
sudo rules to execute opensvc agent commands as root
docker >= 1.8

Cluster¶

The OpenSVC agent must be installed, as the provisioning method exposed here creates a OpenSVC service.

The agent installation instructions are accessible at Install.

Exposing the collector service needs either a dedicated ip address, or a cluster gateway.

Network¶

From	To	Port	Comments
Agent	Collector	TCP/443	Push node and service informations and states
Collector	Agent	TCP/1214	Notify agent for action dequeue
Web Browser	Collector	TCP/443	Access to collector web interface
Command Line	Collector API	TCP/443	Access to collector Rest/API

Proxies and firewalls¶

Internet HTTPS access should be allowed for:

hub.docker.com (docker images registry)
github.com/opensvc (application code download)
raw.githubusercontent.com/opensvc/opensvc_templates (provisioning template download)

Deploy the service¶

Follow the instructions at https://github.com/opensvc/opensvc_templates/tree/main/collector.

The database still bootstraps for a few minutes after the deploy command exits. An error page can be displayed in the browser while this bootstrap runs.

First steps¶

The default administrator account is root@localhost.localdomain with the opensvc password.

You can now:

register the agent on this collector, using instructions at https://docs.opensvc.com/agent.install.html.
changes default passwords.
add new users, remove the default admin user
import compliance designs
import provisioning templates
provision a docker private registry service delegating auth to this new collector.
provision a PowerDNS service serving the collector-maintained zones.

Enjoy the experience, and send feedback to support@opensvc.com.

Contact sales@opensvc.com for meetings, support, training, production licenses.