create-interface

Posted 2014-03-18 01:37 by Joe

create-interface.pl

create-interface.pl

Adds a new network interface to some system

This program adds a virtual interface to some Cloudmin-managed system. You must specify the system with the --host parameter, and the base interface with --name. The IP address can be either explitly set with --address, or Cloudmin can allocate a free IP from the range defined for the host system with --allocate.

On Xen and KVM systems an additional real network interface can be created with the --real flag. In this case, the --name parameter must be followed by an interface that does not exist yet, like eth1. If the host system has multiple bridges, the --bridge flag can be used to select a bridge, like xenbr0.

Xen, KVM and physical systems running Linux can also have IPv6 addresses added to new real interfaces using this command. To add an address, use the --add-address6 flag followed by an IPv6 address or address/netmask.

For KVM and Xen systems using HVM, the --model flag can be used to set the type of network card that is emulated on the virtual system. This is only possible for real interfaces though.

For KVM and Xen systems, the --ether flag can be used to set the ethernet address of the new interface. If not specified, a random ethernet address will be selected by Cloudmin.

Either way, the full interface name and IP address will be displayed if the command completes successfully.

Example usage

  cloudmin create-interface --host vvirtualmin.home --name eth0 --address 193.9.101.250
  Created interface eth0:3 with address 193.9.101.250

Command Line Help

Adds a network interface to some virtual system.

cloudmin create-interfaces --host hostname
                           --name interface
                           --address ip.address | --allocate
                          [--netmask ip.netmask]
                          [--real [--bridge name] [--model type]]
                          [--address6 ipv6-address]*
                          [--ether ethernet-address]