HOME

Page Contents




© 2012-15 Adobe Systems, Inc. All rights reserved.

Updated Dec 15, 2014.

Citrix Deployments

This document describes how to deploy Acrobat products on a Citrix server for streaming to Windows machines. It provides details about product setup on the Citrix XenApp Server and some details about the older Citrix Presentation Server.

Since there are many ways to configure Acrobat products and Citrix servers, these instructions are intended as basic examples. Administrators may need to tailor these instructions to meet the requirements of their own environment.

Session vs. application virtualization

Session virtualization where installed applications are streamed to clients is supported. Application virtualization where a Streamed Profile package is delivered either to the XenApp Server or the end users computer is not. While Citrix XenApp supports both session virtualization and application virtualization, only the former where the application is hosted on a server is well tested. Note that some forum users have figured out on their own how to create a package and stream it to clients.

What’s new for A11

  • Memory allocation and usage has been re-architected to reduce resource losses and greatly improve performance. In general:

    • Citrix performance compares favorably to a locally installed Acrobat product when using identical environments.
    • Memory usage and stability enhancements provide a better experience during heavy usage.
  • Major improvements have been made in the interoperability of the universal printer driver on XenApp 6.0.

  • Protected View works for all products under Citrix.

  • The look and feel of the application on low end 8-bit color machines is improved.

  • The documentation provides more configuration and best practices details.

Requirements

License requirements

Adobe requires that organizations have a valid Acrobat software license for every user that has access to Acrobat on the Citrix server. Note the 10.x licenses can only be used for 10.x products, 11.x licenses can only be used for 11.x products, and so on.

Note

Only licensed users should have access to the Acrobat instance on Citrix. For more information, see http://www.adobe.com/products/eulas/pdfs/Citrix_Policy_AX_AXI_11-12-2012.pdf.

System requirements

11.x products:

  • 11.0 and later: Citrix XenApp 6.0 + Latest XenApp Critical HotFix Rollup Pack + Critical HotFix (if any) with Win 2008 R2 Server Enterprise edition x64-bit.
  • 11.0.01 and later: Citrix XenApp 6.5 or 6.0 + Latest XenApp Critical HotFix Rollup Pack + Critical HotFix (if any) with Win 2008 R2 Server Enterprise edition x64-bit.

10.x products:

  • Citrix XenApp 6.0 + Latest XenApp Critical HotFix Rollup Pack + Critical HotFix (if any) on Win 2008 R2 Server Enterprise edition x64-bit.
  • Citrix XenApp 5.0 + Latest XenApp Critical HotFix Rollup Pack + Critical HotFix (if any) on Win 2008 Server Enterprise edition x64-bit.
  • Citrix XenApp 5.0 + Latest XenApp Critical HotFix Rollup Pack + Critical HotFix (if any) on Win Server 2003 R2, Enterprise Edition, 32 bit, SP2.

Note

Its recommended that users deploy Acrobat and Reader on x64 machines as there is a limited set of resources available on x86. Since each user runs a different instance of Acrobat, additional users do consume more CPU and RAM resources.

9.x products: Citrix Presentation Server 4.5 and XenApp 5.0 on Windows Server 2003 64-Bit Enterprise Edition with Service Pack 2 (SP2) and 2008 server 64-bit Enterprise Edition with Service Pack 1.

8.x products: Citrix Presentation Server 4.0, Enterprise Edition.

Tested environments

Because there is an unlimited number of possible execution environments, Adobe confines its testing to common scenarios. For Citrix deployments, the environments used for testing were as follows:

  • A user account was set up using Active Directory domain user group. The Anonymous User profile was not tested.
  • The user account was set up on the server as non-privileged accounts. The user can operate the computer and save documents, but they cannot install programs or make changes to the system files or settings.
  • The server machine was running typical enterprise software. For example, for 9.x products the following is installed: Microsoft Office Professional Edition 2007, Microsoft Internet Explorer 7.0, Microsoft Visio Professional Version 2003 and 2007, Microsoft Office Publisher 2007, Microsoft Office Project Professional 2007, Lotus Notes 8.0, and McAfee VirusScan Enterprise 8.0.

Best practices

Microsoft

Apply all critical and recommended hotfixes and all hotfix rollup packs that Microsoft provides.

Citrix

How you tune your environment depends on a number of factors such as the number of users, requisite features, PDF content, and so on. It is advisable to use this documentation as well as that provided by Citrix at http://support.citrix.com/search/basic/?searchQuery=Adobe+Acrobat&searchbtn.x=0&searchbtn.y=0.

