Configuration

myra-canyon.conf

The Myra Canyon configuration file is named /etc/myra-canyon.conf. If this file doesn't exist, then a default file is automatically created on startup from the template /usr/share/myra/myra-canyon.conf-template.

The configuration file /etc/myra-canyon.conf is a plain text JSON file, and can be easily edited with any normal text editor.

Todo:

The eventual goal is to have configuration happen in the web interface.

device

The device section of configuration describes the networking device to be used by Myra Canyon. An alias will be created on this device, and networking will be setup as described. For example:

"device" :
{
    "type"          : "alias",
    "name"          : "eth0",
    "alias"         : "myra0",
    "address"       : "10.0.1.1",
    "network"       : "10.0.1.0",
    "broadcast"     : "10.0.1.255",
    "netmask"       : "255.255.255.0"
},

This tells Myra Canyon to create the alias eth0:myra0. The alias will use the address 10.0.1.1/255.255.255.0.

Todo:

The eventual goal is to support other solutions, such as multiple interfaces. For now, the only supported model is a computer with a single interface, and an alias created for the 2nd network. (Also known as one armed router, or router on a stick.)

dhcpd

The dhcpd section of configuration contains information needed to configure the ISC Consortium DHCP Server.

"dhcpd" :
{
    "range"     : "10.0.1.10 10.0.1.254",
    "ignore"    :
    [
        { "subnet" : "192.168.1.0", "netmask" : "255.255.255.0" },
        { "subnet" : "192.168.2.0", "netmask" : "255.255.255.0" }
    ]
},

For example, if your LAN is using 192.168.1.0/24, then you must include an entry in the ignore section to tell dhcpd to ignore that network. Otherwise, dhcpd will refuse to run.

dns

The dns section of configuration contains information needed to configure Bind9, the name server.

"dns" :
{
    "acl_cidr" : "10.0.1.0/24"
}

For example, if Myra Canyon is setup to create a 10.0.1.0/255.255.255.0 network, then acl_cidr must include the same network in CIDR format. This ensures that clients on the 10.0.1.0/24 network can make name server requests to the Myra Canyon router.