Managing VMs
This chapter describes how to manage embedded VMs in the storage system.
- Viewing VM Information
- Modifying a VM
- Powering on a VM
- Restarting a VM
- Powering Off a VM
- Suspending a VM
- Restoring a VM
- Adding a Service Port for a VM
- Removing a Service Port from a VM
- Adding a Block Device for a VM
- Removing a Block Device from a VM
- Adding an ISO File
- Removing an ISO File
- Forcibly Restarting a VM
- Forcibly Powering Off a VM
- Enabling Failover
- Disabling Failover
- Setting the vCPU Isolation Switch
- Opening the VM Console
Viewing VM Information
If you want to view the basic information about an embedded VM, follow instructions in this section to view the VM information on a storage system.
Prerequisites
At least one VM has been installed in the storage system.
Procedure
- Choose
VM >
VM.
- Click an VM in the VM list. The related parameters are described in Table 7-2.
The VM information is displayed in the lower part of the window. The Summary, Block Device and Service Port tab pages display detailed VM information.
Table 7-2 VM ParametersParameter
Description
Name
The name of the VM.
ID
The ID of the VM.
Health Status
The health status of the VM.
Running Status
The running status of the VM.
Number of CPU Cores
The number of chips in the VM CPU that can process the data.
System Disk Capacity
The capacity of disk where the VM operation system is installed.
Owning VM Container
The node where the VM is installed.
Modifying a VM
If you want to modify information such as name and memory of an embedded VM, follow instructions in this section to modify the VM.
Prerequisites
Running Status of a VM is Powered off.
Procedure
- Choose
VM>
VM.
- Select the desired VM and click Modify.
The Modify VM dialog box is displayed.
- Modify information about the VM.Table 7-3 describes related parameters.Table 7-3 VM parameters
Parameter
Description
Value
Name
Name of the VM.
[Value range]
- The name must be unique.
- The name can contain only letters, digits, and underscores (_).
- The name contains 1 to 63 characters.
[Example]
VM1
Memory Size
Memory of the VM.
[Value range]
The value must be greater than or equal to 128 MB, less than or equal to the available capacity of the owning VM container displayed on the page, and less than or equal to 1 TB.
[Example]
1 GB
Number of vCPUs
Number of CPU cores of the VM.
NOTE:When VM vCPU isolation is enabled, the number of vCPUs can only be set to an even number. To query whether this function is enabled or disabled, log in to the CLI and run the show virtual_machine vcpu_isolate_switch command. To enable or disable this function, run the vcpu_isolate_switch status=off/on command.
[Value range]
1 to 32
[Example]
2
- Confirm the VM modification operation.
- Click OK.
The Execution Result message box is displayed, indicating that the operation is successful.
- Click Close.
- Click OK.
Powering on a VM
If you want to re-enable an embedded VM that has been powered off, follow instructions in this section to power on the VM.
Prerequisites
- VM VNC server certificate and VM VNC client certificate have been imported.
- The VM has been powered off.
Procedure
- Choose
VM >
VM.
- Select the VM and click Power On.
The Execution Result dialog box is displayed, indicating that the operation succeeded.
- Click Close.
Restarting a VM
When an embedded VM is faulty, you can restart the VM. Follow instructions in this section to restart a VM.
Prerequisites
The VM has been powered on.
Procedure
- Choose
VM >
VM.
- Select the VM and click Restart.
The security alert dialog box is displayed.
- Confirm the operation.
- Confirm the information in the dialog box and select I have read and understand the consequences associated with performing this operation..
- Click OK.
The Execution Result message box is displayed, indicating that the operation succeeded.
- Click Close.
Powering Off a VM
If you want to stop services running an embedded VM, you can power off the VM. Following instructions in this section to power off a VM.
Prerequisites
The VM has been powered on.
Procedure
- Choose
VM >
VM.
- Select the VM and click Power Off.
The security alert dialog box is displayed.
- Confirm the operation.
- Confirm the information in the dialog box and select I have read and understand the consequences associated with performing this operation..
- Click OK.
The Execution Result dialog box is displayed, indicating that the operation succeeded.
- Click Close.
Suspending a VM
If you want to suspend an embedded VM, follow instructions in this section to suspend the VM.
Prerequisites
- At least one VM has been installed in the storage system.
- The VM has been powered on.
Procedure
- Choose
VM >
VM.
- Select the VM and choose More > Pause.
The security alert dialog box is displayed.
- Read the information carefully, and select I have read and understand the consequences associated with performing this operation.
- Click OK.
The Execution Result dialog box is displayed, indicating the operation result.
- Click Close.
The Running Status of the VM is changed to Paused.
Restoring a VM
If you want to restore an embedded VM, follow instructions in this section to restore the VM.
Prerequisites
- At least one VM has been installed in the storage system.
- The VM has been suspended.
Procedure
- Choose
VM >
VM.
- Select the VM and choose More > Recover.
The Execution Result dialog box is displayed, indicating the operation result.
- Click Close.
The Running Status of the VM is changed to Running.
Adding a Service Port for a VM
This section describes how to add a service port for an embedded VM.
Prerequisites
Running Status of a VM is Powered off, Running, or Installing.
Procedure
- Choose
VM>
VM.
- Select the desired VM, click Configure Service, and select Add Service Port.
The Add Service Port dialog box is displayed.
- Select one or more available service ports for the VM.
VMs use service ports to transfer data between themselves and peripheral devices.
- Two types of ports can be added for a VM at the same time.
- The storage system allows you to add an Ethernet port or bond port for a VM as a service port, but does not allow you to add a maintenance port for a VM as a service port.
- A service port can be added only for a VM on the corresponding controller. For example, a port on controller A can be added only for a VM on controller A.
- Only an idle service port can be added for a VM and the service port cannot carry any service.
- In Port Type, select Ethernet port or Bond port.
- In the Available Ports area, select one or more ports based on service requirements.
- Click
to add the ports to the Selected Ports area.
- (Optional) Set the MAC addresses of the ports on the VM.
- If you do not set the MAC addresses, they will be automatically generated by the system.
- If you choose to manually set the MAC addresses, ensure that the MAC addresses meet the following requirements:
- A MAC address is a character string in the format of xx:xx:xx:xx:xx:xx.
- A MAC address cannot be the same as the MAC address of any other network device in the LAN.
- Confirm the service port adding operation.
- Click OK to add the service ports.
If you have manually configured the MAC address, a dialog box prompting a high risk is displayed.
- Carefully read the content and select I have read and understand the consequences associated with performing this operation. Click OK.
The Execution Result dialog box is displayed, indicating that the operation is successful.
- Click Close.
- Click OK to add the service ports.
Removing a Service Port from a VM
This section describes how to add a remove a service port from an embedded VM.
Prerequisites
Running Status of a VM is Powered off, Running, or Installing.
Procedure
- Choose
VM>
VM.
- Select the desired VM, click Configure Service, and select Remove Service Port.
The Remove Service Port dialog box is displayed.
- Select one or more existing service port of the VM.
- In the Available Ports area, select one or more ports based on service requirements.
- Click
to add the ports to the Selected Ports area.
- Confirm the service port removal operation.
- Click OK to remove the service ports.
A dialog box prompting a high risk is displayed.
- Carefully read the content and select I have read and understand the consequences associated with performing this operation. Click OK.
The Execution Result dialog box is displayed, indicating that the operation is successful.
- Click Close.
- Click OK to remove the service ports.
Adding a Block Device for a VM
This section describes how to add a block device for an embedded VM.
Prerequisites
- The LUN corresponding to a block device has been added to the LUN group (vm_lg_reserved_container0 or vm_lg_reserved_container1) corresponding to the owning container of the VM. Container 0A corresponds to vm_lg_reserved_container0, and container 0B corresponds to vm_lg_reserved_container1.
- Running Status of a VM is Powered off, Running, or Installing.
Procedure
- Choose
VM>
VM.
- Select the desired VM, click Configure Service, and select Add Block Device.
The Add Block Device dialog box is displayed.
- Select available block devices for the VM.Adding a block device for the VM establishes space where VM data can reside.
- If the added block devices are not displayed, click Rescan.
- A block device can be added to only one VM. Therefore, VM services do not support cluster services.
- In the Available Block Devices area, select one or more block devices based on service requirements.
- Click
to add the selected block devices to the Selected Block Devices area.
- Click Next.
- Confirm the block device adding operation.
- Click OK.
The Execution Result dialog box is displayed, indicating that the operation is successful.
- Click Close.
- Click OK.
Follow-up Procedure
After adding a block device for the VM, you can view the mounting information about the block device on the VM by running the lsblk command.
Removing a Block Device from a VM
This section describes how to remove a block device from an embedded VM.
Prerequisites
Running Status of a VM is Powered off, Running, or Installing.
Procedure
- Choose
VM>
VM.
- Select the desired VM, click Configure Service, and select Remove Block Device.
The Remove Block Device dialog box is displayed.
- Select one or more existing block devices of the VM.
- In the Available Block Devices area, select one or more block devices based on service requirements.
- Click
to add the selected block devices to the Selected Block Devices area.
- Confirm the block device removal operation.
- Click OK to remove the block devices.
A dialog box prompting a high risk is displayed.
- Carefully read the content and select I have read and understand the consequences associated with performing this operation. Click OK.
The Execution Result dialog box is displayed, indicating that the operation is successful.
- Click Close.
- Click OK to remove the block devices.
Adding an ISO File
This section describes how to add an ISO file for an embedded VM.
Prerequisites
No ISO file has been added for a VM.
Procedure
- Select
VM >
VM.
- Select the desired VM, click Configure Service, and select Add ISO File.
The Add ISO File dialog box is displayed.
- Select an ISO file.
- To ensure that the media can be installed successfully, select a media file whose name meets the following requirements:
- Contains 5 to 63 characters.
- Can contain only letters, digits, underscores (_), hyphens (-), and periods (.), and must end with extension iso or ISO.
- Click Upload. In the Upload ISO File dialog box that is displayed, upload a new ISO file to the current controller. The name of the uploaded file must meet the preceding requirements.
- Click Copy. In the Copy ISO File dialog box that is displayed, copy the ISO file from the source VM container to the target VM container.
- To ensure that the media can be installed successfully, select a media file whose name meets the following requirements:
- Click OK.
The Execution Result dialog box is displayed, indicating that the operation is successful.
- Click Close.
Removing an ISO File
This section describes how to remove an ISO file from an embedded VM.
Prerequisites
An ISO file has been added for a VM.
Procedure
- Choose
VM >
VM.
- Select the desired VM, click Configure Service, and select Remove ISO File.
A dialog box prompting a high risk is displayed.
- Carefully read the content and select I have read and understand the consequences associated with performing this operation. Click OK.
The Execution Result dialog box is displayed, indicating that the operation is successful.
- Click Close.
Forcibly Restarting a VM
If you want to forcibly restart an embedded VM, follow instructions in this section to restart the VM.
Prerequisites
- At least one VM has been installed in the storage system.
- The VM has been powered on.
Context
It is recommended that you log in to the VM to restart it.
Procedure
- Choose
VM >
VM.
- Select the VM and choose More > Force Restart.
The security alert dialog box is displayed.
- Select I have read and understand the consequences associated with performing this operation. and click OK.
The Execution Result dialog box is displayed indicating that the operation succeeded. The Running Status of the VM is changed to Running.
- Click Close.
Forcibly Powering Off a VM
If you want to forcibly power off an embedded VM, follow instructions in this section to power off the VM.
Prerequisites
- At least one VM has been installed in the storage system.
- The VM has been powered on.
Context
It is recommended that you log in to the VM to power of it.
Procedure
- Choose
VM >
VM.
- Select the VM and choose More > Force Power Off.
The security alert dialog box is displayed.
- Select I have read and understand the consequences associated with performing this operation. and click OK.
The Execution Result dialog box is displayed indicating that the operation succeeded. The Running Status of the VM is changed to Powered Off.
- Click Close.
Enabling Failover
The storage system supports the automatic failover function. If a controller fails, VMs can be automatically failed over to another functional controller to resume the services.
Prerequisites
Failover takes effect for a specific VM. When failover is enabled, the secondary controller must meet the following requirements:
- The remaining memory resources meet VM requirements after the failover.
- If vCPU isolation is enabled, the remaining number of CPUs in the container meets VM requirements after the failover.
- Add free network ports on the secondary controller to the VM to be failed over as secondary network ports.
Context
VM failover uses the cold backup mode. In this mode, services are not available when VMs are started on the secondary controller.
Procedure
- Choose
VM>
VM.
- Select the desired VM and choose Failover > Set Enable Failover.
A dialog box prompting a high risk is displayed.
- Click Add Secondary Port.
The Add Secondary Port dialog box is displayed.
- Select the secondary port of the VM.
The secondary port is the channel for data transmission between the VM and external devices after failover.
- Two types of secondary ports can be added to a VM at the same time.
- The storage system allows you to add an Ethernet port or bond port for a VM as a secondary port, but does not allow you to add a maintenance port for a VM as a secondary port.
- A secondary port can be added only for a VM on the corresponding controller. For example, a port on controller A can be added only for a VM on controller B.
- Only an idle secondary port can be added for a VM and the secondary port cannot carry any service.
- Each primary port of a VM must be configured with a secondary port.
- In Port Type, select Ethernet port or Bond port.
- In the primary and secondary port lists, select the desired ports and click Add to Port List.
- Click OK.
The Success dialog box is displayed, indicating that the operation has succeeded.
- Select I have read and understand the consequences associated with performing this operation and click OK.
The Success dialog box is displayed, indicating that the operation has succeeded.
- Click OK. Failover is changed to Enabled.
Disabling Failover
This section describes how to disable failover. After the failover function is disabled, VMs are unable to fail over to the secondary controller when the owning controller fails and VM services are interrupted.
Procedure
- Choose
VM>
VM.
- Select the desired VM and choose Failover > Disable Failover.
A dialog box prompting a high risk is displayed.
- Select I have read and understand the consequences associated with performing this operation and click OK.
- Click OK. Failover is changed to Closed.
Setting the vCPU Isolation Switch
If the vCPU isolation switch is enabled, the CPU quantity available to VMs is that of owning VM containers.
Procedure
- Choose
VM>
VM.
- choose More > Set vCPU Isolation Switch.
The Set vCPU Isolation Switch dialog box is displayed.
- Select Enable.
- Click OK
A dialog box prompting a high risk is displayed.
- Select I have read and understand the consequences associated with performing this operation and click OK.
The Success dialog box is displayed, indicating that the operation is successful.
- Click OK.
Opening the VM Console
If you want to use the VM console to operate VM, following instructions in this section to open the VM console.
Prerequisites
- VM VNC server certificate and VM VNC client certificate have been imported.
- At least one VM has been installed in the storage system.
- The VM has been powered on.
Procedure
- Choose
VM >
VM.
- Select the VM and click Open Console.
The Console page is displayed. Obtain the console control permission.
- You can also open the VM console by clicking Open Console on the Summary page of the VM.
- The browser must support Websocket. The recommended browser versions are Firefox 24 or later, Chrome 27 or later, and Internet Explorer 10 or later.
- In the console page, you can send out this command by clicking Send Ctrl + Alt + Del instead of using keyboard strokes.
- Viewing VM Information
- Modifying a VM
- Powering on a VM
- Restarting a VM
- Powering Off a VM
- Suspending a VM
- Restoring a VM
- Adding a Service Port for a VM
- Removing a Service Port from a VM
- Adding a Block Device for a VM
- Removing a Block Device from a VM
- Adding an ISO File
- Removing an ISO File
- Forcibly Restarting a VM
- Forcibly Powering Off a VM
- Enabling Failover
- Disabling Failover
- Setting the vCPU Isolation Switch
- Opening the VM Console