oakcli configure vmtemplate

Use the oakcli configure vmtemplate command to configure a virtual machine template on Oracle Database Appliance Virtualized Platform.

Syntax

oakcli configure vmtemplate name [-vcpu cpucount -maxvcpu maxcpu -cpuprio
 priority -cpucap cap -memory memsize -maxmemory max_memsize -os sys -keyboard
 lang -mouse mouse_type -domain dom -network netlist -disk disks][h]

Parameters

Parameter Description

name

Name assigned to the virtual machine template

-vcpu cpucount

Number of nodes assigned to virtual machines cloned from the template:

  • On Oracle Database Appliance X5-2, the range is from 1 to 72.

  • On Oracle Database Appliance X4-2, the range is from 1 to 48.

  • On Oracle Database Appliance X3-2, the range is from 1 to 32.

  • On Oracle Database Appliance, the range is 1 to 24.

-maxvcpu maxcpu

Maximum number of CPUs that virtual machines cloned from the template can consume:

  • On Oracle Database Appliance X5-2, the range is from 1 to 72.

  • On Oracle Database Appliance X4-2, the range is from 1 to 48.

  • On Oracle Database Appliance X3-2, the range is from 1 to 32.

  • On Oracle Database Appliance, the range is 1 to 24.

-cpuprio priority

Priority for CPU usage, where larger values have higher priority (1 to 256).

-cpucap cap

Percentage of a CPU that virtual machines cloned from the template can receive (1 to 100).

-memory memsize

Amount of memory given to virtual machines cloned from the template (1G to 88 G or 1M to 90112M)

-maxmemory max_memsize

Maximum amount of memory allowed for virtual machines cloned from the template

-os sys

Operating system used by virtual machines cloned from the template (WIN_2003, WIN_2008, WIN_7, WIN_VISTA, OTHER_WIN, OL_4, OL_5, OL_6, RHL_4, RHL_5, RHL_6, LINUX_RECOVERY, OTHER_LINUX, SOLARIS_10, SOLARIS_11, OTHER_SOLARIS, or NONE)

-keyboard lang

Keyboard used by virtual machines cloned from the template (en-us, ar, da, de, de-ch, en-gb, es, et, fi, fo, fr, fr-be, fr-ca, hr, hu, is, it, ja, lt, lv, mk, nl, n--be, no, pl, pt, pt-br, ru, sl, sv, th, or tr)

-mouse mouse_type

Mouse type used by virtual machines cloned from the template (OS_DEFAULT, PS2_MOUSE, USB_MOUSE, or USB_TABLET)

-domain dom

Domain type from the following options:

  • Hardware virtualized guest (XEN_HVM)

    - The kernel or operating system is not virtualization-aware and can run unmodified.

    - Device drivers are emulated.

  • Para virtualized guest (XEN_PVM)

    - The guest is virtualization-aware and is optimized for a virtualized environment.

    - PV guests use generic, idealized device drivers.

  • Hardware virtualized guest (XEN_HVM_PV_DRIVERS)

    The PV drivers are hypervisor-aware and significantly reduce the overhead of emulated device input/output.

-network netlist

MAC address and list of networks used by virtual machines cloned from the template

-disk disks

List of disks (slot, disktype, and content) used by virtual machines cloned from the template

-h

(Optional) Display help for using the command.

Usage Notes

  • All of the parameters, except for name, are optional.

  • You must include at least one optional parameter for the command to work.

See Also:

Oracle VM Release 3.1 documentation, which is available at the following URL:

http://docs.oracle.com/cd/E27300_01 for more information about the options in the preceding table.

For example, see 2.8. Virtual Machines for details about the option -domain dom

http://docs.oracle.com/cd/E27300_01/E27309/html/vmusg-ovm-vms.html

Example

Set values for the following configuration values in the virtual machine template named myol5u7_10gb:

oakcli configure vmtemplate myol5u7_10gb
-vcpu 2 -maxvcpu 4 -cpucap 40 -memory 1536M -maxmemory 2G
-network "['type=netfront,bridge=net1']" -os OTHER_LINUX

  • -vcpu 2 = Two CPUs will assigned when the virtual machine starts up

  • -maxvcpu 4 = The maximum number of CPUs that can be assigned to the virtual machine is 4.

  • -cucap 40 = The maximum percentage of a CPU's capacity that will be assigned to the virtual machine is 40%.

  • -memory 1536M = The amount of memory assigned when the virtual machine starts up is 1536 MB.

  • -maxmemory 2G = The maximum amount of memory that can be assigned to the virtual machine is 2 GB.

  • -network type=netfront,bridge=net1 = This is the list of networks used by virtual machines cloned from the template.

  • -os = The operating system used by the virtual machine is OTHER_LINUX.