Manuals / Citrix Systems / Computer Equipment / Server

Citrix Systems 6 manual VIF Commands, Vdi-snapshot, Vdi-unlock, VIF Parameters

Models: 6

1 207

Download 207 pages 43.5 Kb

Page 182

vdi-snapshot

vdi-snapshotuuid=<uuid_of_the_vdi> [driver-params=<params>]

Produces a read-write version of a VDI that can be used as a reference for backup and/or template creation purposes. You can perform a backup from a snapshot rather than installing and running backup software inside the VM. The VM can continue running while external backup software streams the contents of the snapshot to the backup media. Similarly, a snapshot can be used as a "gold image" on which to base a template. A template can be made using any VDIs.

The optional driver-paramsmap parameter can be used for passing extra vendor-specific configuration information to the back end storage driver that the VDI is based on. See the storage vendor driver documentation for details.

A clone of a snapshot should always produce a writable VDI.

vdi-unlock

vdi-unlockuuid=<uuid_of_vdi_to_unlock> [force=true]

Attempts to unlock the specified VDIs. If force=true is passed to the command, it will force the unlocking operation.

VIF Commands

Commands for working with VIFs (Virtual network interfaces).

The VIF objects can be listed with the standard object listing command (xe vif-list), and the parameters manipulated with the standard parameter commands. See the section called “Low-level Parameter Commands” for details.

VIF Parameters

VIFs have the following parameters:

Parameter Name	Description			Type

uuid	the	unique	identifier/object	read only
	reference for the VIF

vm-uuid	the	unique	identifier/object	read only
	reference for the VM that this
	VIF resides on

vm-name-label	the name of the VM that this VIF			read only
	resides on

allowed-operations	a list of the operations allowed			read only set parameter
	in this state

current-operations	a list of the operations that are			read only set parameter
	currently in progress on this VIF

device	integer label of this VIF,			read only
	indicating the order in which VIF
	backends were created

MAC	MAC address of VIF, as exposed			read only
	to the VM

164

Image 182

Citrix Systems 6 manual VIF Commands, Vdi-snapshot, VIF Parameters, Vdi-unlockuuid=uuidofvditounlock force=true

Contents

