Oracle® Virtual Desktop Infrastructure

Administrator's Guide for Release 3.4.1

Oracle Legal Notices
Component Licensing


September 2012

Table of Contents

1. System Overview of Oracle Virtual Desktop Infrastructure
1.1. Introduction to Oracle Virtual Desktop Infrastructure
1.2. About Virtualization
1.3. About Storage
1.4. About Management
1.5. About Desktop Access
2. Installing Oracle VDI and Configuring Oracle VDI Centers
2.1. About Oracle VDI Centers and Hosts
2.1.1. Single Oracle VDI Host Configuration
2.1.2. High Availability Configuration Using the Embedded MySQL Server Database
2.1.3. High Availability Configuration Using a Remote MySQL Database
2.2. Oracle VDI System Requirements
2.2.1. Oracle VDI Hardware Requirements
2.2.2. Supported Installation Platforms for Oracle VDI
2.2.3. Requirements for Oracle Linux Platforms
2.2.4. Requirements for Oracle Solaris Platforms
2.2.5. Time Synchronization
2.2.6. Requirements for Using a Remote MySQL Database
2.2.7. Oracle VDI Centers in Virtualized Environments
2.3. Installing and Configuring Oracle VDI
2.3.1. Installing Oracle VDI
2.3.2. Configuring Oracle VDI on a Primary Host
2.3.3. Configuring Oracle VDI on a Secondary Host
2.3.4. Reconfiguring Oracle VDI on a Host
2.3.5. Reinstalling Oracle VDI
2.3.6. Uninstalling Oracle VDI
2.4. Updating Oracle VDI to Release 3.4.1
2.4.1. Oracle VDI Update Requirements
2.4.2. Updating an Oracle VDI Center (Single Host)
2.4.3. Updating an Oracle VDI Center (High Availability)
2.5. Firewall Ports and Protocols
2.5.1. Firewalls Between Clients and Oracle VDI
2.5.2. Firewalls Between Oracle VDI and User Directories
2.5.3. Firewalls Between Oracle VDI and Desktop Providers
2.5.4. Firewalls Between the Hosts in an Oracle VDI Center
3. Configuring Companies and User Directories
3.1. About User Directory Integration
3.1.1. Active Directory Types
3.1.2. LDAP Types
3.1.3. User Directory Customization
3.2. Supported User Directories
3.3. About Companies
3.3.1. Changes to Desktop Selector
3.3.2. Corporation Setting
3.4. How to Create a Company
3.5. How to Set Up Kerberos Authentication
3.5.1. Whitelist and Blacklist Support
3.6. How to Set Up Public Key Authentication
3.7. How to Set Up Anonymous Authentication
3.8. How to Set Up Simple Authentication
3.9. How to Set Up Secure Authentication
3.10. About Complex Forest Configurations
3.11. How to Reconfigure the User Directory Settings
3.11.1. Defining the User Directory
3.11.2. Changing the Security Level
3.11.3. Changing the Credentials
3.11.4. Updating the Server SSL Certificates
3.11.5. Adding Fallback Hosts
3.12. About Global Oracle VDI Centers
3.12.1. Home and Foreign Oracle VDI Centers
3.12.2. Guest Pools
3.12.3. Oracle VDI Login and Desktop Selector Dialog
3.13. How to Prepare a User Directory for Global Oracle VDI Centers
3.13.1. Oracle VDI Center Data Schema
3.14. About LDAP Filters and Attributes
3.14.1. Searching for Users and Groups
3.14.2. Requesting a Desktop for a User
3.14.3. Resolving Group Membership
3.14.4. LDAP Cache
3.15. Removing a Company
4. Configuring Desktop Providers and Virtualization Platforms
4.1. Oracle VM VirtualBox
4.1.1. About Oracle VM VirtualBox
4.1.2. System Requirements for Oracle VM VirtualBox
4.1.3. Installing Oracle VM VirtualBox
4.1.4. Updating Oracle VM VirtualBox
4.1.5. Configuring the VRDP Port Range
4.2. Microsoft Hyper-V and Remote Desktop Services
4.2.1. Microsoft Hyper-V
4.2.2. System Requirements for Microsoft Hyper-V
4.2.3. Microsoft Remote Desktop Services
4.2.4. System Requirements for Microsoft Remote Desktop Services
4.2.5. Microsoft RDS Farm (NLB Cluster) Management
4.2.6. Limitations of Microsoft Remote Desktop Providers and Pools
4.2.7. Preparing a Windows Server
4.3. VMware vCenter
4.3.1. System Requirements for VMware vCenter
4.3.2. Setting Up a VMware ESX Server
4.3.3. Setting Up a VMware vCenter Server
4.3.4. Testing the Platform Setup
4.4. Sun Ray Kiosk Desktop Providers
4.5. Generic Desktop Providers
4.6. Storage
4.6.1. Introduction to Storage
4.6.2. Local Storage
4.6.3. Network File System Storage
4.6.4. iSCSI Storage
4.6.5. Sun ZFS Storage
4.6.6. Preparing iSCSI and Sun ZFS Storage
4.7. Creating Desktop Providers
4.7.1. Creating an Oracle VM VirtualBox Desktop Provider
4.7.2. Creating a Microsoft Hyper-V Desktop Provider
4.7.3. Creating a Microsoft Remote Desktop Provider
4.7.4. Creating a VMware vCenter Desktop Provider
4.7.5. Creating a Sun Ray Kiosk Desktop Provider
4.7.6. Creating a Generic Desktop Provider
5. Preparing Desktops
5.1. About Pools
5.1.1. How to Create Desktop Pools
5.1.2. How to Configure Networks Per Pool
5.1.3. How to Configure RDP Options Per Pool
5.1.4. How to Enable USB Redirection
5.1.5. How to Configure Smart Card Removal
5.1.6. How to Configure Kiosk Settings (Sun Ray Kiosk Provider)
5.1.7. Choosing Between VRDP and MS-RDP
5.2. About Desktops
5.2.1. Supported Desktop Operating Systems
5.2.2. Available Actions for Desktops
5.3. About Templates and Revisions
5.3.1. Available Actions for Templates
5.3.2. Available Actions for Revisions
5.4. About Desktop and Virtual Machine States
5.4.1. Virtual Machine States
5.4.2. Desktop States
5.5. Creating Desktop Images
5.5.1. How to Create Virtual Machines (Oracle VM VirtualBox)
5.5.2. How to Create Virtual Machines (VMware vCenter)
5.5.3. How to Create Virtual Machines (Microsoft Hyper-V)
5.6. Importing Desktops
5.6.1. How to Import Desktops (Oracle VM VirtualBox)
5.6.2. How to Import Desktops (VMware vCenter)
5.6.3. How to Import Desktops (Microsoft Hyper-V)
5.6.4. How to Import Individual Windows PCs
5.6.5. About Template Management
5.7. Cloning Desktops
5.7.1. How to Clone Desktops (Oracle VM VirtualBox)
5.7.2. How to Clone Desktops (VMware vCenter)
5.7.3. How to Enable VMware Linked Cloning
5.7.4. How to Clone Desktops (Microsoft Hyper-V)
5.7.5. About Clone Customization
5.7.6. How to Debug Fast Preparation Problems
5.7.7. How to Enable Oracle VDI Fast Preparation for Windows Templates (Oracle VM VirtualBox and Microsoft Hyper-V)
5.7.8. How to Enable System Preparation for Windows Templates (Oracle VM VirtualBox and Microsoft Hyper-V)
5.7.9. About Personal Hard Drives
5.7.10. Clone and Recycle Job Management
5.8. Assigning Users to Desktops
5.8.1. How to Assign Users to Pools or Desktops
5.8.2. How to Create Custom Groups and Custom Group Filters
5.8.3. How to Assign Tokens to Users
5.8.4. How to Assign Tokens to Desktops or Pools
5.8.5. How to Create Bulks of Tokens
5.8.6. How to Search for Desktops
5.8.7. Obtaining the ID of a Desktop or Template
6. Desktop Access
6.1. About Desktop Access
6.2. Desktop Access Using Sun Ray Clients
6.2.1. About the Oracle VDI Sun Ray Kiosk Session
6.2.2. How to Modify the Bundled Sun Ray Kiosk Session
6.2.3. How to Access the Sun Ray Administration GUI
6.2.4. How to Change a User Password
6.2.5. How to Disable Client Authentication
6.2.6. How to Enable Desktop Screen Locking on Sun Ray Clients
6.2.7. Sun Ray Client User Access Scenarios
6.2.8. Multiple Monitor Capability
6.3. Desktop Access Using RDP Clients
6.3.1. Accessing Desktops With an RDP Client
6.3.2. About the Oracle VDI RDP Broker
6.4. Desktop Access Using Oracle Secure Global Desktop
6.5. Logging Out of Desktop Sessions
7. Performance and Tuning
7.1. Introduction to Oracle VDI Performance and Tuning
7.2. Oracle VDI Hosts
7.2.1. Sizing Guidelines for Oracle VDI Servers
7.2.2. Controlling the Number of Sessions on an Oracle VDI Host
7.3. Virtualization Hosts
7.3.1. Sizing Guidelines for Oracle VM VirtualBox Servers
7.4. Storage Performance and Tuning
7.4.1. Sizing Guidelines for Sun ZFS Storage Servers
7.4.2. About ZFS Storage Caches
7.4.3. Managing the ZIL on Oracle Solaris Platforms
7.4.4. Oracle VDI Global Settings for Storage
7.4.5. About Block Alignment
7.5. Networking
7.5.1. How to Configure a Dedicated iSCSI Network
7.5.2. How to Configure Link Aggregation
7.5.3. How to Configure a VLAN
7.6. Virtual Machines
7.6.1. How to Configure Desktop Resources Per Pool (Oracle VDI Provider)
7.6.2. Optimizing Windows 7 Desktop Images
7.6.3. Optimizing Windows Vista Desktop Images
7.6.4. Optimizing Windows XP Desktop Images
7.6.5. Optimizing Desktop Images for Other Operating Systems
8. Monitoring and Maintaining Oracle VDI
8.1. How to Log in to Oracle VDI Manager
8.2. Oracle VDI Administrators
8.2.1. About Oracle VDI Role-Based Administration
8.2.2. How to Create Administrators and Assign Roles
8.3. Checking Oracle VDI Services and Logs
8.3.1. How to Check the Status of the Oracle VDI Center
8.3.2. How to Check the Oracle VDI Log Files
8.3.3. How to Change Logging for Oracle VDI
8.3.4. How to Check the Status of the Oracle VDI Database
8.3.5. How to Check the Status of the Oracle VDI Service
8.3.6. How to Check the Status of the Oracle VDI RDP Broker
8.3.7. How to Check the Status of the Oracle VDI Center Agent
8.3.8. How to Check the Status of the Oracle VDI Manager
8.3.9. How to Check the Status of Cacao and the Oracle VDI Modules
8.3.10. How to Restart Cacao
8.4. Backing Up and Restoring the Oracle VDI Database
8.5. About Desktop Provider Alarms
8.6. Maintenance Mode
8.6.1. Oracle VM VirtualBox and Microsoft Hyper-V Host Maintenance
8.6.2. Storage Maintenance
8.7. Deleting Orphan Disks
8.8. Oracle VDI Centers and Failover
8.8.1. Changing the Replication Database Host
8.8.2. Changing the Primary Host in an Oracle VDI Center
8.8.3. Triggering Failover Manually
8.8.4. Removing an Unresponsive Host from an Oracle VDI Center
8.8.5. Tuning Automatic Failover
8.8.6. Configuring the Sun Ray Primary Server in an Oracle VDI Center
8.8.7. Synchronizing the Sun Ray Group Signature and Data Store Password
9. Troubleshooting and FAQs
9.1. Installation and Configuration
9.1.1. Installation on Oracle Linux Platforms Fails Due Missing Packages
9.1.2. Configuration on Oracle Linux Platforms Fails Because the RDP Broker Cannot Be Enabled
9.1.3. Oracle VDI Configuration Is Failing to Import svc_vdadb.xml
9.1.4. Can I Try Out MySQL or Set up an Evaluation Oracle VDI Remote Database?
9.1.5. Do I Need to Configure Sun Ray Software Separately?
9.1.6. Adding a Host to a Oracle VDI Center Fails With a Sun Ray Server Software Replication Error
9.1.7. Reconfiguring Oracle VDI Fails With "Error While Configuring Database"
9.1.8. Oracle VDI Configuration Fails to Create Database Tables With Remote Windows Databases That Use UTF-8
9.2. User Directory
9.2.1. I Am Having Some Trouble With the User Directory. Can I Adjust the Log Level to Get More Information?
9.2.2. Kerberos Authentication to Active Directory Works for a While and Then Stops
9.2.3. Can I Use PKI Instead of Kerberos for Authentication to an Active Directory?
9.2.4. What Type of Privileged Access to the User Directory Is Required?
9.2.5. Can I Disable the Automatic Cleanup of Computer Objects in Active Directory?
9.3. Oracle VM VirtualBox Desktop Provider
9.3.1. Why Are My Windows 7 Audio Drivers Not Automatically Installed?
9.3.2. Oracle VM VirtualBox Install Is Failing With "Postinstall Script Did Not Complete Successfully" Errors
9.3.3. There Is an Error When I Add an Oracle VM VirtualBox Host to a Desktop Provider
9.3.4. Are all Oracle VM VirtualBox Releases Compatible With Oracle VDI?
9.3.5. I Can See My Oracle VM VirtualBox Hosted Desktop, But It Will Not Start
9.3.6. The Time in My Oracle VM VirtualBox Desktop Is Too Slow
9.3.7. What Are the Requirements for High Availability for Oracle VM VirtualBox?
9.3.8. How Do I Change the Password of the VirtualBox User?
9.3.9. Users Experience Blurry Text in Internet Explorer
9.3.10. A Critical Alert is Displayed When Storage is Added to a Desktop Provider
9.3.11. A Storage Cannot Be Removed From a Desktop Provider
9.3.12. Adding a Storage Fails With an "Unable to Stop Cluster" Error
9.4. VMware vCenter Desktop Provider
9.4.1. I Cannot Log into My VMware Virtual Machine
9.4.2. Users Cannot Log Into Their VMware Provided Windows desktop
9.4.3. Why Does My VMware Virtual Machine Have an Invalid IP Address Or Cannot Be Pinged?
9.4.4. I Am Unable to Get a MS RDC Connection on My VMware Virtual Machine
9.4.5. Creating a vCenter Desktop Provider Fails With "Unable to Contact VMware VirtualCenter - Host Not Reachable at Port 443" Errors
9.4.6. In My VMware Desktop Pool, New Virtual Machines Are Created Automatically, But They Are Not Made Available
9.4.7. The VMware Virtual Machine Cloning Process Is Not Operating As Expected
9.4.8. The Window Displaying the VMware-Hosted Virtual Desktop Is Freezing
9.4.9. I Have Created a New Pool in My VMware Desktop provider and Virtual Machines Are Not Created Automatically
9.4.10. How Do I Use VMware Virtual Machines With Multiple Network Adapters?
9.4.11. Unused VMware Virtual Machines Are Not Being Recycled
9.5. Microsoft Hyper-V and RDS Desktop Providers
9.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?
9.5.2. Hyper-V Desktop Cloning Fails With "Cannot Reload MSiSCSI Target List" Errors
9.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?
9.5.4. Oracle VDI Is Not Able to Communicate With the Windows Server
9.5.5. Connection Problems between Oracle VDI and Hyper-V
9.6. Desktops and Pools
9.6.1. How Do I Make a Desktop Available to a User at All Times?
9.6.2. Starting a Desktop Fails With "No suitable Hosts to Start a Desktop for Desktop Provider <Name>" Errors
9.6.3. What Is the Difference Between Personal and Flexible Desktop Assignments?
9.6.4. Oracle VDI Fast Preparation Is Failing
9.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?
9.6.6. The Audio in My Ubuntu Desktop Is Playing Too Slowly. What Should I Do?
9.6.7. Audio Does Not Play After Changing the Audio Configuration for Oracle VM VirtualBox Hosted Desktops in Oracle VDI Manager
9.6.8. How Do I Specify USB Redirection for Sun Ray Clients?
9.6.9. USB Devices Are Not Detected
9.6.10. What Are the Differences Between MS-RDP and VRDP?
9.6.11. Cloning Fails if the Sysprep Timezone Setting Does not Match the Host Timezone
9.6.12. Checking the VirtualBox Guest Additions Version
9.6.13. Starting A Desktop Fails With an "Error Getting State" Message
9.7. Logging In and Accessing Desktops
9.7.1. Users Cannot Access Their Desktops
9.7.2. A User Can Log in But Their Desktop is Not Responding
9.7.3. Error - "Currently There Is No Desktop Available Or Assigned to You"
9.7.4. Is It Possible to Customize the Desktop Login Screen?
9.7.5. The Sun Ray Client Is Cycling and Cannot Connect to a Virtual Machine
9.7.6. Users Cannot Log in to Ubuntu 8.04 Desktops Because the Network Is Not Enabled
9.7.7. How Do I Control Client Redirection with client.autoredirect Properties?
9.7.8. Hotdesking Redirect Does Not Work With Windows XP Professional and Microsoft RDP
9.8. Administration Tools
9.8.1. I Cannot Log in to Oracle VDI Manager
9.8.2. I Get a Blank Screen After Successfully Logging into the Oracle VDI Manager
9.8.3. Error - "You Have Been Logged out Because a Consistent Response Could Not Be Guaranteed"
9.8.4. How Can I Change the Password of an Oracle VDI Host?
9.8.5. How Do I Change the Password of a Remote MySQL Database?
9.8.6. Does the MySQL Database Store All Sun Ray Software Configuration?
9.8.7. The vda Command Reports That Oracle VDI Is Not Running But Other Commands Say It Is
9.8.8. Users Do Not Show Up in Users and Groups in Oracle VDI Manager
9.8.9. Is There a Way to Modify the Cacao Logging Behavior So That a Long History Can Be Maintained?
9.8.10. Jobs Do Not Finish Even After You Cancel Them with Oracle VDI Manager
9.8.11. Can I Adjust the Logging Level for the Oracle VDI Logs?
9.8.12. How Do I Log in to the Embedded MySQL Server Database?
9.9. Oracle VDI
9.9.1. Oracle VDI Hangs Intermittently When Running on x2270 Hardware
9.9.2. The System Is Not Reacting as Expected
9.9.3. How Do I Configure DHCP in Oracle VDI?
A. Automated Administration Scripts
A.1. Parsing vda Commands that Result in Jobs
A.2. Parsing vda Command Output
A.3. Parsing vda-center Command Output
B. Defaults for the Software Bundled With Oracle VDI
B.1. Sun Ray Software
B.2. 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. Xerces License