9.1. Managing Desktops

9.1.1. Obtaining the ID of a Desktop
9.1.2. Importing a Desktop
9.1.3. Renaming a Desktop
9.1.4. Starting a Desktop
9.1.5. Restarting a Desktop
9.1.6. Assigning a Desktop to a User
9.1.7. Duplicating a Desktop
9.1.8. Exporting a Desktop
9.1.9. Exporting User Profiles from Personal Hard Drives
9.1.10. Converting a Desktop to a Template
9.1.11. Activating an Unresponsive Desktop
9.1.12. Recloning Selected Desktops
9.1.13. Recloning All Unused Desktops
9.1.14. Suspending a Desktop
9.1.15. Shutting Down a Desktop
9.1.16. Powering Off a Desktop
9.1.17. Mounting an ISO Image in a Desktop
9.1.18. Unmounting an ISO Image from a Desktop
9.1.19. Updating the VirtualBox Guest Additions in a Desktop
9.1.20. Connecting to the Desktop Console
9.1.21. Disconnecting a User from a Remote Desktop Services Session
9.1.22. Logging a User Out of a Remote Desktop Services Session
9.1.23. Removing a User Assignment from a Desktop
9.1.24. Deleting a Desktop

Not all actions are available for all platforms. VMware has its own management tool, VMware vCenter, and Oracle VDI simply accesses the data. Microsoft Remote Desktop is not a virtualization platform like the others, therefore desktops cannot be imported and assigned personally.

This section lists the available actions for desktops, how you perform the action in Oracle VDI Manager, and the equivalent command-line command.

9.1.1. Obtaining the ID of a Desktop

Whenever you use the vda command to perform an action to a desktop, you must use the unique ID of the desktop rather than the name. Oracle VDI Manager only displays the name.

To obtain the ID of a desktop, use either the vda user-desktops command to list the desktops for a user, the vda token-desktops command to list the desktops for a token, or the vda pool-desktops command to list the desktops in a pool.

In the following example, the desktops in the pool MyPool are listed:

/opt/SUNWvda/sbin/vda pool-desktops MyPool
NAME                      ID MACHINE_STATE       STATUS         USER          DN
desktop-01                33       Running         Idle      aberginuid=bergin,ou=People
desktop-02                34       Running    Available            -           -

There are two desktops in the pool with IDs of 33 and 34.

9.1.2. Importing a Desktop

Perform the following steps to import a previously created virtual machine into Oracle VDI Manager. Oracle VM VirtualBox and Microsoft Hyper-V hosted machines can be imported from a shared folder. For VMware vCenter, the virtual machines remain under the control of VMware vCenter, but the user assignment and runtime management is done by Oracle VDI.

You can perform this action on Oracle VM VirtualBox, Microsoft Hyper-V, VMware vCenter, and Generic desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab.

  3. Click the Import button to open the Import Desktop window.

  4. If the desktop to import is located on a VirtualBox host available to Oracle VDI Manager, go to the Hypervisor tab and select the desktop in the list.

    Otherwise, specify the location of the desktop configuration file and disk image by completing the fields in the Folder tab.

  5. Click OK.

Command Line Steps

  • Import a VirtualBox desktop using the vda pool-vb-import command.

    /opt/SUNWvda/sbin/vda pool-vb-import -p \
    vdi-image=MyVirtualDesktop.vdi,xml-configuration=MyVirtualDesktop.xml,\
    hostname=MyNfsServer.domain,path=/home/user/desktops,\
    type=desktop MyPool
    
  • Import an unmanaged VirtualBox desktop using the vda pool-vb-import-unmanaged command.

    /opt/SUNWvda/sbin/vda pool-vb-import-unmanaged -p \
    -d uuid-desktop1,uuid-desktop2 MyPool
    
  • Import a Hyper-V desktop using the vda pool-hv-import command.

    /opt/SUNWvda/sbin/vda pool-hv-import -p \
    export-directory=/home/user/desktops,hostname=MyNfsServer.domain,\
    type=desktop MyPool
    
  • Import a VMware desktop using the vda pool-vc-import command.

    /opt/SUNWvda/sbin/vda pool-vc-import -p \
    -d uuid-desktop1,uuid-desktop2 MyPool
    

