# Oracle® Virtual Desktop Client for iPad

## User Guide for Version 1.0

Copyright © 2011, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related software documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark licensed through X/Open Company, Ltd.

This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

June 2011

Abstract

Part Number: E23350-01

This manual describes how to use Oracle Virtual Desktop Client for iPad to log into a Sun Ray Software or Oracle Virtual Desktop Infrastructure server and start or reconnect to a desktop session.

Document generated on: 2011-07-04 (revision: 174)

List of Figures

2.1. Oracle Virtual Desktop Client Application Icon
2.2. Side Bar, Showing a List of Servers
2.3. Disconnect Button
2.4. Add Server Screen
2.5. Delete Server Screen
2.6. Additional iPad Keys for Oracle Virtual Desktop Client
2.7. Access Not Enabled OSD Icon

List of Tables

2.1. Connection Settings for Servers

## Preface

The Oracle Virtual Desktop Client for iPad 1.0 User Guide provides an introduction to using Oracle Virtual Desktop Client for iPad. The manual provides information on how you can use Oracle Virtual Desktop Client to start or reconnect to a Sun Ray Server or Oracle Virtual Desktop Infrastructure desktop session.

## 1. Audience

This document is intended for new users of Oracle Virtual Desktop Client. It is assumed that readers are familiar with Web technologies.

## 2. Document Organization

The document is organized as follows:

- Chapter 1, Introducing Oracle Virtual Desktop Client for iPad provides a brief introduction to Oracle Virtual Desktop Client.

- Chapter 2, Using Oracle Virtual Desktop Client for iPad describes how to use Oracle Virtual Desktop Client to connect to a Sun Ray desktop session.

## 3. Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible to all users, including users that are disabled. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/.

#### Accessibility of Code Examples in Documentation

Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.

#### Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

#### Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/support/contact.html or visit http://www.oracle.com/accessibility/support.html if you are hearing impaired.

## 4. Related Documents

The documentation for this product is available at:

http://www.oracle.com/technetwork/documentation/virtualdesktopclient-411777.html.

## 5. Conventions

The following text conventions are used in this document:

Convention | Meaning
--- | ---
boldface | Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.
italic | Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.
`monospace` | Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

## Chapter 1. Introducing Oracle Virtual Desktop Client for iPad

This chapter provides an introduction to Oracle Virtual Desktop Client for iPad.

## 1.1. About Oracle Virtual Desktop Client for iPad

Oracle Virtual Desktop Client is an application that installs on common client operating systems. You use Oracle Virtual Desktop Client to log in to a Sun Ray Software or Oracle Virtual Desktop Infrastructure server and start a new desktop session or reconnect to an existing desktop session.

Because you can install and run Oracle Virtual Desktop Client on your computer, it provides an alternative to using a Sun Ray Client. For example, you can install Oracle Virtual Desktop Client on your computer at home and use it to log in to a Sun Ray or Oracle Virtual Desktop Infrastructure server at your office. You can then access your programs and files as if you were working from your Sun Ray Client at the office.

This manual describes how to use the iPad version of Oracle Virtual Desktop Client.

## Chapter 2. Using Oracle Virtual Desktop Client for iPad

This chapter describes how you can use Oracle Virtual Desktop Client to connect to a Sun Ray Software or Oracle Virtual Desktop Infrastructure server from your iPad.

Details of how to configure connections are included, as well as the answers to some frequently asked questions (FAQs).

## 2.1. Connecting to a Server

1. Start the Oracle Virtual Desktop Client application.

   On the Home screen, tap the Oracle Virtual Desktop Client application icon.

   Figure 2.1. Oracle Virtual Desktop Client Application Icon

   The Oracle Virtual Desktop Client side bar is displayed, showing a list of servers.

   Figure 2.2. Side Bar, Showing a List of Servers

2. Select a server to connect to.

   Tap the name of the server in the side bar.

   If you want to specify a new server, tap the Plus (`+`) button to add the server to the side bar. See Section 2.3, “Configuring the List of Servers” for more details.

   When you tap the server name, Oracle Virtual Desktop Client connects automatically to the server and displays the login screen.

3. Log in to the server.

   Enter the user name and password for your Sun Ray or Oracle Virtual Desktop Infrastructure user account.

   To display the on-screen keyboard, tap with three fingers on the screen.

   After logging in, the Sun Ray Software or Oracle Virtual Desktop Infrastructure desktop session is displayed on the screen.

   Note

   The side bar disappears when you connect to the server. If you need to redisplay the side bar, drag from the left hand side of the screen with two fingers.

