fleet-manager

README

fleet-manager

SmallStack Fleet Manager.

The fleet-manager daemon manages a fleet of Hypervisors and the Virtual Machines running on them. Please read the SmallStack design document to understand the architecture.

Status page

The fleet-manager provides a web interface on port 6977 which shows a status page, links to built-in dashboards and access to performance metrics and logs. If fleet-manager is running on host myhost then the URL of the main status page is http://myhost:6977/. An RPC over HTTP interface is also provided over the same port.

Startup

fleet-manager is started at boot time, usually by one of the provided init scripts. The fleet-manager process is baby-sat by the init script; if the process dies the init script will re-start it. It may be stopped with the command:

service fleet-manager stop

which also kills the baby-sitting init script. It may be started with the comand:

service fleet-manager start

There are many command-line flags which may change the behaviour of fleet-manager but many have defaults which should be adequate for most deployments. Built-in help is available with the command:

fleet-manager -h

Security

RPC access is restricted using TLS client authentication. fleet-manager expects a root certificate in the file /etc/ssl/CA.pem which it trusts to sign certificates which grant access to methods. It trusts the root certificate in the /etc/ssl/IdentityCA.pem file to sign identity-only certificates.

It also requires a certificate and key which grant it the ability to manage Hypervisors. These should be in the files /etc/ssl/fleet-manager/cert.pem and /etc/ssl/fleet-manager/key.pem, respectively.

Control

The vm-control utility may be used to create, modify and destroy VMs.

The hyper-control utility is used to perform administrator tasks on Hypervisors.