9.1.3. Renaming a Desktop

Perform the following steps to give an existing desktop a new name.

You can perform this action on Oracle VM VirtualBox, VMware vCenter, Microsoft Hyper-V, and Generic desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktop you want to work with.

  3. Click the Rename button.

    A dialog box is displayed.

  4. Enter a new name for the desktop and click OK.

Command Line Steps

  1. Obtain the ID of the desktop you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Rename an existing desktop using the vda desktop-setprops command.

    /opt/SUNWvda/sbin/vda desktop-setprops -p name=new-name desktop-id
    

    For example:

    /opt/SUNWvda/sbin/vda desktop-setprops -p name='"jdoe desktop"' 28

9.1.4. Starting a Desktop

Perform the following steps to start a desktop. The desktop is started on the virtualization host on which it is registered. If the desktop is not yet registered on a virtualization host, a host is selected based on free memory and started.

You can perform this action on Oracle VM VirtualBox, VMware vCenter, and Microsoft Hyper-V desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktops you want to work with.

  3. Click the Start button.

Command Line Steps

  1. Obtain the ID of the desktops you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Start the desktops using the vda desktop-start command.

    /opt/SUNWvda/sbin/vda desktop-start desktop1-id desktop2-id ...
    

    For example:

    /opt/SUNWvda/sbin/vda desktop-start 38 40

9.1.5. Restarting a Desktop

Perform the following steps to restart the desktop on the same virtualization host. This is equivalent to pressing the reset button on a PC.

Caution

Restarting a desktop can cause data loss if files are open.

You can perform this action on Oracle VM VirtualBox, VMware vCenter, and Microsoft Hyper-V desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktops you want to work with.

  3. Click the Restart button.

    A confirmation dialog box is displayed.

  4. Click OK.

Command Line Steps

  1. Obtain the ID of the desktops you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Restart the desktops using the vda desktop-restart command.

    /opt/SUNWvda/sbin/vda desktop-restart desktop1-id desktop2-id ...
    

    For example:

    /opt/SUNWvda/sbin/vda desktop-restart 38 40

9.1.6. Assigning a Desktop to a User

Perform the following steps to create a persistent relationship between a user and a desktop. The desktop is reserved for the user as their personal desktop.

You can perform this action on Oracle VM VirtualBox, VMware vCenter, Microsoft Hyper-V desktops, and Generic desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktop you want to work with.

  3. Click the Assign button.

    The Assign Personal Desktop window is displayed.

  4. Search for either Users or Tokens.

  5. Make your selection in the search results and click OK.

Command Line Steps

  1. Obtain the ID of the desktops you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Search for the ID of the user to whom you want to assign the desktop:

    /opt/SUNWvda/sbin/vda user-search walk
    NAME                             KIND   DN
    awalker                          User   uid=awalker
    bwalker                          User   uid=bwalker
    ewalker                          User   uid=ewalker
    jwalker                          User   uid=jwalker
  3. Assign the desktops personally to a user using the vda user-assign command.

    /opt/SUNWvda/sbin/vda user-assign -d desktop1-id desktop2-id user-id
    

    For example:

    /opt/SUNWvda/sbin/vda user-assign -d 44 jwalker
  4. Check the user assignment.

    /opt/SUNWvda/sbin/vda pool-desktops MyPool
    NAME            ID MACHINE_STATE       STATUS         USER          DN
    desktop1        42   Powered Off    Available            -           -
    desktop2        44   Powered Off         Idle      jwalker uid=jwalker
    desktop3        46   Powered Off    Available            -           -
    

9.1.7. Duplicating a Desktop