## 2.2. Disconnecting From a Session

1. Close down the session.

   - For a Sun Ray desktop session, tap the Log Out option in the Sun Ray Launch menu.

   - For an Oracle Virtual Desktop Infrastructure Windows desktop session, tap the Log Off option in the Windows Start menu.

2. Disconnect from the session.

   1. Redisplay the side bar.

      Drag from the left side of the screen using two fingers.

   2. Do either of the following:

      - Tap the Disconnect button at the bottom of the side bar.

        Figure 2.3. Disconnect Button

      - Tap on a server name, to connect to another server.

   Note

   You are not disconnected from the session if you press the Home button to return to the Home screen.

## 2.3. Configuring the List of Servers

The Oracle Virtual Desktop Client side bar contains a list of servers that you can connect to. You can configure this list by doing one or more of the following:

- Adding a new server

- Editing a server

- Removing a server

### 2.3.1. Adding a New Server

Note

Before you connect to a new Sun Ray Software or Oracle Virtual Desktop Infrastructure server, you must configure settings for the connection as shown below.

1. Tap the Plus (`+`) button.

   The Add Server screen is shown.

   Figure 2.4. Add Server Screen

2. Configure settings for the connection.

   The following table shows the available settings for this screen.

   Table 2.1. Connection Settings for Servers

   Setting | Description
   --- | ---
   Connection Name | Name used to describe the connection, such as `usa-west`. This name is shown in the list of servers in the side bar.
   Find Automatically | Selects a server on your network automatically. See Section 2.3.1.1, “Auto Discovery of Servers” for more details about this feature.
   Server Name | Type the full name or IP address for the server that you want to connect to. For example, `sr1.example.com` or `123.234.345.456`. If you select Find Automatically, this field is not available.
   VPN Mode | Enable this setting if you are connecting over a Virtual Private Network (VPN).
   MTU | The Maximum Transmission Unit (MTU) is the maximum packet size for network connections, in bytes. Move the slider to adjust the MTU setting. If you are experiencing problems when using a Virtual Private Network (VPN), you might want to decrease this value to allow space for Internet Protocol Security (IPSec) headers. Contact your administrator for advice on the correct setting for your network.

3. To save changes, tap the Add button.

   The new server is added to the list of servers in the side bar.

#### 2.3.1.1. Auto Discovery of Servers

Oracle Virtual Desktop Client includes a feature called auto discovery of servers. Auto discovery uses a discovery mechanism, such as Dynamic Host Configuration Protocol (DHCP), to select a server on your network automatically.

To enable auto discovery, turn on the Find Automatically option when you configure a new server. Oracle Virtual Desktop Client then finds a server on your network automatically.

Note

When you turn on the Find Automatically option, the Server Name field is not available on the Add Server screen.

### 2.3.2. Editing a Server

1. Tap the Edit button.

2. Tap on the name of the server that you want to edit.

   The Edit Server screen is shown.

3. Edit the connection settings for the server.

   See Table 2.1, “Connection Settings for Servers” for a description of the available settings.

4. Save the changes you have made.

   Tap the Done button. The server list is redisplayed.

5. Exit from edit mode.

   Tap the Cancel button.

   The server is shown in the server list in the side bar.

### 2.3.3. Removing a Server

1. Tap the Edit button.

2. Tap on the Delete icon to the left of the server that you wish to remove.

   The Delete icon rotates and a Delete button appears next to the server name. See Figure 2.5, “Delete Server Screen”.

   Figure 2.5. Delete Server Screen

3. Tap the Delete button.

   The server is removed from the server list in the side bar.

4. Exit from delete mode.

   Tap the Cancel button.

## 2.4. Using Gestures in a Session

A gesture is a finger motion that is used to interact with the iPad touch screen. The following table shows the supported gestures when you are working in a desktop session.

Gesture | Action
--- | ---
Tap with one finger | Left mouse-button click
Tap with two fingers | Right mouse-button click
Tap with three fingers | Display the on-screen keyboard
Touch and hold, then drag | Left mouse-button click + drag
Pinch fingers together | Zoom out
Pinch fingers apart (unpinch) | Zoom in
Drag with one finger | Pan across the screen. Only available when zoomed in.
Drag from the left side of the screen with two fingers | Display the Oracle Virtual Desktop Client side bar

To view help on supported gestures, tap the Gestures button at the bottom of the side bar.

See also your iPad documentation for more information about using gestures.

## 2.5. iPad Keyboard Extensions

