4.3.18.2 CREATE GUEST

This command creates a new virtual machine (VM) guest.

Syntax

CREATE GUEST
   NAME=guest_name
SET PARENT NAME=parent_name 
SET ADMINNET NAME=admin_name [ IP=admin_ip GATEWAY=gateway NETMASK=netmask VLANID=vlan_ID ]
SET CLIENTNET NAME=client_name [ IP=client_ip GATEWAY=gateway NETMASK=netmask VLANID=vlan_ID ]
[ SET CLIENTNET NATHOSTNAME=nat_host_name NATIP=nat_ip NATDOMAINNAME=nat_domain_name, NATNETMASK=nat_netmask ]
[ SET BACKUPNET NAME=backup_name [ IP=backup_ip GATEWAY=gateway NETMASK=netmask VLANID=vlan_ID ] ]
SET PRIVNET NAME1=priv_name_1 IP1=priv_ip1 NAME2=priv_name_2 IP2=priv_ip2 
[ SET INTERCONNECT NAME1=priv_name_1 IP1=priv_ip1 NAME2=priv_name_2 IP2=priv_ip2 ]
[ SET VCPU COUNT=guest_cpu ]
[ SET VMEM SIZE=guest_memory ]
[ SET VDISK SIZE=guest_disk ]

Arguments

  • NAME: Specifies the name of the new guest VM.

Additional settings in conjunction with the CREATE GUEST command:

  • PARENT: Specifies the name of the virtual machine (VM) host (Oracle Linux KVM or Oracle VM) that hosts the new guest.

  • ADMINNET : Specifies the DNS name to use for the administration network. Also, optionally specifies the IP address, gateway, netmask, and VLAN ID for the administration network.

  • CLIENTNET : Specifies the DNS name to use for the client network. Also, optionally specifies the IP address, gateway, netmask, and VLAN ID for the client network. May also optionally specify the host name, IP address, domain name, and netmask details to support Network Address Translation (NAT).

  • BACKUPNET : Specifies the DNS name to use for the backup network. Also, optionally specifies the IP address, gateway, netmask, and VLAN ID for the backup network.

  • PRIVNET : Specifies the names and IP addresses to use for the first and second private networks.

  • INTERCONNECT: Only required if the compute nodes are configured with Exadata Secure RDMA Fabric Isolation or InfiniBand security (PKEYS). Specifies the names and IP addresses to use for the first and second private networks.

  • VCPU : Specifies the number of virtual CPU cores allocated to the new guest VM.

  • VMEM : Specifies the amount of RAM (in GB) allocated to the new guest VM.

  • VDISK : Specifies the amount of disk space (in GB) allocated to the new guest VM.

Usage Notes

  • For configurations with Exadata Secure RDMA Fabric Isolation or InfiniBand security (PKEYS), INTERCONNECT defines the private network that connects the processing nodes and PRIVNET defines the private storage network.

  • You should save the modified XML file after the actions are merged so that you have a new XML file that reflects the addition of the new guest domain.

Example 4-26 Creating a Guest VM

This example shows how to create a new guest VM. In this example, the new guest is exa01adm03vm04.example.com. A series of SET commands are used to specify the configuration for the new guest VM. 

oedacli> LOAD FILE NAME=exa01adm03-pre-createing-vm04.xml
oedacli> CREATE GUEST NAME='exa01adm03vm04.example.com'
oedacli> SET PARENT NAME='exa01adm03.example.com'
oedacli> SET ADMINNET NAME='exa01adm03vm04.example.com' IP='10.xxx.xx.x'
oedacli> SET CLIENTNET NAME='exa01client03vm04.example.com' IP='10.xxx.xx.x'
oedacli> SET PRIVNET NAME1='exa01adm03vm04-priv' IP1='192.168.16.8' NAME2='exa01adm01vm03-priv2' IP2='192.168.16.9'
oedacli> SET VCPU COUNT=4
oedacli> SET VMEM SIZE=16GB
oedacli> SET VDISK SIZE=50GB
oedacli> SAVE ACTION
oedacli> MERGE ACTIONS
oedacli> SAVE FILE NAME='exa01adm03-after-createing-vm04.xml'
oedacli> DEPLOY ACTIONS

Example 4-27 Creating Multiple Guests at the Same Time

This example creates the new guests guest04 and guest05 on the host named host01. Both new guests are deployed at the same time in the final DEPLOY ACTIONS. 

CREATE GUEST NAME='guest04'
SET PARENT name='host01'
...
SAVE ACTION FORCE

CLONE GUEST NAME='guest05'
SET PARENT name='host01'
...
SAVE ACTION FORCE

MERGE ACTIONS
DEPLOY ACTIONS

Parent topic: GUEST