Perform the following steps to create an identical clone of an existing desktop. The clone can then be assigned to any user.

You can perform this action on Oracle VM VirtualBox and Microsoft Hyper-V desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktops you want to work with.

  3. In the More Actions list, select Duplicate.

Command Line Steps

  1. Obtain the ID of the desktops you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Duplicate the desktops using the vda desktop-duplicate command.

    /opt/SUNWvda/sbin/vda desktop-duplicate desktop-id-1 desktop-id-2 ...
    

    For example:

    /opt/SUNWvda/sbin/vda desktop-duplicate 22 24

9.1.8. Exporting a Desktop

Perform the following steps to save the virtual machine configuration file and disk image to a new location. You can then store and use this virtual machine independent of Oracle VDI.

The export consists of an .xml file containing the virtual machine properties, and a .vdi disk image file.

You can perform this action on Oracle VM VirtualBox and Microsoft Hyper-V desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktop you want to work with.

  3. In the More Actions list, select Export Desktop.

    The Export Desktop window is displayed.

  4. Specify the export location for the desktop by entering a target Server and Path, and a Name for the exported desktop.

  5. Click OK.

Command Line Steps

  1. Obtain the ID of the desktop you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Export the desktop using the vda desktop-export command.

    /opt/SUNWvda/sbin/vda desktop-export -p \
    hostname=MyNfsServer.domain,path=/path-to-export-location desktop-id
    

    For example:

    /opt/SUNWvda/sbin/vda desktop-export -p \
    hostname=nfs.example.com,path=/home/user/exports 24

9.1.9. Exporting User Profiles from Personal Hard Drives

Perform the following steps to export the user profile data stored on desktop personal hard drives to the network profile location configured for the pool. See Section 5.5.9, “About Personal Hard Drives and Windows User Profiles” and Section 5.5.9.1, “Enabling Personal Hard Drives” for details.

You can perform this action on Oracle VM VirtualBox desktops. The action is supported on Windows 7 and later desktops.

Before you export user profiles, ensure that users have logged out of the desktops as this action shuts down the selected desktops if they are running.

When you export user profiles, Oracle VDI creates a job. The job powers on the desktops, copies the profiles from the personal hard drives to the network profile location configured for the pool and then shuts down the desktops.

The number of user profiles that can be exported concurrently is controlled by the peak time limits specified for the desktop provider.

You cannot export the user profiles from unresponsive desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and, optionally, select the desktops you want to work with.

    You only need to select desktops if you want to export the profiles from particular desktops.

  3. In the More Actions list, select Export User Profile.

    The Export User Profile windows is displayed.

  4. Check that you are exporting the user profiles you require and click OK.

Command Line Steps

  1. (Optional) Obtain the ID of the desktops you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

    You only need to do this if you want to export the profiles from particular desktops.

  2. Export the user profiles with the vda pool-profiles-export command.

    /opt/SUNWvda/sbin/vda pool-profiles-export [-d desktop1-id,desktop2-id ...] pool
    

    For example, to export the user profiles from all desktops in the pool:

    /opt/SUNWvda/sbin/vda pool-profiles-export MyPool

    For example, to export the user profiles from particular desktops:

    /opt/SUNWvda/sbin/vda pool-profiles-export -d 46,80 MyPool

9.1.10. Converting a Desktop to a Template

Perform the following steps to turn an existing desktop into a template for the current pool. The desktop disappears from the list of available desktops. It is moved to the Template tab of the pool, where a first revision of the template is also created.

Cloned desktops cannot be converted to a template. Use a personal desktop.

You can perform this action on Oracle VM VirtualBox and Microsoft Hyper-V desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktop you want to work with.

  3. In the More Actions list, select Convert to Template.

    A confirmation dialog box is displayed.

  4. Click OK.

Command Line Steps

  1. Obtain the ID of the desktop you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Convert an existing desktop to a template using the vda desktop-template command.

    /opt/SUNWvda/sbin/vda desktop-template desktop-id
    

    For example:

    /opt/SUNWvda/sbin/vda desktop-template 40