Note

Admins may want to consider eliminating setup redundancy by using a provisioning server. You can configure the settings on that server and then use it to populate all other Citrix servers with the identical configurations.

Updates

Tuning

Citrix feature and setting names may vary across releases. As of 11.0, do the following:

Note

These settings may also prove beneficial for earlier versions of the product. Citrix preference naming may change across releases.

Acrobat

Updates

Keep your Acrobat product updated.

Tuning

Before deployment, the product should be configured as needed. In particular, you will want to disable features and behaviors that should not be accessible to end users in an IT-managed environment. For example:

  • The Updater should be disabled as described in this guide and the Preference Reference.

  • Accept the EULA on behalf of all users by setting the appropriate registry key.

  • For multilanguage installations (MUI), set the preferred language for all users via the SUPPRESSLANGSELECTION property or registry settings described in the Preference Reference.

  • Deploy enterprise files to the product’s directories (rather than per-user directories) so they are available to all users.

  • There are over 500 documented settings. Refer to the Preference Reference for complete registry and plist details.

  • Disable the Help > Repair Acrobat Installation menu by setting:

    • 32 bit machines: [HKLM\SOFTWARE\Adobe\(product name)\(version)\Installer] "Disable_Repair"
    • 64 bit machines: [HKLM\SOFTWARE\Wow6432Node\Adobe\(product name)\(version)\Installer] "Disable_Repair"

Scrolling performance

If scrolling performance is poor in graphic intensive documents, try the following:

  1. Go to Edit > Preferences > Rendering.
  2. Uncheck Smooth line art and Smooth images. Alternatively, you can set these preferences during pre-deployment configuration:
HKCU\Software\Adobe\Adobe Acrobat\10.0\Originals\bAntialiasGraphics: 0x00000000
HKCU\Software\Adobe\Adobe Acrobat\10.0\Originals\bAntialiasImages: 0x00000000

Distiller performance

  • In some environments, Distiller performance may suffer if the messages.log file becomes too large after a number of Distiller operations. Delete this file periodically. It is located at \Application Data\Adobe\Acrobat\Distiller <version>\messages.log.
  • Remove unused fonts from the Windows installation.

Folder permissions

Protected Mode will only work when the USERS group has the following permissions on the product installation folder: Read and execute, List folder contents, Read. For a default installation, the path might be C:\Program Files (x86)\Adobe\Reader 10.0).

Resource planning

While Citrix admins should follow Citrix best practices and are probably already familiar with the following issues, it’s worth noting the following:

  • Acrobat products leverage Windows’ User Profiles feature to provide end users with a custom experience with respect to settings and files. Follow standard Citrix’s methodologies for mapping user resources across one or more servers:

    • Registry: Registry preferences to control the UI and application behavior. Follow the Microsoft and Citrix recommendations when planning for registry configuration and deployment.
    • Files: The application creates and writes to files automatically, but end users can also store information such as signature appearances, contacts, templates, and so on. Follow the Citrix recommendations for setting up file I/O.
  • Separate installers: When enterprise workflows require components that use separate installers, run those installers at deployment time. End users without admin privileges on the server won’t be able to install components if their workflow suddenly requires them. The following items requires running an additional installer:

Known Citrix limitations

The following are known issues for Acrobat products and Citrix clients:

  • Pre 10.1: Product versions prior to 10.1 do not support Protected Mode with Citrix. Administrators should disable and lock Protected Mode. Protected Mode and Protected View are both supported with 10.1 and later on Citrix and Windows Terminal Server deployments.
  • All versions: Acrobat Standard and Reader users can run repair from the help menu on Vista and above. If a reboot is required, the Citrix server hosting the application will be restarted. To prevent this problem, create a JavaScript file (.js) containing (app.hideMenuItem("DetectAndRepair");) and place it in the <root>\Reader 10.0\Reader\Javascripts directory.
  • All versions: Acrobat’s PDF generation capabilities embedded in 3rd party products (PDFMaker) and Adobe PDF Printer do not currently check Citrix licensing restrictions. Even users who don’t have access to the Acrobat application may be able to use Acrobat PDFMaker and Adobe PDF Printer.

Note

Only licensed users should have access to the Acrobat instance on Citrix. For more information, see http://www.adobe.com/products/eulas/pdfs/Citrix_Policy_A10-5-31-2011.pdf.

XenApp 6.0 installations

