Quest vWorkspace Connector for Mac OS X

Quest® vWorkspace Connector for Mac OS X

Administration Guide

Version 7.5

© 2012 Quest Software, Inc.ALL RIGHTS RESERVED.Patents Pending.

This guide contains proprietary information protected by copyright. The software described in this guide is furnished under a software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the applicable agreement. No part of this guide may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording for any purpose other than the purchaser's personal use without the written permission of Quest Software, Inc.The information in this document is provided in connection with Quest products. No license, express or implied, by estoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of Quest products. EXCEPT AS SET FORTH IN QUEST'S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT, QUEST ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL QUEST BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF QUEST HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Quest makes no representations or warranties with respect to the accuracy or completeness of the contents of this document and reserves the right to make changes to specifications and product descriptions at any time without notice. Quest does not make any commitment to update the information contained in this document.If you have any questions regarding your potential use of this material, contact:Quest Software World HeadquartersLEGAL Dept5 Polaris WayAliso Viejo, CA 92656www.quest.comemail: [email protected] to our Web site for regional and international office information.Patents

This product includes patent pending technology.

TrademarksQuest, Quest Software, the Quest Software logo are trademarks and registered trademarks of Quest Software, Inc in the United States of America and other countries. For a complete list of Quest Software's trademarks, please see http://www.quest.com/legal/trademark-information.aspx. Other trademarks and registered trademarks are property of their respective owners.Quest vWorkspace Connector for Mac OS X Administration Guide - Updated April 2012 - Software Version - 7.5

http://www.quest.com/legal/trademark-information.aspx

http://www.quest.com/legal/trademark-information.aspx

http://www.quest.com/

mailto:[email protected]

About This Guide

• Overview• Conventions• About Quest Software• Contact Quest Support

vWorkspace Connector for Mac OS X Administration Guide

OverviewThis section is designed to assist you in becoming familiar with the Quest vWorkspace Connector for Mac OS X Administration Guide. This guide contains information on tasks pertaining to managing the vWorkspace Connector for Mac OS X. It is intended for network administrators, consultants, analysts, and any other IT professionals using the product.

It is recommended that you review the table of contents to familiarize yourself with the topics of discussion.

ConventionsIn order to help you get the most out of this guide, we have used specific formatting conventions. These conventions apply to procedures, icons, keystrokes, and cross-references:

ELEMENT CONVENTION

Select This word refers to actions such as choosing or highlighting various interface elements, such as files and radio buttons.

Bolded text Interface elements that appear in Quest Software products, such as menus and commands.

Italic text Used for comments.

Bold Italic text Used for emphasis.

Blue text Indicates a cross-reference. When viewed in Adobe® Reader®, this format can be used as a hyperlink.

Used to highlight additional information pertinent to the process being described.

Used to provide Best Practice information. A best practice details the recommended course of action for the best result.

Used to highlight processes that should be performed with care.

+ A plus sign between two keystrokes means that you must press them at the same time.

| A pipe sign between elements means that you must select the elements in that particular sequence.

iv

About Quest SoftwareNow more than ever, organizations need to work smart and improve efficiency. Quest Software creates and supports smart systems management products — helping our customers solve everyday IT challenges faster and easier. Visit www.quest.com for more information.

Contact Quest SoftwareEmail [email protected]

Mail Quest Software, Inc.World Headquarters5 Polaris WayAliso Viejo, CA 92656USA

Web site www.quest.com

Refer to our Web site for regional and international office information.

Contact Quest SupportQuest Support is available to customers who have a trial version of a Quest product or who have purchased a Quest product and have a valid maintenance contract. Quest Support provides unlimited 24x7 access to our self-service portal, http://support.quest.com/.

From support.quest.com, you can do the following:

• Retrieve thousands of solutions from our online Knowledgebase

• Download the latest releases and service packs

• Create, update and review Support cases

View the Global Support Guide for a detailed explanation of support programs, online services, contact information, and policy and procedures. The guide is available at: http://support.quest.com/.

v

mailto:[email protected]

http://www.quest.com

http://www.quest.com

http://support.quest.com/

http://support.quest.com/


vi

1
vWorkspace Connector for Mac OS X
• Overview• Third Party Components• vWorkspace Connector Interfaces


OverviewvWorkspace Connector for Mac OS X allows users, upon successful authentication, to receive a list of authorized desktops and applications in a vWorkspace infrastructure. Users can subsequently start remote connections to published desktops and applications by selecting the corresponding shortcuts.

