fms

Documentation

Overview

Package fms encapsulates all the various parts of the Field Managent System, its associated configuration logic, and the APIs that talk to other systems.

Index

• Constants
• type Config
  • func LoadConfig(path string) (*Config, error)
  • func WizardChangeChannels(c *Config) (*Config, error)
  • func WizardChangeRoster(c *Config) (*Config, error)
  • func WizardSurvey(wouldOverwrite bool) (*Config, error)
• type ConfigureStep
• type Field
• type SetupTool
  • func NewSetupTool(l hclog.Logger) *SetupTool
  • func (st *SetupTool) Configure() error
  • func (st *SetupTool) Install() error
  • func (st *SetupTool) SetupBoot() error
• type Team

Constants

const (
	// AutomationUser is created on remote systems to allow the
	// FMS to manage them programattically.
	AutomationUser = "gizmo-fms"

	// ViewOnlyUser is created on remote systems to enable
	// debugging and generally make it possible to get into
	// systems.
	ViewOnlyUser = "gizmo-ro"
)

Types

type Config

type Config struct {
	// Teams contains the information needed to generate
	// configuration for all teams.
	Teams map[int]*Team

	// Fields contains a list of fields that are configured and
	// managed by the system.
	Fields map[int]*Field

	// FMSMac is the mac address of the FMS itself so that it can
	// have a pinned address
	FMSMac string

	AutoUser string
	AutoPass string
	ViewUser string
	ViewPass string

	// This is the actual "admin" user in RouterOS.  Generally
	// nobody should be logged in as this, but its here anyway so
	// its a known value.
	AdminPass string

	InfrastructureVisible bool
	InfrastructureSSID    string
	InfrastructurePSK     string
}

Config contains all the data that's necessary to setup the FMS and manage the network behind it.

func LoadConfig

func LoadConfig(path string) (*Config, error)

LoadConfig reads config off disk.

func WizardChangeChannels

func WizardChangeChannels(c *Config) (*Config, error)

WizardChangeChannels is used to reconfigure the channels each field is assigned to. This function duplicates some of the config in the field configuration step, but this is to avoid any possibility of creating or destroying a field.

func WizardChangeRoster

func WizardChangeRoster(c *Config) (*Config, error)

WizardChangeRoster is used to change the roster in an FMS Config that already exists. Teams will be loaded then reconciled. Existing teams can have name updated, but wireless parameters will not be changed.

func WizardSurvey

func WizardSurvey(wouldOverwrite bool) (*Config, error)

WizardSurvey runs a step by step config workflow to gather all the information required to generate the software configuration for the FMS.

type ConfigureStep

type ConfigureStep func() error

A ConfigureStep performa various changes to the system to configure it.

type Field

type Field struct {
	ID  int
	IP  string
	MAC string

	Channel string
}

Field contains the information related to each field.

type SetupTool

type SetupTool struct {
	// contains filtered or unexported fields
}

SetupTool does a lot of setup things for the FMS that are not something normal users would need to run.

func NewSetupTool

func NewSetupTool(l hclog.Logger) *SetupTool

NewSetupTool sets up a logger for the setup tool.

func (*SetupTool) Configure

func (st *SetupTool) Configure() error

Configure calls all the configure steps to configure the FMS workstation.

func (*SetupTool) Install

func (st *SetupTool) Install() error

Install pulls in all the packages and things that we need the network for and is intended to be called during a CI build to retrieve everything that's required to construct the image. Install does not require the system services to be running.

func (*SetupTool) SetupBoot

func (st *SetupTool) SetupBoot() error

SetupBoot installs the runtime hooks that startup the configuration jobs.

type Team

type Team struct {
	Name     string
	SSID     string
	PSK      string
	VLAN     int
	CIDR     string
	GizmoMAC string
	DSMAC    string
}

Team maintains information about a team from the perspective of the FMS