Note

This section applies only to 10.x and 11.x products.

To publish the Application(s) via Citrix XenApp Server 6.0:

  1. Start the Citrix Access Management Console.
  2. If needed, type your user ID and password, to authenticate to the farm. Once you start the Citrix Delivery Services console, you’ll see a list of farms on the left hand side.
  3. Expand + (plus) next to the <farmname> for which you want to install the Reader or Acrobat applications.
  4. Expand the Applications node within the farm.
  5. Right click the Applications folder icon choose Publish application.

The Citrix Application Publishing Wizard starts. All of the following steps take place within the Citrix Application Publishing Wizard:

  1. At the Welcome screen, choose Next.

  2. Enter a Display Name for the application. The Application Description text field is optional.

  3. Choose Next.

  4. Choose the Application radio button (default).

  5. In the Application Type panel:

    1. Select Accessed from a server.
    2. Leave the Installed application as the selection in the Server application type drop down menu.
    3. Choose Next.
  6. Choose Browse under the Command Line text field.

  7. Navigate to where the Acrobat or Reader application is installed and select the Acrobat.exe or AcroRd32.exe file. If you performed a standard install, the path is:

    • C:\Program Files x86\Adobe\Acrobat 10.0\Acrobat\Acrobat.exe
    • C:\Program Files x86\Reader 10.0\Reader\AcroRd32.exe
  8. Choose OK.

  9. Specify values for the Working Directory text fields, and choose Next.

  10. Add the servers on which the published application will run:

    1. Choose Add.
    2. Select the requisite server from the Servers folder.
    3. Choose OK.
    4. Choose Next.
  11. Specify the Users who can use the published application:

    1. Choose Allow only configured users (default)
    2. Choose on Add > Acrotest.com > Users > Domain Users.
    3. Choose OK.
  12. Choose Next.

  13. Optional. Select the check boxes to add application shortcuts to the client’s start menu as well as the desktop and Programs folder (when accessing through Program Neighborhood).

  14. Choose Next.

  15. Optional. You can configure additional advanced options like Access Control, Content Redirection, Limits of instances of application on server, Client options and Application appearance options. To configure these options:

    1. Check the Configure advanced application settings check box (To select the defaults, simply uncheck Configure advanced application settings).
    2. Choose Next.
  16. Choose Finish to publish the application and make it available for network use via Citrix.

XenApp 5.0 installations

This section applies only to 10.x products.

Disabling Protected Mode

Note

For 10.1 and later products, skip this section.

Adobe Reader 10.0.3 does not support Citrix with Protected Mode enabled (the default). Administrators should disable and lock Protected Mode. 10.1 and later support both Citrix and Windows Terminal Server deployments.

Protected Mode can be locked as enabled or disabled as follows:

  1. Go to HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Adobe\<product name>\<version>\FeatureLockDown.
  2. Right click and choose New > DWORD Value.
  3. Create bProtectedMode.
  4. Right click on the key and choose Modify.
  5. Set the value to 0.

Installing from the management console

These instructions are for the 6.0 product. For 6.0, the Access Management Console has been renamed to the Citrix Delivery Services Console.

  1. Start the Citrix Access Management Console for XenApp Server 5.0 by doing one of the following:

    • Choose from Start > Programs > Citrix > Management Consoles > Access Management Console.
    • Launch the console directly by double-clicking <install path\Citrix\Access Management Console - Framework\CmiLaunch.exe.
  2. In the left-hand panel, highlight the needed farm.

  3. If required, enter your ID and password and authenticate to the farm.

  4. Click + (plus) next to the farm on which you will install the Acrobat X or Reader X applications.

  5. Right click the Applications folder icon that is within the farm you just expanded.

  6. Choose New > Publish application. The Citrix Application Publishing Wizard will start and guide you through the process of publishing an application.

  7. At the Welcome screen, choose Next.

  8. Enter a Display Name for the application (for example, Acrobat X or Reader X) and an optional Application Description.

  9. Choose Next.

  10. Configure the type of application to publish:

    1. Select the Application’ radio button (default).
    2. In the Application Type list, select “Accessed from a server”.
    3. In the Server application type drop down list, verify Installed application is selected.
    4. Choose Next.
  11. Choose Browse under the Command Line text field.

  12. Navigate to Acrobat. exe or AcroRd32.exe file. The standard install path is C:Program FilesAdobe<Acrobat 10.0 or Reader 10.0><Acrobat or Reader><Acrobat.exe or AcroRd32.exe>.

  13. Choose OK.

  14. Leave the default empty set value for the Working Directory text fields or point to the Acrobat/Reader parent install folder.

  15. Choose Next.

  16. Add the servers on which the published application will run:

    1. Choose Add.
    2. Select the servers.
    3. Choose OK.
    4. Choose Next.
  17. Specify the Users who can use the published application:

    • To provide usage privileges to a specific group, drill down through the domain tree and locate that group and choose Add.
    • To let anyone on your network use the application, select Allow Anonymous Connections.
  18. Choose Next.

  19. Optional: Application shortcut placement fields are optional. Select the check boxes to add application shortcuts to the client’s start menu, desktop, and Programs folder (when accessing through Program Neighborhood). Choose Next.

  20. Optional: Configure advanced options:

    1. Check Configure advanced application settings check box.

    2. Choose Next.

    3. Set the following as needed (ff you are unsure what settings to choose, leave the defaults and uncheck the check box for configuring advanced settings):

      • Access Control
      • Content Redirection
      • Limits of instances of application on server
      • Client options
      • Application appearance
  21. Choose Finish.

