Adding Network Interfaces to an Existing Guest

You can use OEDACLI to add network interfaces to an existing virtual machine (VM) guest without downtime or server reboots.

Note:

You can add interfaces using IPv6 to an existing guest using IPv4, or add IPv4 interfaces to a guest already using IPv6. The following examples focus on adding IPv6 interfaces. However, you can adapt the same commands to add IPv4 interfaces. Substitute your own hostname and IP address values as required.

Adding a Network Interface

To add a network interface to an existing guest, use the OEDACLI ADD NETWORK command.

For example, the following command sequence adds an IPv6 client network interface to an existing guest:

oedacli> ADD NETWORK NETWORKTYPE=CLIENT HOSTNAME=exa01vm01-client IP='2001:db8::100' MASTER=bondeth0 NETMASK=64
         DOMAINNAME=example.com GATEWAY='2001:db8::' WHERE HOSTNAME=exa01vm01.example.com
oedacli> save action
oedacli> merge action
oedacli> deploy actions

In the example:

NETWORKTYPE=CLIENT specifies the addition a client network interface. Alternatively, you could use NETWORKTYPE=ADMIN to add a management network interface.
MASTER=bondeth0 specifies that the new interface is associated with the existing bondeth0 network interface. This is the typical setting for client network interfaces on a guest. The typical setting for management network interfaces is MASTER=eth0.
The other arguments specify attributes of the IPv6 interface. Note that for IPv6 interfaces, NETMASK specifies the prefix length, which is the IPv6 equivalent of the subnet mask in IPv4.

Adding a Cluster VIP

To add a cluster virtual IP (VIP) to an existing guest, use the OEDACLI ADD VIP command.

For example, the following command sequence adds an IPv6 VIP to an existing guest:

oedacli> ADD VIP NAME=exa01vm01-vip IP='2001:db8::101' NETMASK=64
         DOMAINNAME=example.com WHERE HOSTNAME=exa01vm01.example.com
oedacli> save action
oedacli> merge action
oedacli> deploy actions

Adding a Cluster SCAN

To add a cluster Single Client Access Name (SCAN) to an existing cluster, use the OEDACLI ADD SCAN command.

For example, the following command sequence adds an IPv6 SCAN to an existing cluster:

oedacli> ADD SCAN SCANNAME=exa01-scan
         SCANIPS="2001:db8::111,2001:db8::112,2606:2001:db8::113" 
         SUBNET="2001:db8::/64" NETMASK=64 
         SCANTYPE=ipv6 GATEWAY="2001:db8::" WHERE CLUSTERNUMBER=1
oedacli> save action
oedacli> merge action
oedacli> deploy actions

In the example:

SCANTYPE=ipv6 specifies that the SCAN uses IPv6. If SCANTYPE is not specified, IPv4 is assumed. Or, you could explicitly specify SCANTYPE=ipv4 for an IPv4 SCAN.
The WHERE clause identifies the existing cluster using the cluster number recorded in the Exadata XML configuration file (es.xml).
The other arguments specify attributes of the IPv6 SCAN interface.

6.23.1 Adding Network Interfaces to an Existing Guest