Users of the vWorkspace Connector for Mac OS X can also access their virtual desktops or published applications by using two different interfaces, vWorkspace Connector, which is installed on a client access device, or Web Access, which uses a web browser.

The following is a list of some of the functionality that is available on the vWorkspace Connector for Mac OS X:

• Creating and editing connections; saving them to and loading from a persistent storage (disk database).

• Retrieving application lists from the broker.

• Launching applications in an RDP session.

• Sharing RDP sessions for new applications when a session is already running.

• Project installer.

• NAT support.

• Proxy server.

• Local devices redirection.

• Password management.

• Desktop Integration mode.

• RDP apps auto launch.

• Custom resolution.

• Sound redirection.

• EOP Xtream

• RDP experience.

• Graphics Acceleration.

• Flash Redirection.

• Printer mappings.

• Drive mappings.

2


• Shortcut, Apple + Q, to quit.

• Support for Microsoft keyboard shortcuts.

• Multimonitor support.

• Full Screen support.

Third Party ComponentsThis product contains the following third party components:

*A copy of the source code may be found at http://rc.quest.com.

vWorkspace Connector InterfacesThere are two primary interfaces available for the vWorkspace Connector for Mac OS X, vWorkspace Connector and Web Access.

• About vWorkspace Connector

• About Web Access

About vWorkspace Connector vWorkspace Connector for Mac OS X is a version of the vWorkspace Connector with an interactive user interface allowing users, upon successful authentication, to receive a list their desktops and applications. Users can subsequently start remote connections to published desktops and applications by selecting the corresponding shortcuts.

The vWorkspace Connector retrieves information about a user’s published applications, desktops, and other assigned resources available from a vWorkspace infrastructure by communicating with the vWorkspace Connection Broker. vWorkspace Connector must be configured so that it knows how to communicate with the vWorkspace Connection Brokers.

COMPONENT NOTES

*rDesktop This component is licensed under the GNU General Public License and a copy of the license can be found within the vWorkspace Connector for Mac OS X installation directory.

3


vWorkspace Connector can also be started in Desktop-Integrated mode where the user interface is suppressed, displaying in the menu bar. Application icons shortcuts are placed on the user’s Desktop, Start Menu, or All Programs menu, depending on preferences. vWorkspace Connector must be installed and configured before users are able to connect.

4


About Web AccessvWorkspace Web Access allows users to retrieve their list of allowed applications or desktops using a web browser. A Web Access web server must be available to use this interface.

Configuring Web Access

Configuration of the vWorkspace Connector for Mac OS X is not nessecary when used in conjunction with Web Access. To learn more about configuring the Web Access component please see the vWorkspace Administration Guide at https://support.quest.com/vWorkspace/Release-Notes-Guides.

5


6

2
• Overview• vWorkspace Connector for Mac OS X

Configuration• Manage vWorkspace Connector for Mac OS

X Connections


OverviewThe vWorkspace Connector for Mac OSX is client software for a Quest vWorkspace farm. It allows organizations to present windows desktops to internal and external users running a Macintosh operating sytem.

vWorkspace Connector for Mac OS X ConfigurationThe vWorkspace Connector retrieves information about a user’s published applications, desktops, and other assigned resources available from a vWorkspace infrastructure by communicating with the vWorkspace Connection Broker. vWorkspace Connector must be configured so that it knows how to communicate with the vWorkspace Connection Brokers. This process is referred to as managing or configuring connections.

The following sections describe the process of connecting to managed applications and desktops in a vWorkspace infrastructure using the vWorkspace Connector for Mac OS X. Users have the option of either connecting to full-featured desktops or individual applications, based upon administrative setup.

Manage vWorkspace Connector for Mac OS X ConnectionsThe vWorkspace Connector for Mac OS X connections can be created automatically by using the Basic mode on the Add Farms window, or created manually by using the Advanced mode options on the Manage Farms window.

The Basic Add Farm window will appear when the vWorkspace Connector MacOSX is first started and no farm configuration has been defined.

The connection properties for the vWorkspace Connector are found in the following sections on the Manage Farms window:

• Select Farm

• Configuration Source

• Connectivity

• Firewall/Proxy Traversal

8


• Credentials

• Display

• Local Resources

• User Experience

• Password Management

• Desktop Integration

• Auto-Launch

How to ...

Create a New Farm Connection in Basic Mode

1. Open the Applications folder on the desktop.2. Click the vWorkspace Connector application icon. The

vWorkspace Connector window displays.3. Click Add Farm on the vWorkspace Connector window. The Add

Farm window displays.

