interfaces
configuration to configure additional IP
addresses for interfaces, including bonding interfaces, and static routes. eth0
,
eth1
, and eth2
interfaces, you must include
the configurations of all configuration information of each interface in the body of
the JSON configuration even if you are only updating the configuration of
eth1
.You can also configure individual interfaces when provisioning a DNS/DHCP Server using cloud-init. For more information, refer to Configuring DNS/DHCP Server services using cloud-init.
Configuring additional IP addresses
Additional DNS service addresses provide flexibility and centralized control when consolidating old DNS servers into one single server without disrupting any configurations that might be using the old IP addresses.
{
"version": "1.1.0",
"services": {
"interfaces": {
"configurations": [
{
"interfacesConfiguration": {
"dedicatedManagement": false,
"networkInterfaces": [
{
"eth0": {
"physical": {
"active": true,
"description": "eth0",
"v4addresses": [
{
"ip4": "1.1.1.1",
"cidr": 24
}
],
"v6addresses": [
{
"ip6": "fc00:729::101",
"cidr": 64
}
]
},
"vlan": [
{
"vlanid": 1,
"active": true,
"v4addresses": [
{
"ip4": "10.10.10.1",
"cidr": 24
}
]
}
]
}
},
{
"eth1": {
"physical": {
"active": true,
"description": "eth1",
"v4addresses": [
{
"ip4": "1.1.1.2",
"cidr": 24
}
],
"v6addresses": [
{
"ip6": "fc00:729::102",
"cidr": 64
}
]
},
"vlan": [
{
"vlanid": 2,
"active": true,
"v4addresses": [
{
"ip4": "10.10.10.2",
"cidr": 24
}
]
}
]
}
},
{
"eth2": {
"physical": {
"active": true,
"description": "eth2",
"v4addresses": [
{
"ip4": "1.1.1.3",
"cidr": 24
}
],
"v6addresses": [
{
"ip6": "fc00:729::103",
"cidr": 64
}
]
},
"vlan": [
{
"vlanid": 3,
"active": true,
"v4addresses": [
{
"ip4": "10.10.10.3",
"cidr": 24
}
]
}
]
}
},
{
"eth3": {
"physical": {
"active": true,
"description": "eth3",
"v4addresses": [
{
"ip4": "1.1.1.4",
"cidr": 24
}
],
"v6addresses": [
{
"ip6": "fc00:729::104",
"cidr": 64
}
]
},
"vlan": [
{
"vlanid": 4,
"active": true,
"v4addresses": [
{
"ip4": "10.10.10.4",
"cidr": 24
}
]
}
]
}
},
{
"lo": {
"active": true,
"description": "aaa",
"v4addresses": [
{
"ip4": "1.1.1.3",
"cidr": 32
}
],
"v6addresses": [
{
"ip6": "fc00:729::103",
"cidr": 128
}
]
}
}
],
"routes": []
}
}
]
}
}
}
dedicatedManagement
—set to true to enable dedicated management; set to false to disable dedicated management.Attention: You cannot update thededicatedManagement
setting.networkInterfaces
—enter the network interfaces that you would like to configure. You can configure ethernet interfaces (eth
), loopback interface (lo
), or bonding interfaces (bond
).For more information on configuring bonding interfaces, refer to Configuring bonding interfaces.
Attention:- You can configure multiple
eth<number>
interfaces. However, the number of eth interfaces configured on the DNS/DHCP Server is dependent on how many interfaces are available on the virtual machine or appliance. - You cannot update the
ip4
andip6
addresses of theeth0
,eth2
, andbond0
interfaces.
active
—set to true to activate the specified interface; set to false to deactivate the specified interface.description
—enter a description for the specified interface. You can enter up to 80 alphanumeric characters including spaces, but excluding special characters.v4addresses
—enter the IPv4 addresses that you would like to configure for the interface.ip4
—enter the IPv4 address of the specified interface.cidr
—enter the CIDR of the IP space for the specified interface.
v6addresses
—enter the IPv6 addresses that you would like to configure for the interface.ip6
—enter the IPv6 address of the specified interface.cidr
—enter the CIDR of the IP space for the specified interface.
vlan
—enter the VLAN information for the specified interface.Attention: You cannot configure the primary IP address of a VLAN interface.vlanid
—enter the VLAN ID of the specified interface. The VLAN ID can be a number from 1 to 4094.description
—enter a description for the VLAN interface. You can enter up to 80 alphanumeric characters including spaces, but excluding special characters.active
—set to true to activate the VLAN interface; set to false to deactivate the VLAN interface.v4addresses
—enter the IPv4 addresses that you would like to configure for the interface.ip4
—enter the IPv4 address of the specified interface.cidr
—enter the CIDR of the IP space for the specified interface.
v6addresses
—enter the IPv6 addresses that you would like to configure for the interface.ip6
—enter the IPv6 address of the specified interface.cidr
—enter the CIDR of the IP space for the specified interface.
- You can configure multiple
routes
—enter the static route information.For more information on static route configuration, refer to Configuring static routes.
Configuring bonding interfaces
You can configure network redundancy through port bonding.
Supported bonding modes
- Failover— Active/Backup bonding where only one interface in the bond is active (Primary). This allows the secondary interface (eth3) to take over transparently if the Primary interface (eth0) fails.
- Load Balancing—Active/Active bonding using industry standard 802.3ad aggregation protocol, where aggregation groups share the same speed and duplex settings. Each interface shares the throughput and each interface is active; neither interface is a primary nor a secondary.
{
"version": "1.1.0",
"services": {
"interfaces": {
"configurations": [
{
"interfacesConfiguration": {
"dedicatedManagement": false,
"networkInterfaces": [
{
"bond0": {
"mode": "activeBackup",
"physical": {
"active": true,
"description": "bond interface",
"v4addresses": [],
"v6addresses": []
}
}
},
{
"bond1": {
"mode": "activeActive",
"physical": {
"active": true,
"description": "bond interface",
"v4addresses": [],
"v6addresses": []
}
}
},
{
"eth0": {
"physical": {
"active": true,
"description": "eth0",
"v4addresses": [
{
"ip4": "1.1.1.1",
"cidr": 24
}
],
"v6addresses": [
{
"ip6": "fc00:729::101",
"cidr": 64
}
]
},
"vlan": [
{
"vlanid": 1,
"active": true,
"v4addresses": [
{
"ip4": "10.10.10.1",
"cidr": 24
}
]
}
]
}
},
{
"eth1": {
"physical": {
"active": true,
"description": "eth1",
"v4addresses": [
{
"ip4": "1.1.1.2",
"cidr": 24
}
],
"v6addresses": [
{
"ip6": "fc00:729::102",
"cidr": 64
}
]
},
"vlan": [
{
"vlanid": 2,
"active": true,
"v4addresses": [
{
"ip4": "10.10.10.2",
"cidr": 24
}
]
}
]
}
},
{
"eth2": {
"physical": {
"active": true,
"description": "eth2",
"v4addresses": [
{
"ip4": "1.1.1.3",
"cidr": 24
}
],
"v6addresses": [
{
"ip6": "fc00:729::103",
"cidr": 64
}
]
},
"vlan": [
{
"vlanid": 3,
"active": true,
"v4addresses": [
{
"ip4": "10.10.10.3",
"cidr": 24
}
]
}
]
}
},
{
"eth3": {
"physical": {
"active": true,
"description": "eth3",
"v4addresses": [
{
"ip4": "1.1.1.4",
"cidr": 24
}
],
"v6addresses": [
{
"ip6": "fc00:729::104",
"cidr": 64
}
]
},
"vlan": [
{
"vlanid": 4,
"active": true,
"v4addresses": [
{
"ip4": "10.10.10.4",
"cidr": 24
}
]
}
]
}
}
],
"routes": []
}
}
]
}
}
}
dedicatedManagement
—set to true to enable dedicated management; set to false to disable dedicated management.Attention: You cannot update thededicatedManagement
setting.bond
—enter the network interfaces that you would like to configure.mode
—enter the type of bond mode that you would like to configure. The value can beactiveActive
oractiveBackup
active
—set to true to activate the specified interface; set to false to deactivate the specified interface.description
—enter a description for the specified interface. You can enter up to 80 alphanumeric characters including spaces, but excluding special characters.v4addresses
—enter the IPv4 addresses that you would like to configure for the interface.Attention: You cannot update theip4
addresses of an existingbond0
interface.ip4
—enter the IPv4 address of the specified interface.cidr
—enter the CIDR of the IP space for the specified interface.
v6addresses
—enter the IPv6 addresses that you would like to configure for the interface.ip6
—enter the IPv6 address of the specified interface.cidr
—enter the CIDR of the IP space for the specified interface.
routes
—enter the static route information.For more information on static route configuration, refer to Configuring static routes.
Configuring static routes
You can also add static routes to indicate where the system should send packets intended for certain IP addresses. Packets to be sent to hosts on the same subnet as the DNS/DHCP Server or can be routed directly to that subnet. The same procedures can be used to manage either IPv4 or IPv6 routes.
DNS/DHCP Server does not permit static routes that duplicate the network address and netmask of IP addresses configured on physical interfaces. However, you can configure static routes that overlap existing IP addresses on physical interfaces. That is, network addresses that are larger or smaller than the IP addresses on eth0, or eth2.
{
"version": "1.1.0",
"services": {
"interfaces": {
"configurations": [
{
"interfacesConfiguration": {
"routes": [
{
"gateway": "1.1.1.1",
"network": "default",
"cidr": 0
}
],
"dedicatedManagement": false,
"networkInterfaces": [
{
"eth0": {
"physical": {
"active": true,
"description": "eth0",
"v4addresses": [
{
"ip4": "1.1.1.1",
"cidr": 24
}
],
"v6addresses": [
{
"ip6": "fc00:729::101",
"cidr": 64
}
]
},
"vlan": [
{
"vlanid": 1,
"active": true,
"v4addresses": [
{
"ip4": "10.10.10.1",
"cidr": 24
}
]
}
]
}
},
{
"eth1": {
"physical": {
"active": true,
"description": "eth1",
"v4addresses": [
{
"ip4": "1.1.1.2",
"cidr": 24
}
],
"v6addresses": [
{
"ip6": "fc00:729::102",
"cidr": 64
}
]
},
"vlan": [
{
"vlanid": 2,
"active": true,
"v4addresses": [
{
"ip4": "10.10.10.2",
"cidr": 24
}
]
}
]
}
},
{
"eth2": {
"physical": {
"active": true,
"description": "eth2",
"v4addresses": [
{
"ip4": "1.1.1.3",
"cidr": 24
}
],
"v6addresses": [
{
"ip6": "fc00:729::103",
"cidr": 64
}
]
},
"vlan": [
{
"vlanid": 3,
"active": true,
"v4addresses": [
{
"ip4": "10.10.10.3",
"cidr": 24
}
]
}
]
}
},
{
"eth3": {
"physical": {
"active": true,
"description": "eth3",
"v4addresses": [
{
"ip4": "1.1.1.4",
"cidr": 24
}
],
"v6addresses": [
{
"ip6": "fc00:729::104",
"cidr": 64
}
]
},
"vlan": [
{
"vlanid": 4,
"active": true,
"v4addresses": [
{
"ip4": "10.10.10.4",
"cidr": 24
}
]
}
]
}
}
]
}
}
]
}
}
}
dedicatedManagement
—set to true to enable dedicated management; set to false to disable dedicated management.Attention: You cannot update thededicatedManagement
setting.networkInterfaces
—enter the network interfaces of the existing configuration. You can configure ethernet interfaces (eth
), loopback interface (lo
), or bonding interfaces (bond
).For more information on the network interface configuration, refer to Configuring bonding interfaces and Configuring additional IP addresses.
routes
—enter the static route information that you would like to configure.network
—enter the IP address of the network. If you are configuring a default route, set the value todefault
gateway
—enter the IP address of the gateway.cidr
—enter the CIDR of the IP space for the specified network. If you are configuring a default route, set the value to0
.