Note

If you receive a restart prompt, Adobe strongly recommends that you restart the system.

Client-side Citrix access

This document describes how to use Citrix to access Acrobat via a web interface and the Program Neighborhood Client. Other options are possible. For example, publishing an entire desktop as well as PNA Agent.

Accessing Acrobat via the Citrix Web Interface

  1. Install the Citrix web client locally by running XenAppWeb.msi.
  2. Open Internet Explorer and enter the server URL.
  3. Enter your credentials.
  4. Choose Log On.
  5. Double click on any Acrobat or Reader shortcut.
_images/CitrixAuth.png

Citrix Maps your local drive with the server. Accessing any local file causes Citrix to open an ICA File Security dialog which asks to allow the server to access your local drive. If you select full access, Citrix maps your both your local drive and printer driver to the server hosted application so that you can seamlessly use the applications.

Accessing Acrobat via the Program Neighborhood Client

  1. Install the Citrix hosted client locally by running XenAppHosted.msi. Doing so installs the Web Client, Program Neighborhood Agent, and Program Neighborhood.
  2. Use the installation setup details provided by the Citrix administrator.
  3. Double click the Citrix Program Neighborhood icon to open Custom ICA Connection dialog.
  4. Choose File >Custom Connections Settings.
  5. Verify Network Protocol Connection is set to HTTP/HTTPS on the Connection tab.
  6. Verify Server Group is set to Primary.
  7. Choose ADD.
  8. Enter the server details provided by the Citrix administrator
  9. Choose OK.
  10. Choose Add ICA Connection.
  11. Set Custom ICA connection to Local Area Network.
  12. Choose Next.
  13. Enter a name for the ICA Connection.
  14. Set Network Protocol to TCP/IP+HTTP.
  15. Select the Server radio button.
  16. Enter your server name or select one from drop down list.
  17. Choose the Published Application radio button.
  18. Select Acrobat or Reader from the drop down list.
  19. Select a view for the published application.
  20. Choose Next.
  21. Leave the Encryption Level as default.
  22. Choose Next. In the log-in Window dialog, do not provide any credential information.
  23. Leave Windows color as default.
  24. Choose Next.
  25. Choose Finish.

An ICA connection icon is created with the name you provided. Double click this icon to launch the application.

Presentation Server installs

This section applies to only 8.x and 9.x products.

Install Acrobat products by using either Add or Remove Programs or Citrix Installation Manager on the computer running Citrix Presentation Server.

Installing with Add/Remove Programs

To install Acrobat products using Add or Remove Programs:

  1. Choose Start > Settings > Control Panel > Add or Remove Programs.

  2. Choose Install.

  3. Do one of the following:

    • If you are installing from a CD, insert the disk and choose Next.
    • If you are installing from an executable file on the network, choose Next, and then choose Browse to locate the file.
  4. Choose Finish.

Note

If the installer prompts you to restart the server, it is strongly recommended that you do so.

Publishing the application on the server

Before clients can access an application, you must publish it on the server by using the Citrix Management Console.