At any time in the Add Farm window in Basic mode, you may click the Advanced button to add the farm in Advanced mode.

9


4. Enter the server name of the Connection Broker you want to connect to.

5. Enter your credentials and if desired, activate the Save credentials (encrypted) checkbox if desired, and click Connect. The farm name, which is configured with the system defaults, displays in the vWorkspace Connector window.

How to ...

Create a New Farm Connection in Advanced Mode

1. Open the Applications folder on the desktop.2. Click the vWorkspace Connector application icon. The

vWorkspace Connector window displays.3. Click Add Farm on the vWorkspace Connector window. The Add

Farm window displays.

4. Click Advanced. The Create New Farm window displays.

5. Enter a farm name and click Next.

At any time in the Manage Farms window in Advanced mode, you may click the Basic button to add the farm in Basic mode.

10


6. Select Allow me to manually specify all configuration parameters on the Configuration Source window and click Next. The wizard will continue to step 7 i f this option is selected.

– OR –

select Download the configuration file from a central server, specify the protocol, URL, file and proxy server and then click Next.

11


7. Complete the fields on the Connectivity window, as appropriate, and then click Next.

CONNECTIVITY SETTINGS FIELD DESCRIPTION

Location Three separate connection locations are available from the list.

Use Rename to specify the location name, such as Office or Home.

Test Connection Select to test the connectivity settings for a location.

PROPERTIES FOR LOCATION

These settings are used to communicate with the Connection Broker, and are configured seperately for each location.

Protocol Select either HTTP or HTTPS.

TCP Port Select to specify the port in which the Connection Broker listens on for inbound connection requests. This is usually 8080.

Connection Brokers Select Add to enter the host name, FQDN, or IP address for a Connection Broker.

Use the arrow buttons to change the order in which the connections are attempted.

12


8. Complete the fields on the Firewall/Proxy Traversal window, and then click Next.

FIREWALL/PROXY TRAVERSAL SETTINGS FIELD DESCRIPTION

CONNECTION OPTIONS FOR LOCATION

These settings are used to specify secure network communications.

Enable NAT Support for Firewall Traversal

Select this when vWorkspace enabled virtual desktops or Terminal Servers/RD Session Hosts are located behind a firewall that is using Network Address Translation and Alternative Addressing.

Enable RDP over SSL/TLS Select if SSL/TLS encryption of RDP session traffic is to be used.

SSL Gateway Server Select if using an SSL Gateway Server, and enter the FQDN of the Quest vWorkspace SSL Gateway server.

This option is only available when Enable RDP over SSL/TLS is selected.

PROXY SERVER FOR LOCATION

These settings are used when the vWorkspace client device is located behind a NAT enabled firewall and Socks Proxy Servers are used to gain access to the outside network.

13


9. Specify the server login method on the Credentials window, and then click Next.

Do not use a proxy server Select if you do not want to set a proxy server.

Enter an address manually Select to indicate the address as entered.

The address must be entered in the following format:

proxy_server_name:port

proxy_server_name = host name, FQDN, or IP address of the Socks Proxy Server.

port = TCP port number the Socks Proxy Server is listening on.

Do not use proxy server for addresses beginning with:

Select to list proxy server exclusions.

Use semicolons (;) to separate the entries.

FIREWALL/PROXY TRAVERSAL SETTINGS FIELD DESCRIPTION

14


10. Select information for the Display Configuration and Colors on the Display window, and then click Next.

CREDENTIALS SETTINGS FIELD DESCRIPTION

Use the following credentials Uses the NT LAN Manager authentication protocols.

The Username, Password, and Domain information is entered, and the user is not prompted for this information during a connection attempt.

The Save credentials (encrypted) option allows the vWorkspace Connector to read the cached credentials from disk, and does not prompt users for them. This option is only available if the Use the following credentials option is selected.

15


DISPLAY SETTINGS FIELD DESCRIPTION

Display Configuration Sets the remote session window size during a non-seamless window connection.

The options are:

• 640 x 480 pixels

• 800 x 600 pixels

• 1024 x 768 pixels

• 854 x 480 pixels

• 1280 x 720 pixels

• 1280 x 800 pixels

• 720 x 480 pixels

• 720 x 576 pixels

• 800 x 480 pixels

• 1280 x 768 pixels

• Full Screen

• Custom

Colors Sets the remote session color depth during a non-seamless window connection.

The options are:

• True Color (24 bit)

• High Color (16 bit)

• High Color (15 bit)

• 256 Colors

Span multiple monitors when in full screen mode

