Oracle® Virtual Desktop Infrastructure

Administrator's Guide for Release 3.3.2

Oracle Legal Notices
Component Licensing


July 2012

Table of Contents

1. Release Notes
1.1. Bugs Fixed in Oracle VDI Release 3.3.2
1.2. Changes in Oracle VDI Release 3.3.1
1.3. New Features in Oracle VDI Release 3.3
1.4. VDA Subcommands, Arguments, and Properties Deprecated in Oracle VDI Release 3.3
1.4.1. Password Properties
1.4.2. Pool Settings
1.4.3. User Directory Settings
1.4.4. Remote Access Subcommands
1.4.5. Forced Deletion of a User Directory
1.5. About the Oracle VDI Package Software
1.5.1. Oracle VDI Requirements and Platform Support
1.5.2. Additional Supporting Software
1.6. Known Issues
1.6.1. Templates Cannot be Imported for Hyper-V Desktop Providers on Oracle Linux Platforms (Bug ID 12307034)
1.6.2. On Oracle Linux Platforms the GDM Greeter is Visible Until the Kiosk Session is Initialized (Bug ID 12577080)
1.6.3. Hotdesking Re-Direct Does Not Work With Windows XP Professional and Windows RDP (Bug ID 13102493)
1.6.4. Group Membership Fails If Has Multiple Values (Bug ID 13485924)
2. System Overview of Oracle Virtual Desktop Infrastructure
2.1. Introduction to Oracle Virtual Desktop Infrastructure
2.1.1. About Virtualization
2.1.2. About Storage
2.1.3. About Management
2.1.4. About Desktop Access
3. Installing Oracle VDI and Configuring Oracle VDI Centers
3.1. About Oracle VDI Centers and Hosts
3.1.1. Single Oracle VDI Host Configuration
3.1.2. High Availability Configuration Using Embedded MySQL Server
3.1.3. High Availability Configuration Using Remote MySQL Database
3.2. Oracle VDI System Requirements
3.2.1. Oracle VDI Hardware Requirements
3.2.2. Supported Installation Platforms for Oracle VDI
3.2.3. Requirements for Oracle Linux Platforms
3.2.4. Requirements for Oracle Solaris Platforms
3.2.5. Time Synchronization
3.2.6. Preparing to Use a Remote MySQL Database
3.2.7. Oracle VDI Centers in Virtualized Environments
3.3. How to Install Oracle VDI
3.4. How to Configure Oracle VDI on a Primary Host
3.5. How to Configure Oracle VDI on a Secondary Host
3.6. Updating Oracle VDI to Release 3.3.2
3.6.1. Before You Update
3.6.2. How to Update an Oracle VDI Center (Single Host)
3.6.3. How to Update an Oracle VDI Center (High Availability With Bundled MySQL Database)
3.6.4. How to Update an Oracle VDI Center (High Availability With Remote MySQL Database)
3.7. How to Reconfigure Oracle VDI on a Host
3.8. Reinstalling Oracle VDI
3.9. How to Uninstall Oracle VDI
3.10. Firewall Ports and Protocols
3.10.1. Firewalls Between Clients and Oracle VDI
3.10.2. Firewalls Between Oracle VDI and User Directories
3.10.3. Firewalls Between Oracle VDI and Desktop Providers
3.10.4. Firewalls Between the Hosts in an Oracle VDI Center
4. Configuring Companies and User Directories
4.1. About User Directory Integration
4.1.1. Active Directory Types
4.1.2. LDAP Types
4.1.3. User Directory Customization
4.2. Supported User Directories
4.3. About Companies
4.3.1. Changes to Desktop Selector
4.3.2. Corporation Setting
4.4. How to Create a Company
4.5. How to Set Up Kerberos Authentication
4.5.1. Whitelist and Blacklist Support
4.6. How to Set Up Public Key Authentication
4.7. How to Set Up Anonymous Authentication
4.8. How to Set Up Simple Authentication
4.9. How to Set Up Secure Authentication
4.10. About Complex Forest Configurations
4.11. How to Reconfigure the User Directory Settings
4.11.1. Defining the User Directory
4.11.2. Changing the Security Level
4.11.3. Changing the Credentials
4.11.4. Updating the Server SSL Certificates
4.11.5. Adding Fallback Hosts
4.12. About Global Oracle VDI Centers
4.12.1. Oracle VDI Center - Home and Foreign
4.12.2. Guest Pools
4.12.3. Oracle VDI Login and Desktop Selector Dialog
4.13. How to Prepare a User Directory for Global Oracle VDI Centers
4.13.1. Oracle VDI Center Data Schema
4.14. About LDAP Filters and Attributes
4.14.1. Searching for Users and Groups
4.14.2. Requesting a Desktop for a User
4.14.3. Resolving Group Membership
4.14.4. LDAP Cache
4.15. Removing a Company
5. Configuring Desktop Providers and Virtualization Platforms
5.1. Oracle VDI Hypervisor
5.1.1. About the Oracle VDI Hypervisor
5.1.2. System Requirements for the Oracle VDI Hypervisor
5.1.3. Updating the Oracle VDI Hypervisor
5.1.4. How to Install the Oracle VDI Hypervisor
5.1.5. How to Configure the VRDP Port Range
5.2. Microsoft Hyper-V and Remote Desktop Services
5.2.1. Microsoft Hyper-V
5.2.2. Microsoft Remote Desktop Services
5.2.3. Preparing a Windows Server
5.3. VMware vCenter
5.3.1. System Requirements for VMware vCenter
5.3.2. How to Set Up a VMware ESX Server
5.3.3. How to Set Up a VMware vCenter Server
5.3.4. How to Test the Platform Setup
5.4. About Generic Desktop Providers
5.5. About Sun Ray Kiosk Session Providers
5.6. Storage
5.6.1. Supported Storage Server Platforms
5.6.2. About Storage Clustering
5.6.3. How to Set Up an Oracle Solaris Storage Server
5.6.4. How to Set Up a Sun Storage 7000 Unified Storage System
5.6.5. How to Replicate and Replace a Sun Unified Storage System
5.6.6. How to Replicate and Replace an Oracle Solaris Storage System
5.7. Desktop Providers
5.7.1. How to Create Desktop Providers
6. Preparing Desktops
6.1. About Pools
6.1.1. How to Create Desktop Pools
6.1.2. How to Configure Networks Per Pool
6.1.3. How to Configure RDP Options Per Pool
6.1.4. How to Enable USB Redirection
6.1.5. How to Configure Smart Card Removal
6.1.6. How to Configure Kiosk Settings (Sun Ray Kiosk Provider)
6.1.7. Choosing Between VRDP and MS-RDP
6.2. About Desktops
6.2.1. Supported Desktop Operating Systems
6.2.2. Available Actions for Desktops
6.3. About Templates and Revisions
6.3.1. Available Actions for Templates
6.3.2. Available Actions for Revisions
6.4. About Desktop and Virtual Machine States
6.4.1. Virtual Machine States
6.4.2. Desktop States
6.5. Creating Desktop Images
6.5.1. How to Create Virtual Machines (Oracle VDI Hypervisor)
6.5.2. How to Create Virtual Machines (VMware vCenter)
6.5.3. How to Create Virtual Machines (Microsoft Hyper-V)
6.6. Importing Desktops
6.6.1. How to Import Desktops (Oracle VDI Hypervisor)
6.6.2. How to Import Desktops (VMware vCenter)
6.6.3. How to Import Desktops (Microsoft Hyper-V)
6.6.4. How to Import Individual Windows PCs
6.6.5. About Template Management
6.7. Cloning Desktops
6.7.1. How to Clone Desktops (Oracle VDI Hypervisor)
6.7.2. How to Clone Desktops (VMware vCenter)
6.7.3. How to Enable VMware Linked Cloning
6.7.4. How to Clone Desktops (Microsoft Hyper-V)
6.7.5. About Clone Customization
6.7.6. How to Debug Fast Preparation Problems
6.7.7. How to Enable Oracle VDI Fast Preparation for Windows Templates (Oracle VDI Hypervisor and Microsoft Hyper-V)
6.7.8. How to Enable System Preparation for Windows Templates (Oracle VDI Hypervisor and Microsoft Hyper-V)
6.7.9. About Personal Hard Drives
6.7.10. Clone and Recycle Job Management
6.8. Assigning Users to Desktops
6.8.1. How to Assign Users to Pools or Desktops
6.8.2. How to Create Custom Groups and Custom Group Filters
6.8.3. How to Assign Tokens to Users
6.8.4. How to Assign Tokens to Desktops or Pools
6.8.5. How to Create Bulks of Tokens
6.8.6. How to Search for Desktops
7. Accessing Desktops
7.1. About Desktop Access Methods
7.2. Sun Ray Software
7.2.1. About the Oracle VDI Sun Ray Kiosk Session
7.2.2. How to Adapt the Bundled Sun Ray Kiosk Session
7.2.3. How to Access Desktops Using a Sun Ray Client
7.2.4. Multi-Monitor Support
7.2.5. How to Access the Sun Ray Administration GUI
7.2.6. How to Change User Password
7.2.7. How to Disable Client Authentication
7.2.8. How to Enable Desktop Screen Locking on Sun Ray Clients
7.3. Secure Web Access with Oracle Secure Global Desktop
7.3.1. How to Set Up Oracle Secure Global Desktop Using the Oracle Secure Global Desktop VDI Broker
7.3.2. How to Set Up Oracle Secure Global Desktop and Access a Desktop Using Application Objects
7.4. Remote Desktop Client (RDC)
7.4.1. About the Bundled RDP Broker
7.4.2. How to Access Desktops with Microsoft RDC
7.5. Logging Out of Desktop Sessions
8. Performance and Tuning
8.1. Introduction to Oracle VDI Performance and Tuning
8.2. Oracle VDI Hosts
8.2.1. Sizing Guidelines for Oracle VDI Servers
8.2.2. Controlling the Number of Sessions on an Oracle VDI Host
8.3. Virtualization Hosts
8.3.1. Sizing Guidelines for Oracle VM VirtualBox Servers
8.4. Storage
8.4.1. Sizing Guidelines for Storage Servers
8.4.2. About ZFS Storage Caches
8.4.3. About Block Alignment
8.4.4. Oracle VDI Global Settings for Storage
8.4.5. Managing the ZIL on Oracle Solaris Platforms
8.5. Networking
8.5.1. How to Configure a Dedicated iSCSI Network
8.5.2. How to Configure Link Aggregation
8.5.3. How to Configure a VLAN
8.6. Virtual Machines
8.6.1. How to Configure Desktop Resources Per Pool (Oracle VDI Provider)
8.6.2. Optimizing Windows 7 Desktop Images
8.6.3. Optimizing Windows Vista Desktop Images
8.6.4. Optimizing Windows XP Desktop Images
8.6.5. Optimizing Desktop Images for Other Operating Systems
9. Monitoring and Maintaining Oracle VDI
9.1. How to Log in to Oracle VDI Manager
9.2. Oracle VDI Administrators
9.2.1. About Oracle VDI Role-Based Administration
9.2.2. How to Create Administrators and Assign Roles
9.3. Checking Oracle VDI Services and Logs
9.3.1. How to Check the Status of the Oracle VDI Center
9.3.2. How to Check the Oracle VDI Log Files
9.3.3. How to Change Logging for Oracle VDI
9.3.4. How to Check the Status of the Oracle VDI Database
9.3.5. How to Check the Status of the Oracle VDI Service
9.3.6. How to Check the Status of the Oracle VDI RDP Broker
9.3.7. How to Check the Status of the Oracle VDI Center Agent
9.3.8. How to Check the Status of the Oracle VDI Manager
9.3.9. How to Check the Status of Cacao and the Oracle VDI Modules
9.3.10. How to Restart Cacao
9.4. Backing Up and Restoring the Oracle VDI Database
9.5. About Desktop Provider Alarms
9.6. Maintenance Mode
9.6.1. Oracle VDI Hypervisor and Microsoft Hyper-V Host Maintenance
9.6.2. Storage Maintenance
9.7. Deleting Orphan Disks
9.8. Oracle VDI Centers and Failover
9.8.1. How to Change the Replication Database Host
9.8.2. How to Change the Primary Host in an Oracle VDI Center
9.8.3. How to Trigger Failover Manually
9.8.4. How to Remove an Unresponsive Host from an Oracle VDI Center
9.8.5. How to Tune Automatic Failover
9.9. Providing Feedback and Reporting Problems
9.9.1. Contacting Oracle Specialist Support
9.9.2. Support Bundles
10. Troubleshooting and FAQs
10.1. Installation and Configuration
10.1.1. Installation on Oracle Linux Platforms Fails Due Missing Packages
10.1.2. Configuration on Oracle Linux Platforms Fails Because the RDP Broker Cannot Be Enabled
10.1.3. Oracle VDI Configuration Is Failing to Import svc_vdadb.xml
10.1.4. Can I Try Out MySQL or Set up an Evaluation Oracle VDI Remote Database?
10.1.5. Do I Need to Configure Sun Ray Software Separately?
10.1.6. Reconfiguring Oracle VDI Fails With "Error While Configuring Database"
10.1.7. Oracle VDI Configuration Fails to Create Database Tables With Remote Windows Databases That Use UTF-8
10.2. User Directory
10.2.1. I Am Having Some Trouble With the User Directory. Can I Adjust the Log Level to Get More Information?
10.2.2. Kerberos Authentication to Active Directory Works for a While and Then Stops
10.2.3. Can I Use PKI Instead of Kerberos for Authentication to an Active Directory?
10.2.4. What Type of Privileged Access to the User Directory Is Required?
10.3. Oracle VDI Desktop Provider
10.3.1. Why Are My Windows 7 Audio Drivers Not Automatically Installed?
10.3.2. Oracle VM VirtualBox Install Is Failing With "Postinstall Script Did Not Complete Successfully" Errors
10.3.3. There Is an Error When I Add an Oracle VM VirtualBox Host to a Desktop Provider
10.3.4. The Oracle VM VirtualBox Web Service Cannot Be Contacted
10.3.5. Are all Oracle VM VirtualBox Releases Compatible With Oracle VDI?
10.3.6. How do I Change the Password on my Oracle VM VirtualBox Host?
10.3.7. I Can See My Oracle VM VirtualBox Hosted Desktop, But It Will Not Start
10.3.8. The Time in My Oracle VDI Hypervisor Desktop Is Too Slow
10.3.9. Can I Run More Than 100 Virtual Machines on a Single Oracle VM VirtualBox Server?
10.3.10. What Are the Requirements for High Availability for Oracle VM VirtualBox?
10.3.11. How Do I Change the Password of the Oracle VM VirtualBox Service?
10.3.12. Users Experience Blurry Text in Internet Explorer
10.4. VMware vCenter Desktop Provider
10.4.1. Is VMware ESXi a Supported Virtualization Platform?
10.4.2. I Cannot Log into My VMware Virtual Machine
10.4.3. Users Cannot Log Into Their VMware Provided Windows desktop
10.4.4. Why Does My VMware Virtual Machine Have an Invalid IP Address Or Cannot Be Pinged?
10.4.5. I Am Unable to Get a MS RDC Connection on My VMware Virtual Machine
10.4.6. Creating a vCenter Desktop Provider Fails With "Unable to Contact VMware VirtualCenter - Host Not Reachable at Port 443" Errors
10.4.7. In My VMware Desktop Pool, New Virtual Machines Are Created Automatically, But They Are Not Made Available
10.4.8. The VMware Virtual Machine Cloning Process Is Not Operating As Expected
10.4.9. The Window Displaying the VMware-Hosted Virtual Desktop Is Freezing
10.4.10. I Have Created a New Pool in My VMware Desktop provider and Virtual Machines Are Not Created Automatically
10.4.11. How Do I Use VMware Virtual Machines With Multiple Network Adapters?
10.4.12. Unused VMware Virtual Machines Are Not Being Recycled
10.5. Microsoft Hyper-V and RDS Desktop Providers
10.5.1. Sessions Are Started by Oracle VDI on RDS Hosts That Do Not Participate in the Microsoft Remote Desktop Provider. Why Is That Happening?
10.5.2. Hyper-V Desktop Cloning Fails With "Cannot Reload MSiSCSI Target List" Errors
10.5.3. Can I Enter the Farm Information for the Microsoft Remote Desktop Provider and let Oracle VDI Detect the Individual RDS Hosts Participating in the Farm?
10.5.4. Oracle VDI Is Not Able to Communicate With the Windows Server
10.5.5. Connection Problems between Oracle VDI and Hyper-V
10.6. Desktops and Pools
10.6.1. How Do I Make a Desktop Available to a User at All Times?
10.6.2. Starting a Desktop Fails With "No suitable Hosts to Start a Desktop for Desktop Provider <Name>" Errors
10.6.3. What Is the Difference Between Personal and Flexible Desktop Assignments?
10.6.4. Oracle VDI Fast Preparation Is failing
10.6.5. Can I Use Wild Cards in Token Names to Represent a Group of Thin Clients in Order to Assign These Thin Clients to a Pool?
10.6.6. The Audio in My Ubuntu Desktop Is Playing Too Slowly. What Should I Do?
10.6.7. Audio Does Not Play After Changing the Audio Configuration for Oracle VM VirtualBox Hosted Desktops in Oracle VDI Manager
10.6.8. How Do I Specify USB Redirection for Sun Ray?
10.6.9. USB Devices Are Not Detected
10.6.10. What Are the Differences Between MS-RDP and VRDP?
10.6.11. Cloning Fails if the Sysprep Timezone Setting Does not Match the Host Timezone
10.7. Logging In and Accessing Desktops
10.7.1. Users Cannot Access Their Desktops
10.7.2. A User Can Log in But Their Desktop is Not Responding
10.7.3. Error - "Currently There Is No Desktop Available Or Assigned to You"
10.7.4. Is It Possible to Customize the Desktop Login Screen?
10.7.5. The Sun Ray Client Is Cycling and Cannot Connect to a Virtual Machine
10.7.6. Users Cannot Log in to Ubuntu 8.04 Desktops Because the Network Is Not Enabled
10.7.7. How Do I Control Which Sun Ray Server Users Are Redirected to When Disconnected From Their Kiosk Session?
10.8. Administration Tools
10.8.1. I Cannot Log in to Oracle VDI Manager
10.8.2. I Get a Blank Screen After Successfully Logging into the Oracle VDI Manager
10.8.3. Error - "You Have Been Logged out Because a Consistent Response Could Not Be Guaranteed"
10.8.4. How Can I Change the Password of an Oracle VDI Host?
10.8.5. How Do I Change the Password of a Remote MySQL Database?
10.8.6. Does the MySQL Database Store All Sun Ray Software Configuration?
10.8.7. The vda Command Reports That Oracle VDI Is Not Running Although cacaoadm and vda-db-status Say It Is
10.8.8. Users Do Not Show Up in Users and Groups in Oracle VDI Manager
10.8.9. Is There a Way to Modify the Cacao Logging Behavior So That a Long History Can Be Maintained?
10.8.10. Jobs Do Not Finish Even After Canceling Them Using Oracle VDI Manager
10.8.11. Can I Adjust the Logging Level for the Oracle VDI Logs?
10.8.12. How Do I Log in to the Embedded MySQL Database?
10.9. Oracle VDI
10.9.1. Oracle VDI Hangs Intermittently When Running on x2270 Hardware
10.9.2. The System Is Not Reacting as Expected
10.9.3. How Do I Configure DHCP in Oracle VDI?
A. Automated Administration Scripts
A.1. Reading the Return Code
A.2. Waiting for a Job to Finish
A.3. Parsing the Output of the CLI
A.3.1. Subcommands That Result in a Single Job
A.3.2. Subcommands That Result in a Multiple Jobs
A.3.3. user-search
A.3.4. user-show
A.3.5. user-desktops
A.3.6. group-list
A.3.7. group-show
A.3.8. token-search
A.3.9. token-show
A.3.10. token-desktops
A.3.11. pool-list
A.3.12. pool-show
A.3.13. pool-users
A.3.14. pool-desktops
A.3.15. pool-templates
A.3.16. desktop-search
A.3.17. template-revisions
A.3.18. provider-list
A.3.19. provider-list-hosts
A.3.20. provider-list-storage
A.3.21. provider-list-templates
A.3.22. provider-list-unmanaged
A.3.23. provider-list-networks
A.3.24. provider-show
A.3.25. provider-storage-orphans
A.3.26. directory-list
A.3.27. admin-list
A.3.28. admin-show
A.3.29. role-list
A.3.30. job-list
A.3.31. job-show
B. Defaults for the Software Bundled With Oracle VDI
B.1. Sun Ray Windows Connector
B.2. Sun Ray Software
B.3. Oracle VDI
C. User Directory LDAP Filters and Attributes
C.1. How to Edit LDAP Filters and Attributes
C.2. LDAP Filters and Attributes for Users, Groups, and Containers
C.2.1. Default LDAP Filters and Attributes for Users, Groups and Containers
C.2.2. Active Directory Settings for Users, Groups, and Containers
C.2.3. Oracle Directory Server Enterprise Edition Settings for Users, Groups, and Containers
C.2.4. OpenDS Settings for Users, Groups, and Containers
C.2.5. OpenLDAP Settings for Users, Groups, and Containers
C.2.6. Novell eDirectory Settings for Users, Groups, and Containers
C.3. LDAP Filters and Attributes for Global Oracle VDI Centers
C.3.1. Default LDAP Filters and Attributes for Global Oracle VDI Centers
C.3.2. Active Directory Settings for Global Oracle VDI Centers
C.3.3. Oracle Directory Server Enterprise Edition Settings for Global Oracle VDI Centers
D. Remote Database Configuration
D.1. How to Install and Configure a Remote MySQL Database (InnoDB)
D.2. How to Create a Privileged Database Administrator
E. Glossary
F. Licenses for Third-Party Components
F.1. Apache Software Foundation Licenses
F.2. Bouncy Castle License
F.3. EclipseLink License
F.4. Java Secure Channel (JSCH) for SSH2 License
F.5. WSDL4J License
F.6. Xerces License