To provide support for operation of Oracle Virtual Desktop Client using keyboard shortcuts, some additional keys have been added to the iPad on-screen keyboard.

The additional keys are at the top of the on-screen keyboard, as shown in Figure 2.6, “Additional iPad Keys for Oracle Virtual Desktop Client”.

Figure 2.6. Additional iPad Keys for Oracle Virtual Desktop Client

The following table lists the additional keys.

Key | Description
--- | ---
ctrl | Control
alt | Alt
shift | Shift
esc | Escape
del | Delete
tab | Tab
fn | Function keys. A list of options enables you to select a function key, from F1 to F12.
ext | Extra keys. A list of options enables you to select from the following extra keys: Insert Home End Page Up Page Down
cursor | Cursor keys. A list of options enables you to select from the following cursor keys: Left Right Up Down

### 2.5.1. Using the Additional Keys

1. Display the on-screen keyboard.

   Tap with three fingers on the screen.

2. Tap the required key strokes.

   You can use the additional keys in combination with the normal keys.

   For example, to type `Control-C`, tap the ctrl key. After it turns blue, then tap the C key.

   See your iPad documentation for more information about using the on-screen keyboard.

## 2.6. Frequently Asked Questions

This section provides the answers to some frequently asked questions (FAQs) about Oracle Virtual Desktop Client.

### 2.6.1. How Can I Get More Help on Using Oracle Virtual Desktop Client?

To view online help, tap one of the following buttons at the bottom of the side bar:

- Help. Displays this User Guide.

- Gestures. Displays help on supported gestures

### 2.6.2. Do I Need to Know the Name of My Server?

If you use the Find Automatically option when you configure a new server, to find a server on your network automatically, you do not need to know the name of the server. See Section 2.3.1.1, “Auto Discovery of Servers” for more details.

If you want to connect to a specific server, you need to type the name of the server in the Server Name field. Depending on how your network is configured, you can use one or more of the following names:

- The full name of the server on the network, also called the Domain Name System (DNS) name. For example, `vdi-1.example.com`.

- The host name of the server. For example, `vdi-1`.

- The Internet Protocol (IP) address of the server. For example, `123.456.789.12`.

Contact your administrator if you need to know the name of your Sun Ray Software or Oracle Virtual Desktop Infrastructure server.

### 2.6.3. Can I Connect Over a Virtual Private Network?

You can use Oracle Virtual Desktop Client to connect to a server over a Virtual Private Network (VPN). A VPN is typically used to provide secure access to a company network to people from outside the network, such as employees working from home. See your administrator if you need help to configure your computer for connecting over a VPN.

To use Oracle Virtual Desktop Client over a VPN, you must turn on the VPN Mode setting on the Add Server screen when you configure connections to the server.

Note

An icon in the iPad status bar indicates when you are connected to a VPN.

### 2.6.4. What If I Am Unable to Connect to a Sun Ray Server?

Sun Ray Software uses an on-screen display (OSD) to show the status of a connection. The OSD can be used to diagnose problems with a connection. For example, the following OSD icon indicates that the Sun Ray Software has not been enabled for access using Oracle Virtual Desktop Client.

Figure 2.7. Access Not Enabled OSD Icon

If you are unable to connect to the Sun Ray server and this icon is displayed, contact your administrator.

Your firewall configuration might prevent you from connecting to the Sun Ray server. Check that the firewall settings on your network allow you to use Oracle Virtual Desktop Client to access the Internet.

If the connection to the Sun Ray server fails, a warning screen is shown. When you tap OK at this screen, the side bar is redisplayed. You can then choose an alternative Sun Ray server.

### 2.6.5. Can I Play and Record Audio on My iPad?

If your administrator has enabled audio for sessions, you can play and record audio on your iPad. If you play a podcast, for example, the sound is output through the speaker on your iPad.

To record audio input from your iPad in a session, you can connect a microphone to the iPad, for example, and record the sound using software running on the server.

### 2.6.6. Can I Run Other iPad Applications While I am Using Oracle Virtual Desktop Client?

Yes. You can run other iPad applications at the same time as you are using Oracle Virtual Desktop Client. This is called multi-tasking.

When you press the Home button to switch away from your session, the Oracle Virtual Desktop Client application is suspended. You can then run other applications on your iPad.

Provided that your server is not configured to close the connection after a period of inactivity, you can usually resume your session when you switch back to Oracle Virtual Desktop Client.

Note

If the iPad is running low on memory, it may terminate the Oracle Virtual Desktop Client application to free up memory. You cannot then resume your session.