HOME




© 2017 Adobe Systems, Inc. All rights reserved.

Updated Dec 04, 2017.

Citrix XenApp & XenDesktop

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.

System requirements

  • October 11, 2016: Citrix XenDesktop 7.9, XenApp 7.9 and the latest hot fixes with 64-bit Win 7, 8, and 10, (pooled non persistent VMs).

Note

Note: While testing for this release occurred with 7.9, intermediate Citrix versions are supported.

  • May 10, 2016 update: Citrix XenDesktop 7.6 and the latest HotFixes with Win 7x64 bit and Win 8 64-bit (pooled non persistent VMs)
  • October 13, 2015 update: Citrix XenApp 7.6 with Win 2012 Server Standard edition 64-bit.
  • Citrix XenApp 7.1 and the latest XenApp Hotfixes with Win 2012 Server Standard edition 64-bit.
  • Citrix XenApp 6.5 and the latest XenApp HotFixes with Win 2008 R2 Server Enterprise edition 64-bit.

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, testing scenarios often include installing the latest versions of Microsoft Office Professional, Microsoft Internet Explorer, Microsoft Visio Professional Version, Microsoft Office Publisher, Microsoft Office Project Professional, Lotus Notes, and McAfee VirusScan Enterprise.

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

Note

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

Acrobat tuning

Recommendations:

  • Keep your Acrobat product updated.
  • Configure the product prior to deployment. See Product tuning.

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.

Licensing

You can license Acrobat with a serial number or via named user deployment.

Serialized deployment

For deployment steps, see Serialized imaged OS deployments.

Named user deployment

In additional to traditional, serialized licensing, DC products provide the option for admins to use named-user deployments and thereby leverage existing enterprise and federated IDs. The Adobe Admin Console provides a central location for managing your Adobe entitlements, including specific users and groups, across your entire organization. It also provides other tools for managing software, users, and devices and supports license management for all Adobe products. For more information, see:

For deployment steps, see Named user imaged OS deployments.

Enabling group access

Citrix offers the option to assign an application to a specific group of users irrespective how the application is deployed and provisioned. This can be done in the Limit Visibility section under Delivery Group in the Studio which lets you configure application users. In this scenario, the application is published globally but is visible only to the users listed in the Delivery Group.

For details, see http://www.virtualizationadmin.com/articles-tutorials/citrix-articles/installing-and-configuring-citrix-xenapp-xendesktop-76-part4.html

XenDesktop 7.9 installations

Adobe Acrobat installation scenarios include both Machine Creation Services and Provisioning Services.

Machine creation services

  1. Login to the master image.

  2. Install and update all the applications you want to provide to end users.

  3. Switch off the master machine.

  4. Take a snapshot of the master machine from the farm.

  5. Update the virtual desktop to the latest snapshot:

    1. Log in to the Citrix Studio Server as an administrator.
    2. Open Citrix Studio.
    3. Inside the farm, click on Machine Catalog.
    4. Right click on the catalog you want to update; for example, Win 7 or 10.
    5. Choose Update Machine.
    6. Choose Next.
    7. Select the corresponding Master Image Latest Snapshot.
    8. Select a Rollout Strategy (Immediately*#. or **Next Shutdown).
    9. Choose Next.
    10. Choose Finish.

Provisioning services

  1. Login to the golden image server.
  2. Install or update the application.
  3. Go to HKLM\Software\WoW6432Node\Network Associate\ePolicy Orchestrator\Agent.
  4. Delete the Agent GUID entry. (It makes the antivirus software independent of the machine until the next reboot thereby allowing it to work on the different servers that are booted by that vDisk.)
  5. Shut down the server.
  6. Log in to the PVS server and open the Provisioning Services console.
  7. Go to Device Collection.
  8. Check which disk is used to boot the main golden image server.
  9. Copy the disk and rename it according to your organization’s naming convention (for recovery purposes).
  10. Return to the Provisioning Services console.
  11. Right click on vDisk Pool.
  12. Click add or import Existing vDisks and add the newly created vDisk.

Recommended Settings:

  1. Go to the newly added vDisk.

  2. Right click and choose Mount.

  3. Open regedit and Click file > load hive.

  4. From the list, select System. A new hive named vDisk should now be present inside HKLM.

  5. Go to HKLM > vDisk > Controlset001 > Services > tcpip > paramaters and make the following changes.

    1. Clear DhcpDomain.
    2. Clear DhcpNameserver.
    3. Clear HostName.
    4. Clear NameServer.
    5. Clear NV HostName.
  6. Make the same changes in all the control sets.

  7. Choose File > Unload Hive.

  8. Open the PVS console again and unmount the vDisk.

Note

These settings help prevent name resolution conflicts on different servers.

  1. Right click the selected vDisk, and choose Load Balancing.
  2. Configure load balancing as desired.
  3. Go to Collection.
  4. Right click on the servers you want to boot the from new vDisk, and select Properties.
  5. Go to the vDisk tab.
  6. Remove the current vDisk.
  7. Add the required vDisk for all the servers individually.
  8. Select each server, and send the restart command. Wait for the servers to restart from the new vDisk.
  9. Go to the Citrix Studio server.
  10. Click on the XenApp server.
  11. From the right-hand menu select Add application.
  12. From the start menu list, select the applications you want to add and choose Next.
  13. Click Finish.

Known issues

  • Volume licenses are deleted when multiple users launch the product simultaneously before it is activated.
  • In the Help menu, signed-in users are not shown as signed-in on subsequent sessions.
  • Users may appear as signed-in on the Help menu even if they aresigned out from the Creative Cloud Desktop application.

XenDesktop 7.6 installations

  1. XenDesktop parent image update process:

    1. Log in to the master image.
    2. Install or update the application.
    3. Take the snapshot.
  2. Virtual desktop update process:

    1. Log in to Citrix Studio.
    2. Open Citrix Studio.
    3. Click on Machine Catalog.
    4. Right click on Catalog.
    5. Choose Update Machines.
    6. Choose Next.
    7. Select the Master Image latest Snapshot.
    8. Select a Rollout Strategy.
    9. Choose Next.
    10. Choose Finish.

Known Issues

  • Volume licenses gets deleted when multiple users launch the product simultaneously before it is activated.
  • In the Help menu, signed-in users are not shown as signed-in on subsequent sessions.
  • Users may appear as signed-in on the Help menu even if signed out from the Creative Cloud Desktop application.

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.