9.1.11. Activating an Unresponsive Desktop

In some error situations, Oracle VDI marks a desktop as unresponsive, making it unusable. Perform the following steps to revert an unusable desktop to its previous operational state.

You can perform this action on Oracle VM VirtualBox, VMware vCenter, and Microsoft Hyper-V desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktop you want to work with.

  3. In the More Actions list, select Activate Desktop.

Command Line Steps

  1. Obtain the ID of the desktop you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Activate the desktop using the vda desktop-activate command.

    /opt/SUNWvda/sbin/vda desktop-activate desktop-id
    

    For example:

    /opt/SUNWvda/sbin/vda desktop-activate 40

9.1.12. Recloning Selected Desktops

Perform the following steps to delete selected desktops and replace them with a new clone from the master revision. Personal hard drives and user assignments are preserved and applied to the new clone. To reclone all desktop not in use, seeSection 9.1.13, “Recloning All Unused Desktops”.

You can perform this action on Oracle VM VirtualBox desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktops you want to work with.

  3. In the More Actions list, select Reclone Desktop.

    A confirmation dialog box is displayed.

  4. Click OK.

Command Line Steps

  1. Obtain the ID of the desktops you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Reclone the desktops using the vda desktop-reclone command.

    /opt/SUNWvda/sbin/vda desktop-reclone desktop-id-1 desktop-id-2 ...
    

    For example:

    /opt/SUNWvda/sbin/vda desktop-reclone 38 47

9.1.13. Recloning All Unused Desktops

Perform the following steps to delete and reclone all unused desktops. This affects all cloned desktops in the pool that are not currently in use or personally assigned, regardless of the pool recycle policy. To reclone particular desktops, seeSection 9.1.12, “Recloning Selected Desktops”.

You can use this action to make sure that all desktops are cloned from the same template and revision, and use the latest settings from the Cloning tab, such as naming conventions or Windows system preparation.

You can perform this action on Oracle VM VirtualBox, VMware vCenter, and Microsoft Hyper-V desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab.

  3. In the More Actions list, select Reset Cloning.

    A confirmation dialog box is displayed.

  4. Click OK.

Command Line Steps

  • Reset cloning for a pool using the vda pool-reset command.

    For example:

    /opt/SUNWvda/sbin/vda pool-reset MyPool

9.1.14. Suspending a Desktop

Perform the following steps to save the desktop's state to disk. When the desktop is resumed, it will be in the same state before it was suspended.

You can perform this action on Oracle VM VirtualBox, VMware vCenter, and Microsoft Hyper-V desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktops you want to work with.

  3. In the More Actions list, select Suspend.

Command Line Steps

  1. Obtain the ID of the desktops you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Suspend the desktops using the vda desktop-suspend command.

    /opt/SUNWvda/sbin/vda desktop-suspend desktop-id-1 desktop-id-2 ...
    

    For example:

    /opt/SUNWvda/sbin/vda desktop-suspend 40 56

9.1.15. Shutting Down a Desktop

Perform the following steps to send an ACPI shutdown signal to the desktop. This causes a proper shutdown of the virtual machine and saves its state.

You can perform this action on Oracle VM VirtualBox, VMware vCenter, and Microsoft Hyper-V desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktops you want to work with.

  3. In the More Actions list, select Shut Down.

    A confirmation dialog box is displayed.

  4. Click OK.

Command Line Steps

  1. Obtain the ID of the desktops you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Shut down the desktops using the vda desktop-stop command.

    /opt/SUNWvda/sbin/vda desktop-stop desktop1-id desktop2-id ...
    

    For example:

    /opt/SUNWvda/sbin/vda desktop-stop 38 40

9.1.16. Powering Off a Desktop

Perform the following steps to immediately power off the desktop without saving its state. Oracle VM VirtualBox and Microsoft Hyper-V desktops are also unregistered from the virtualization host. VMware vCenter desktops are only powered off.