To publish an application:

  1. Choose Start > All Programs > Citrix > Citrix Management Console.
  2. In the Log On to Citrix Farm dialog box, select the server.
  3. Enter your Citrix administrator credentials.
  4. In the Citrix Management Console dialog box, expand the Applications tree.
  5. Right-click Application and choose Publish Application.
  6. On the first page of the Application Publishing Wizard, enter a display name (for example, Acrobat) and a description of the application (for example, PDF Creation). These details appear on the Web interface and other client interfaces.
  7. Choose Next.
  8. Choose Application > Browse to find the Acrobat product you want to publish. For example, Acrobat.exe.
  9. Choose Next.
  10. On the Program Neighborhood Settings page, choose Next.
  11. On the Specify Application Appearance page, make any changes to the application resolution, and then choose Next.
  12. On the next page, if you want to enable audio, choose Enable Audio. Then, choose Next.
  13. On the Specify Application Limits page, choose Next.
  14. On the Specify Servers page, choose Citrix Server.
  15. Choose Add to move it to the Configured Servers list.
  16. Choose Next.
  17. On the Specify Users page, if you want to specify users who can run the application, clear the Allow Anonymous Connections option, and specify the users you want to allow.
  18. Choose Next.
  19. On the Specify File Type Associations page, choose Finish.

The wizard finishes and the application is published.

Accessing Citrix from a client

After Acrobat is published on the server, Citrix client computers can establish connections to it.

Add a new Citrix client connection

  1. Choose Start > All Programs > Citrix ICA Client > Citrix Program Neighborhood.
  2. Select Add New ICA Connection to open the connection Wizard.
  3. Choose Next.
  4. Log on to the computer running Citrix Presentation Server.

Accessing Acrobat via the Citrix Web Interface

  1. On the computer you want to use to access Acrobat, point the Web browser to the Citrix Server Web portal (for example, http://editcitrix.corp.adobe.com).
  2. If you have not yet downloaded the Citrix Web Interface client on this computer, you will be prompted to download it. Follow the on-screen instructions to download and install this application.
  3. Log on to the Citrix Web Interface client.
  4. On the Web portal site, choose the application icon for the requisite Acrobat application.

Accessing Acrobat via the Program Neighborhood client

  1. Run the installer file ica32.msi on the computer you want to use as the Citrix Program Neighborhood client.

  2. Double-click the Citrix Program Neighborhood icon on the computer desktop.

  3. Choose File > Custom Connections Settings.

  4. On the Connection tab, verify the following settings:

    • Network Protocol Connection: HTTP/HTTPS
    • Server Group: Primary
    • Optional: To add an address list, choose Add, and then follow the on-screen instructions.
  5. Choose OK.

  6. On the computer desktop, double-click Add ICA Connection.

  7. Set the connection type to Local Area Network.

  8. Choose Next.

  9. On the Connection page, do the following:

    1. Enter a description of the ICA connection.
    2. Verify that the Network Protocol is set to TCPIP/HTTP.
    3. Choose the Server option and type the server name in the text box.
    4. Choose Published Application.
    5. In the list, select the name of the Acrobat application you want to run.
    6. Choose Next.
  10. Select a view for the published application.

  11. Choose Next.

  12. On the Encryption Level page, choose Next.

  13. Enter your user credentials.

  14. Choose Next.

  15. Verify that the Windows colors are set to Default.

  16. Choose Next.

  17. Choose Finish.

Note

If you receive a restart prompt, Adobe strongly recommends that you restart the system.

Removing the product

Uninstall an Acrobat product by using either Add or Remove Programs or the Citrix Installation Manager on the computer running Citrix Presentation Server.

To remove an application using Add or Remove Programs:

  1. Choose Start > Settings > Control Panel > Add or Remove Programs.
  2. Select the application.
  3. Choose Remove.
  4. Restart the server to ensure that all the appropriate files are removed.

Known limitations with Acrobat 9.x

The following are known issues for Acrobat products and Citrix clients:

  • Issue #1451407: The Acrobat 9 graphical interface renders poorly when displayed using 8-bit resolution on a Citrix client.
  • Acrobat closes when a user right-clicks inside the main window. This applies to Acrobat and Reader versions 7, 8 and 9 running on Citrix Presentation Server 4.0. To fix this problem, install the Hotfix Rollup Pack PSE400W2K3R03.
  • Citrix Presentation Server 4.0, Citrix Access Essentials 1.0 and 1.5 for Windows Server 2003. For more information on this series of fixes, refer to the Citrix Systems KB article CTX111419 at http://support.citrix.com/article/CTX111419.
  • Issue #1520296: Mail does not launch when taking a shared review offline and attempting to send comments by email.
  • Issue #1760973: Users are unable to Browse to a network folder via Add Existing folder.