Citrix XenServer 6.0 Administrators Guide Trademarks Contents Storage ISO Configuring VM Memory Xen Memory Usage Disaster Recovery and Backup Monitoring and Managing XenServer 106 110 Page Host-bugreport-upload 129 Xiii Xiv Page Vm-compute-maximum-memory Workload Balancing Service Commands 186 Xviii Using XenServer increases flexibility by Benefits of Using XenServerUsing XenServer reduces costs by Introducing XenServerXenServer Editions New Features in XenServerAdministering XenServer Simplified Installer Rolling Pool Upgrade WizardDistributed Virtual Switch Improvements Microsoft Scvmm and Scom SupportNFS Support for High Availability VM Protection and RecoveryXenServer Documentation XenCenter ImprovementsXenServer CLI Term Authenticating Users With Active Directory ADXenCenter Term Configuring Active Directory Authentication Upgrading XenServerActive Directory integration Port Protocol UseDisabling external authentication User AuthenticationEnabling external authentication on a pool Removing access for a user using the CLI Removing Access for a UserAllowing a user access to XenServer using the CLI Listing subjects with accessTerminating individual user sessions using xe Role Based Access ControlTerminating all authenticated sessions using xe Leaving an AD DomainRoles Rbac processPermissions available for each role Definitions of Rbac Roles and PermissionsUsers role can be changed in two ways WLB Definitions of permissions Permission Allows Assignee To Rationale/CommentsPermission Allows Assignee To Rationale/Comments Report Generated or its recipient Using Rbac with the CLI To List All the Available Defined Roles in XenServerTo Display a List of Current Subjects To Assign an Rbac Role to a Created subject Run the command xe subject-add subject-name=AD user/groupTo Add a Subject to Rbac To Change a Subjects Rbac RoleHow Does XenServer Compute the Roles for the Session? Audit Log xe CLI CommandsAuditing To Obtain All Audit Records From the PoolPage Hosts and Resource Pools Overview Requirements for Creating Resource PoolsNaming a resource pool Creating a Resource PoolCreating Heterogeneous Resource Pools Adding NFS shared storage to a resource pool using the CLI Adding Shared StorageRemoving a XenServer Host from a Resource Pool Preparing a Pool of XenServer Hosts for MaintenanceTo remove a host from a resource pool using the CLI Overcommitting High AvailabilityHA Overview Host Fencing Configuration RequirementsOvercommitment Warning HA Always Run Explanation Restart PrioritiesHA Restart Priority Restart Explanation Enabling HA on a XenServer Pool Enabling HA Using the CLIRemoving HA Protection from a VM using the CLI Shutting Down a host When HA is Enabled Host Power OnRecovering an Unreachable Host Shutting Down a VM When it is Protected by HATo Turn on Hosts Remotely Using the CLI Using the CLI to Manage Host Power OnTo Enable Host Power On Using the CLI Key/Value Pairs Sample ScriptResult is only displayed when the script is unsuccessful Virtual Disk Images VDIs Storage OverviewStorage Repositories SRs Physical Block Devices PBDsVirtual Disk Data Formats Virtual Block Devices VBDsSummary of Storage objects VHD-based VDIsLUN-based VDIs VHD Chain CoalescingStorage type Maximum VDI size Storage Repository TypesLocal LVM Creating a Local LVM SR lvm Local EXT3 VHDUdev Creating a Local EXT3 SR extCitrix StorageLink SRs XenServer Host iSCSI configurationSoftware iSCSI Support Upgrading XenServer with StorageLink SRs Creating a Shared StorageLink SRTo Create a CSL SR Using XenCenter Parameter name Description Optional?To Create a CSL SR Using the CLI Page Sample QLogic iSCSI HBA setup Managing Hardware Host Bus Adapters HBAsParameter Name Description LVM over iSCSIRemoving HBA-based SAS, FC or iSCSI Device Entries Parameter Name Description Hitachi NFS VHD Creating Storage Repositories Storage ConfigurationLVM over Hardware HBA Creating a Shared NFS SR NFSVDI Types Upgrading LVM Storage from XenServer 5.0 or EarlierLVM Performance Considerations Probing an SR Creating a Raw Virtual Disk Using the xe CLIConverting Between VDI Formats Following parameters can be probed for each SR type Page To enable storage multipathing using the xe CLI Storage MultipathingDestroying or Forgetting a SR Managing Storage RepositoriesMPP Rdac Driver Support for LSI Arrays Introducing an SRResizing an SR Converting Local Fibre Channel SRs to Shared SRsCopying All of a VMs VDIs to a Different SR Adjusting the Disk IO SchedulerMoving Virtual Disk Images VDIs Between SRs Copying Individual VDIs to a Different SRAutomatically Reclaiming Space When Deleting Snapshots Reclaiming Space Using the Off Line Coalesce ToolVirtual Disk QoS Settings Possible values of qosalgorithmparamsched arePage What is Dynamic Memory Control DMC? Concept of Dynamic RangeHow Does DMC Work? Concept of Static RangeDMC Behaviour Operating System Supported Memory Limits Memory ConstraintsSupported Operating Systems Xe CLI Commands Display the Static Memory Properties of a VMDisplay the Dynamic Memory Properties of a VM Updating Memory PropertiesWorkload Balancing Interaction Upgrade IssuesUpdate Individual Memory Properties Setting Control Domain Memory Name Default DescriptionName Default Description VSwitch Networks Networking SupportXenServer Networking Overview Network ObjectsNIC Bonds NetworksVLANs Page Switch Configuration Active-Active Bonding Active-Passive Bonding Cross-Server Private networks Managing Networking ConfigurationInitial Networking Configuration Creating Networks in a Standalone Server Creating Networks in Resource Pools To add a new network using the CLITo connect a network to an external Vlan using the CLI Creating VLANsControlling the MAC Address of the Bond Creating a NIC bondBonding two NICs Adding NIC bonds to new resource pools Creating NIC bonds in resource poolsReverting NIC bonds Adding NIC bonds to an existing pool Configuring a dedicated storage NICTo assign NIC functions using the xe CLI Assigning a SR-IOV NIC VF to a VM Using SR-IOV Enabled NICsControlling the rate of outgoing data QoS Changing networking configuration options Networking Stack Configuration Methods AvailableHostname Changing IP address configuration for a standalone hostChanging IP address configuration in resource pools DNS serversPrimary management interface Networking TroubleshootingDisabling management access Adding a new physical NICRecovering from a bad network configuration Diagnosing network corruptionDisaster Recovery and Backup Understanding XenServer DRDR Infrastructure Requirements Deployment Considerations Enabling Disaster Recovery in XenCenterSteps to Take After a Recovery Steps to Take Before a DisasterRecovering VMs and vApps in the Event of Disaster Failover Recovery Wizard Test FailoverVApps Creating vApps Using the Manage vApps dialog box in XenCenterBacking Up and Restoring XenServer Hosts and VMs Value DescriptionTo backup a VM To backup pool metadataTo backup host configuration and software To backup VM metadata onlyBacking up XenServer hosts Backing up single host installationsBacking up pooled installations To back up a XenServer host To restore a running XenServer hostBacking up VMs Restarting a crashed XenServer hostQuiesced Snapshots VM SnapshotsRegular Snapshots Snapshots with memoryTo list the snapshots on a particular VM Creating a snapshot with memoryTo list all of the snapshots on a XenServer pool Restoring a VM to its previous state Deleting a snapshotExporting a snapshot to a template Snapshot TemplatesCreating a template from a snapshot Advanced Notes for Quiesced Snapshots Naming convention for VM archive folders VM Protection and RecoveryCoping with machine failures Master failures Opt/xensource/sm/resetvdis.py hostUUID Sruuid masterMember failures Physical Machine failure Coping with Failure due to Configuration ErrorsPool failures To restore a pool with all hosts failed To restore a VM when VM storage is not availableAlerts Alert DescriptionCustomizing Alerts Valid VM ElementsConfiguring Email Alerts Valid Host ElementsDetermining throughput of physical bus adapters Custom Fields and TagsCustom Searches To determine PBD throughputTo write logs to a remote server XenServer host logsSending host log messages to a central server XenCenter logs Userprofile%\AppData\Citrix\XenCenter\logs\XenCenter.logXe command-name argument=value argument=value Basic xe SyntaxClass-list Command TypesSpecial Characters and Syntax Parameter Types Class-param-list uuid=uuid Low-level Parameter CommandsLow-level List Commands Appliance-assert-can-be-recovered Xe Command ReferenceAppliance Commands Appliance ParametersAudit Commands Bonding Commands CD CommandsCd-list Cd-listparams=param1,param2,... parameter=parametervalueConsole Parameters Console CommandsDisaster Recovery DR Commands Drtask-createSr-enable-database-replication Vm-assert-can-be-recoveredVm-recover Sr-disable-database-replicationClass name Description Event CommandsEvent Classes GPU Commands Event-waitGPU Group Parameters Vgpu-destroy Host CommandsVgpu-create Host SelectorsHost Parameters Syslogdestination Yyyymmdd-hhmmss-ABC, where ABC is Host-bugreport-upload Host-backupHost-disable Host-crashdump-destroyHost-evacuate Host-emergency-management-reconfigureHost-enable Host-forgetHost-get-system-status-capabilities Attribute DescriptionHost-apply-edition Host-management-disableHost-is-in-emergency-mode Host-license-addHost-get-cpu-features Host-management-reconfigureHost-power-on Host-set-cpu-featuresHost-set-hostname-live Host-restoreHost-syslog-reconfigure Host-shutdownHost-data-source-forget Host-data-source-listHost-data-source-record Host-data-source-queryLog-set-output Log CommandsMessage Commands Message ParametersMessage-list Network CommandsMessage-destroy Network ParametersNetwork-destroy Patch Update CommandsNetwork-create Patch ParametersPBD Commands Pbd-destroy PIF CommandsPbd-create Pbd-plugPIF Parameters MACFull or half Pif-introduce Pif-reconfigure-ipPif-forget Pif-plugPif-unplug Pool CommandsPif-scan Pool ParametersPool-designate-new-master Pool-dump-databasePool-ha-disable Pool-emergency-reset-masterPool-ha-enable Pool-recover-slavesSM Parameters Storage Manager CommandsSR Commands SR ParametersSr-create UserSr-introduce Sr-destroySr-forget Sr-probeTask Commands Task ParametersTask-cancel uuid=taskuuid Template CommandsTask-cancel Template ParametersFor memory-dynamic-max Uuid=templateuuid \ Order or an OrderNot YyyymmddThhmmssAs not in database for Update Commands Template-exportUpdate-upload User CommandsVBD Commands User-password-changeVbd-create Vbd-createvm-uuid=uuidofthevmdevice=devicevalueVDI Commands VDI Parameters VDIVdi-create Vdi-cloneVdi-copy Local/domain/0/backendVdi-import Vdi-destroyVdi-forget Vdi-introduceVdi-unlock VIF CommandsVdi-snapshot VIF ParametersDisable 165 Vif-destroy Vlan CommandsVif-create Vif-plugVM Commands Parameter Name Description Type Uuid=vmuuid \ Order Value pair autopoweron true Vcpu-hotplug command Domain/domid/vm Vm-cd-insert Vm-cd-addVm-cd-eject Vm-cd-listVm-copy Vm-cloneVm-compute-maximum-memory Vm-crashdump-listVm-data-source-forget Vm-data-source-listVm-data-source-record Vm-data-source-queryVm-disk-list Vm-destroyVm-disk-add Vm-disk-removeVm-install Vm-importVm-memory-shadow-multiplier-set Vm-rebootVm-reset-powerstate Vm-migrateVm-start Vm-resumeVm-shutdown Vm-suspendWorkload Balancing XE Commands Host-retrieve-wlb-evacuate-recommendations Pool-retrieve-wlb-diagnosticsPool-certificate-install Vm-retrieve-wlb-recommendationsPool-retrieve-wlb-recommendations Pool-deconfigure-wlbPool-retrieve-wlb-configuration Pool-retrieve-wlb-reportPool-send-wlb-configuration 185 Service Commands To run the wlbconfig command Modifying the Workload Balancing configuration optionsEditing the Workload Balancing configuration file To edit the wlb.conf fileIncreasing the Detail in the Workload Balancing Log Logging Trace Flag Benefit or Purpose OptionLogging Trace Flag Benefit or Purpose Option