You can perform this action on Oracle VM VirtualBox, VMware vCenter, and Microsoft Hyper-V desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktops you want to work with.

  3. In the More Actions list, select Power Off.

    A confirmation dialog box is displayed.

  4. Click OK.

Command Line Steps

  1. Obtain the ID of the desktops you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Power off the desktops using the vda desktop-stop command.

    /opt/SUNWvda/sbin/vda desktop-stop -p desktop1-id desktop2-id ...
    

    For example:

    /opt/SUNWvda/sbin/vda desktop-stop -p 38 40

9.1.17. Mounting an ISO Image in a Desktop

Perform the following steps to mount an ISO image in a desktop's virtual DVD drive. The ISO image must be stored on a Network File System (NFS) share that is accessible from the Oracle VDI Manager host.

You can perform this action on Oracle VM VirtualBox and Microsoft Hyper-V desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktop you want to work with.

  3. In the More Actions list, select Mount ISO Image.

    The Mount ISO Image window is displayed.

  4. Specify the ISO image location by entering the Server and Path.

  5. Click Select Folder to load the available ISO images into the list.

  6. Select an ISO image from the list.

  7. Click OK.

Command Line Steps

  1. Obtain the ID of the desktop you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Mount an ISO image using the vda desktop-mount-iso command.

    /opt/SUNWvda/sbin/vda desktop-mount-iso -p \
    hostname=MyNfsServer.domain,path=/path-to-iso-file desktop-id
    

    For example:

    /opt/SUNWvda/sbin/vda desktop-mount-iso -p \
    hostname=nfs.example.com,path=/home/user/iso/myDVD.iso 38

9.1.18. Unmounting an ISO Image from a Desktop

Perform the following steps to unmount an ISO image from a desktop's virtual DVD drive.

You can perform this action on Oracle VM VirtualBox and Microsoft Hyper-V desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktop you want to work with.

  3. In the More Actions list, select Unmount ISO Image.

Command Line Steps

  1. Obtain the ID of the desktop you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Unmount an ISO image using the vda desktop-unmount-iso command.

    /opt/SUNWvda/sbin/vda desktop-unmount-iso desktop-id
    

    For example:

    /opt/SUNWvda/sbin/vda desktop-unmount-iso 38

9.1.19. Updating the VirtualBox Guest Additions in a Desktop

Perform the following steps to update a desktop to the version of the Guest Additions included in the current Oracle VM VirtualBox installation on the desktop provider host. The desktop must be powered off. A job is started that starts the virtual machine, installs the Guest Additions, and then shuts down the virtual machine again.

You can only update the Guest Additions in Oracle VDI Manager.

You can perform this action on Oracle VM VirtualBox desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktop you want to work with.

  3. In the More Actions list, select Update Guest Additions.

    A message is displayed to confirm that the update job has started.

9.1.20. Connecting to the Desktop Console

Perform the following steps to connect to the console that provides direct access to the desktop.

You can only connect to the desktop console in Oracle VDI Manager.

You can perform this action on Oracle VM VirtualBox desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktop you want to work with.

  3. Click the name of the desktop to open its desktop page.

    The Desktop Summary tab is displayed.

  4. Click Console.

  5. Click Connect to display the desktop inside the tab, or click the Open in Window button to display the desktop in a separate browser window.

9.1.21. Disconnecting a User from a Remote Desktop Services Session

Perform the following steps to disconnect users from their Remote Desktop Services (RDS) sessions. The sessions remain on the RDS Session Host and users can reconnect to the sessions later.

You can perform this action on Microsoft Remote Desktop Services desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select an RDS pool.

  2. Click the Desktop tab and select the desktops you want to work with.

  3. Click the Disconnect button.

    A confirmation dialog box is displayed.

  4. Click OK.

