Virtual Machine

virtual-machine enable
no virtual-machine enable

Enables VM feature on the switch.
The no form of the command disables VM feature on the switch.

Syntax Description

N/A

Default

no virtual-machine enable

Configuration Mode

config

History

3.4.0000

Example

switch (config) # virtual-machine enable

Related Commands

Notes

virtual-machine host <vm-name>
no virtual-machine host <vm-name>

Creates a VM, or enters its configuration context if it already exists.
The no form of the command removes the VM with the specified name.

Syntax Description

vm-name

Configures a name for the VM

Default

N/A

Configuration Mode

config

History

3.4.0000

Example

switch (config)# virtual-machine host my-vm
switch (config virtual-machine host my-vm)#

Related Commands

Notes

arch {i386 | x86_64}

Configures VM CPU architecture.

Syntax Description

i386

32-bit x86 CPU architecture

x86_64

64-bit x86 CPU architecture

Default

x86_64

Configuration Mode

config virtual machine host

History

3.4.0000

Example

switch (config virtual-machine host my-vm)# arch i386

Related Commands

virtual-machine

Notes

comment <string>
no comment

Configures a comment describing the VM.
The no form of the command deletes the configured comment.

Syntax Description

string

Free string

Default

N/A

Configuration Mode

config virtual machine host

History

3.4.0000

Example

switch (config virtual-machine host my-vm)# comment “example VM”

Related Commands

virtual-machine

Notes

To configure a multi-word string, the string must be placed within quotation marks

install {cancel |cdrom [pool <pool-name>] {file <volume-name> [connect-console <console-type> | disk-overwrite | timeout {<minutes> | none}]}}

Installs an operating system onto this VM (temporarily attach a CD and boot from it).

Syntax Description

cancel

Cancels an install already in progress

cdrom

Installs an operating system from a CD-ROM (ISO) image

pool <pool-name>

Configures storage pool in which to find image to install:

• default

• usb

file <volume-name>

Specifies CD-ROM (ISO) image from which to install

connect-console <console-type>

Connects to the console during installation. The types may be:

• text—text console

• graphics—graphical console

disk-overwrite

Installs even if primary target volume is not empty

timeout {<minutes> | none}

Configures a timeout for installation in minutes (default is no timeout)

Default

N/A

Configuration Mode

config virtual machine host

History

3.4.0000

Example

switch (config virtual-machine host my-vm)# install cdrom pool usb file <image>

Related Commands

virtual-machine

Notes

The default pool from which the system installs the ISO image is the /var/ partition in the switch

interface <id> {bridge <bridge> | macaddr <mac> | model <model> | name <name>}

Configures virtual interfaces.

Syntax Description

<id>

Interface ID number (1-8 permitted)

bridge <bridge>

Configures bridge for this interface (i.e. mgmt0 or mgmt1)

macaddr <mac>

Configures MAC address (e.g., ff:ee:dd:cc:bb:aa)

model <model>

Configures virtual interface model:

• realtek-8139—Realtek 8139 (default)

• virtio—Virtual IO

name <name>

Configures virtual interface name
The name must begin with “vif”

Default

N/A

Configuration Mode

config virtual machine host

History

3.4.0000

Example

switch (config virtual-machine host my-vm)# interface 1 model virtio

Related Commands

virtual-machine

Notes

memory <MB>

Configures memory allowance.

Syntax Description

MB

Size in megabytes

Default

512MB

Configuration Mode

config virtual machine host

History

3.4.0000

Example

switch (config virtual-machine host my-vm)# memory 1024

Related Commands

virtual-machine

Notes

It is recommended not to allocate more than 1GB of memory per VM

power {cycle [force | connect-console {graphics | text}] | off [force] | on [connect-console {graphics | text}]}

Turns the VM on or off, or other related options.

Syntax Description

cycle

Powers the VM down and then on again immediately

force

Forces an action on the system

connect-console <console-type>

Connects to the console after power-on. The types may be:

• text—text console

• graphics—graphical console

off

Powers down the VM

on

Powers on VM

Default

N/A

Configuration Mode

config virtual machine host

History

3.4.0000

Example

switch (config virtual-machine host my-vm)# power cycle force

Related Commands

virtual-machine

Notes

