Advanced Usage

This basic setup will work for a small conference. It is possible to add more rooms by including more Voctomix and Opsis machines in their respective groups. These machines need corresponding inventory/host_vars/ files, which need to be changed to reflect the details of the room each machine is in.

If you need a machine with a minimal install (network, ssh, etc.) to test different roles, you can install a host with the hostname of base. You will then be able to run ansible manually for your tests.

Entries also need to be added to the staticips.hosts dictionary in inventory/group_vars/all.

For large setups, using PXE booting to configure machines, you should create a git repository with your copy of inventory/. See our config repo for an example of how to set this up. It requires setting inventory_repo in inventory/group_vars/all. inventory_repo_dir names the directory within this repo containing the inventory, this defaults to inventory/.

Static IPs and MAC addresses can be specified using the following dictionary in inventory/group_vars/all:

staticips:
  hosts:
  - hostname: gw
    ip: 10.18.0.1
    mac: 00:00:00:00:00:00
  - hostname: voctomix1
    ip: 10.18.0.10
    mac: 00:00:00:00:00:00
  - hostname: opsis1
    ip: 10.18.0.11
    mac: 00:00:00:00:00:00
  write_hosts: false
  write_interfaces: false

This will automatically assign the machine a hostname when PXE booting and will ensure that it has a static IP from the gateway.