Command Line Steps

  1. Obtain the ID of the desktops you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Disconnect the users from their RDS sessions using the vda desktop-disconnect command.

    /opt/SUNWvda/sbin/vda desktop-disconnect -p \
    hostname=host,pool=pool desktop1-id desktop2-id ...
    

    For example:

    /opt/SUNWvda/sbin/vda desktop-disconnect -p hostname=RDS-1,pool=MyRDSPool 58 62 70

9.1.22. Logging a User Out of a Remote Desktop Services Session

Perform the following steps to log users out of their Remote Desktop Services (RDS) sessions and terminate the sessions on the RDS Session Host.

You can perform this action on Microsoft Remote Desktop Services desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select an RDS pool.

  2. Click the Desktop tab and select the desktops you want to work with.

  3. Click the Log Out User button.

    A confirmation dialog box is displayed.

  4. Click OK.

Command Line Steps

  1. Obtain the ID of the desktops you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Log out users from RDS sessions using the vda desktop-logoff command.

    /opt/SUNWvda/sbin/vda desktop-logoff -p hostname=host,pool=pool desktop1-id desktop2-id ...
    

    For example:

    /opt/SUNWvda/sbin/vda desktop-logoff -p hostname=RDS-1,pool=MyRDSPool 58 62 70

9.1.23. Removing a User Assignment from a Desktop

Perform the following steps to break the persistent relationship between a user and a desktop. The desktop is no longer assigned as the user's personal desktop.

You can perform this action on Oracle VM VirtualBox, VMware vCenter, Microsoft Hyper-V desktops, and Generic desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktop you want to work with.

  3. In the More Actions list, select Remove User.

    A confirmation dialog box is displayed.

  4. Click OK.

Command Line Steps

  1. Obtain the ID of the desktop you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Look up the ID of the desktop user:

    /opt/SUNWvda/sbin/vda user-search walk
    NAME                             KIND   DN
    awalker                          User   uid=awalker
    bwalker                          User   uid=bwalker
    ewalker                          User   uid=ewalker
    jwalker                          User   uid=jwalker
  3. Look up the ID of the user's desktop:

    /opt/SUNWvda/sbin/vda user-desktops user-id
    

    For example:

    /opt/SUNWvda/sbin/vda user-desktops jwalker
    DESKTOP             DESKTOP_ID     POOL            Assignment   DEFAULT
    desktop2            44             MyPool            personal     false
    desktop5            36             MyPool            personal     false
  4. Remove the user assignment from the desktop using the vda user-unassign command.

    /opt/SUNWvda/sbin/vda user-unassign [-d desktop-id] user-id
    

    For example, to remove the user jwalker from a particular desktop:

    /opt/SUNWvda/sbin/vda user-unassign -d 44 jwalker

    For example, to remove the user jwalker from all desktops:

    /opt/SUNWvda/sbin/vda user-unassign jwalker

9.1.24. Deleting a Desktop

Perform the following steps to delete one or more desktops from Oracle VDI. If necessary, the desktops are stopped. For Oracle VM VirtualBox and Microsoft Hyper-V desktops, the iSCSI disk is deleted from the storage. For VMware vCenter desktops, you have the option to keep the virtual machine available on VMware vCenter. All references to the desktop are deleted from the Oracle VDI database.

You can perform this action on Oracle VM VirtualBox, VMware vCenter, Microsoft Hyper-V desktops, and Generic desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, select Pools and then select a pool.

  2. Click the Desktop tab and select the desktops you want to work with.

  3. In the More Actions list, select Delete Desktop.

    A confirmation dialog box is displayed.

  4. Click Delete.

Command Line Steps

  1. Obtain the ID of the desktops you want to work with, see Section 9.1.1, “Obtaining the ID of a Desktop”.

  2. Delete the desktops using the vda desktop-delete command.

    /opt/SUNWvda/sbin/vda desktop-delete desktop-id-1 desktop-id-2 ...
    

    For example:

    /opt/SUNWvda/sbin/vda desktop-delete 28 32