storage create disk [drive-number <number> | file <filename> | mode {read-only | read-write} | pool <pool-name> | size-max <MB>]

Creates a new storage device for the VM, with an automatically assigned name.

Syntax Description

create disk

Creates a new virtual disk image for this VM.

drive-number <number>

Specifies the drive number to be assigned to the volume.
Insert “new” to assign a new drive number to the volume.

file <filename>

Specifies filename for new volume to be created.

mode {read-only | read-write}

Specifies initial device mode.

pool <pool-name>

Specifies storage pool in which to create new volume.

size-max <MB>

Specifies maximum disk capacity in megabytes.

Default

N/A

Configuration Mode

config virtual machine host

History

3.4.0000

Example

switch (config virtual-machine host my-vm)# storage create disk size-max 2000

Related Commands

virtual-machine

Notes

storage device [bus ide] drive-number <number> [mode {read-only | read-write}] source {[pool <pool-name>] file <filename>}
no storage device [bus ide] drive-number <id>

Modifies existing storage device, or create a new one with a specific name.
The no form of the command removes a storage device from the VM.

Syntax Description

device

Modifies existing storage device, or creates a new one with a specific name.

bus ide

Configures bus type to IDE.

drive-number <number>

Selects device to configure by drive number.

mode {read-only | read-write}

Configures the device mode:

• read-only—sets the read-only attribute of the volume

• read-write—sets the read-write attribute of the volume

source

Specifies where the data for this volume resides

file <filename>

Specifies the filename for this volume.

pool <pool-name> file <filename>

Specifies the storage pool for this volume.

Default

N/A

Configuration Mode

config virtual machine host

History

3.4.0000

Example

switch (config virtual-machine host my-vm)# storage create disk bus ide

Related Commands

virtual-machine

Notes

vcpus {count <count> | vcpu <vcpu> pin <cpu-list> [<cpu-list>]}
no vcpus {pin | vcpu <vcpu> pin}

Specifies virtual CPUs.
The no form of the command removes certain CPU configuration.

Syntax Description

count <count>

Specifies the number of virtual CPUs.

vcpu <vcpu>

Specifies options for a particular virtual CPU.

pin <cpu-list>

Specifies physical CPUs to pin to this vCPU.

Default

N/A

Configuration Mode

config virtual machine host

History

3.4.0000

Example

switch (config virtual-machine host my-vm)# vcpus count 1

Related Commands

Notes

virt volume fetch url <download-url> [filename <filename> | pool <pool-name> filename <filename>]

Fetches volume image from a remote host.

Syntax Description

download-url

Specifies URL from which to fetch a volume
Supported formats: http, https, ftp, tftp, scp and sftp are supported (e.g., scp://username[:password]@hostname/path/filename)

filename <filename>

Specifies new filename for fetched volume image

pool-name <pool-name>

Specifies storage pool for fetched volume image

Default

N/A

Configuration Mode

config virtual machine host

History

3.4.0000

Example

switch (config) # virtual-machine volume fetch scp://username[:password]@hostname/path/filename

Related Commands

Notes

virt volume file <name> {create disk size-max <MB> | move {new-name <new-name> | pool <pool-name> new-name <new-name>} | upload <upload-url>}
no virt volume file <volume-name>

Specifies name of volume file to manage.
The no form of the command deletes the volume file.

Syntax Description

name

Specifies name of volume file to manage.

create

Creates a new volume file under this name.

disk size-max <MB>

Specifies maximum capacity of virtual disk to create.

move

Moves or renames this volume.

new-name <filename>

Specifies a name for the destination file.

pool <pool-name> new-name <filename>

Specifies a storage pool for the copy.

upload <upload-url>

Uploads this volume file to a remote host.
Supported format: ftp, tftp, scp and sftp are supported (e.g., scp://username[:password]@hostname/path/filename).

Default

N/A

Configuration Mode

config virtual machine host

History

3.4.0000

Example

switch (config) # virt volume file my-vm_file create cdrom extract cdrom1

Related Commands

Notes

show virtual-machine configured

Displays global virtualization configuration.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any command mode

History

3.4.0000

Example

switch (config) # show virtual-machine configured
Virtualization enabled:       yes
Virtual machines:             2 configured
Virtual networks:             0 configured

Related Commands

Notes