Product Documentation

Managing the NetScaler Guest VMs

Sep 03, 2013

You can use the Virtual Machine Manager and the virsh program to perform management tasks such as starting or stopping a VM Guest, setting up new guests and devices, editing existing configurations, and connecting to the graphical console through Virtual Network Computing (VNC).

Managing the NetScaler Guest VMs using Virtual Machine Manager

Updated: 2013-09-04

Listing the VM Guests
The main Window of the Virtual Machine Manager displays a list of all the VM Guests for each VM host server it is connected to. Each VM Guest entry contains the virtual machine's name, along with its status (Running, Paused, or Shutoff) displayed as icon.
Opening a Graphical Console
Opening a Graphical Console to a VM Guest enables you to interact with the machine like you would with a physical host through a VNC connection. To open the graphical console in the Virtual Machine Manager, right-click the VM Guest entry and select the Open option from the pop-up menu.
Starting and Shutting Down a Guest
You can start or stop a VM Guest from the Virtual Machine Manager. To change the state of the VM, right-click the VM Guest entry and select Run or one of the Shut Down options from the pop-up menu.

Rebooting a Guest
You can reboot a VM Guest from the Virtual Machine Manager. To reboot the VM, right-click the VM Guest entry, and then select Shut Down > Reboot from the pop-up menu.
Deleting a Guest
Deleting a VM Guest removes its XML configuration by default. You can also delete a guest's storage files. Doing so completely erases the guest.
  1. In the Virtual Machine Manager, right-click the VM Guest entry.
  2. Select Delete from the pop-up menu. A confirmation window opens.
    Note: The Delete option is enabled only when the VM Guest is shut down.
  3. Click Delete.
  4. To completely erase the guest, delete the associated .raw file by selecting the Delete Associated Storage Files check box.

Managing the NetScaler Guest VMs using the virsh Program

Updated: 2013-09-04

Listing the VM Guests and their current states
To use virsh to display information about the Guests
virsh list --all
The command output displays all domains with their states.
Example Output:
Id Name                 State 
---------------------------------- 
  0 Domain-0           running 
  1 Domain-1           paused 
  2 Domain-2           inactive 
  3 Domain-3           crashed 
Opening a virsh Console
Connect the Guest VM through the console
virsh console [<DomainID> | <DomainName> | <DomainUUID>]
Example:
virsh console NetScaler-VPX
Starting and Shutting Down a Guest
Guests can be started using the DomainName or Domain-UUID.
virsh start [<DomainName> | <DomainUUID>]
Example
virsh start NetScaler-VPX

To shut down a guest:
virsh shutdown [<DomainID> | <DomainName> | <DomainUUID>]
Example:
virsh shutdown NetScaler-VPX
Rebooting a Guest
virsh reboot [<DomainID> | <DomainName> | <DomainUUID>]
Example:
virsh reboot NetScaler-VPX
Deleting a Guest
To delete a Guest VM you need to shut-down the Guest and un-define the <DomainName>-NSVPX-KVM-*_nc.xml before you run the delete command.
virsh shutdown [<DomainID> | <DomainName> | <DomainUUID>] 
virsh undefine [<DomainName> | <DomainUUID>] 
 
Example:
virsh shutdown NetScaler-VPX  
virsh undefine NetScaler-VPX 
 
Note: The delete command doesn’t remove disk image file which needs to be removed manually.