Select to span multiple monitors when in full screen.

16


11. Enter your choices for Local Resources for this farm, and then click Next.

LOCAL RESOURCES SETTINGS FIELD DESCRIPTION

Remote Audio Bring to Local Computer — runs sound files in your Remote Desktop session and plays them on your local computer.

Leave at Remote Computer — runs sound files in your remote desktop session and plays them only on the remote computer.

Don’t play — disables all sound in remote desktop sessions.

Keyboard These options apply to Windows shortcut key combinations, such as Alt+Tab.

On the local computer — configures your connection so that Windows shortcut keys always apply to your local desktop.

On the remote computer — configures your connection so that Windows shortcut keys always apply to the desktop of the remote computer.

In full screen mode only — configures your connection so that Windows shortcut keys apply to the remote computer only when the connection is in full screen.

17


12. Specify your choices on the User Experience window, and then click Next.

LOCAL DEVICES AND RESOURCES

These settings determine which client side devices are available to the remote applications or desktops.

Disk drives Local disk drives.

Printers Local printers. Standard RDC printer mappings used for printing, so the appropriate drivers need to be installed on both the client devices and the remote computer.

Clipboard Enables redirection of copy and paste functionality.

Serial ports Local serial ports.

Parallel ports Local parallel ports.

Smart cards Smart card connections for authentication.

LOCAL RESOURCES SETTINGS FIELD DESCRIPTION

18


USER EXPERIENCE SETTINGS FIELD DESCRIPTION

Choose your connection speed to optimize performance

The options are:

• Modem 28 Kbps

• Modem 56 Kbps

• Broadband (128 Kbps - 1.5 Mbps)

• LAN (10 Mbps or higher)

• Custom

Allow the following: These options are used to create a custom setting:

• Persistent bitmap caching

• Desktop background

• Menu and window animation

• Show window contents while dragging

• Themes

Note: Bitmap caching can assist in reducing bandwidth requirements. The other features require additional bandwidth.

Optimizations This option is used to automatically enable the optimization when logged on to the remote computer:

• EOP Xtream

• Flash Redirection

• Graphics Acceleration

Reconnect if connection is dropped

This option allows for automatic reconnection if the connection is dropped.

19


13. Select Enable password management, as appropriate, and then enter the Server Name or IP Address and Port on the Password Management window. Click Next to continue.

PASSWORD MANAGEMENT SETTINGS FIELD DESCRIPTION

Server Name or IP Address The FQDN or IP address of the Quest vWorkspace Password Management Server.

Port The TCP port to which the Quest vWorkspace Password Management Server has been configured.

This is usually 443.

20


14. Select Applications\vWorkspace Connector on the Desktop Integration window, if you want to display your farm or farms from the menu options when in desktop integration mode. Click Next to continue.

21


15. Click the ellipsis (...) to select applications from your farm on the Auto-Launch window. The Auto-Launch feature allows an end user to start an application when the vWorkspace Connector is launched and authentication has occurred.

a) Click on the arrow to select the application or applications that are to be auto-launched, and then click Add.

16. Click Finish on the Auto-Launch window to complete the process.

How to...

Manage a Farm Connection

1. Click Manage Connections on the vWorkspace Connector window. The Select Farm window displays.

2. Select the existing farm to be edited and click on the links on the left to navigate to the desired section of the window to change farm connection properties:

22


• Select Farm

• Configuration Source

• Connectivity

• Firewall/Proxy Traversal

• Credentials

• Display

• Local Resources

• User Experience

• Password Management

• Desktop Integration

• Auto-Launch

When finished, click OK to save the settings.

23


How to...

Change a Farm Current Location

1. Click Change Current Location on the vWorkspace Connector window.

2. Click Farm Properties to navigate to the Manage Farms window and edit farm connection properties.

3. There are three locations available. Select a location and click Connect.

How to...

Log on to a Farm As A Different User

1. Click Logon As A Different User on the vWorkspace Connector window. The Logon Credentials window displays.

2. Enter the new credentials and click OK.

24


How to...

Refresh a Farm Application Set

1. Select a farm in the vWorkspace Connector window.2. If a farm is connected to multiple locations, click Change Current

Location and select a current location. You may also click Farm Properties to navigate to the Manage Farms window to edit farm connection properties. Click Connect.

3. Click Refresh Application Set. The application set of the farm’s current location displays in the vWorkspace Connector window.

25


26

Quest vWorkspace Connector for Mac OS X

Documents

Transcript of Quest vWorkspace Connector for Mac OS X