Month: October 2018

Citrix Published Apps migration script

Citrix Published Apps migration script

Recently I was working on a XenApp and XenDesktop 7.9 upgrade project. The customer didn’t want to touch the existing 7.9 environment, as it was a production environment with around 1000 concurrent users from different parts of the world. Instead a new XenApp and XenDesktop 7.18 site was created and we had to create everything manually in the new site.

Fortunately, besides the published application, there really wasn’t much to be done. We had to create a couple of Machine Catalogs and a few Delivery Groups. However the customer had 50+ published applications and it would take quite a while to manually create those by hand.

As it turned out, the customer couldn’t wait for me to develop this script, so I actually didn’t test it out in that specific environment. However that didn’t stop me from finishing the script, as I expect more 7.x to 7.x or 7.x to 1808 and later migration projects in the future.

As I wasn’t able to find any useful tools from Citrix to help me migrate a 7.x site to another 7.x site, I decided to write my own script, with some inspiration from some older scripts I had used earlier.

The script can be found here:

Copy the code above and save it to file called Migrate-XAapps.ps1. The script contains basic information on usage and also examples of the different switches and paramaters that can be used.

Let me know if you experience any issues. As mentioned in the script, I have tested the code on XenApp and XenDesktop 7.6 LTSR CU6, XenApp and XenDesktop 7.9 and Citrix Virtual Apps and Desktops 1808 and I haven’t run into any issues, however I have probably not covered every possible published application scenario out there.

Installing Foxit Reader

Installing Foxit Reader

A few weeks ago I came across blog post by Carl Webster on a guide on how to install Adobe Acrobat Reader DC. This guide is very detailed and if you are in need of performing an unattended deployment of Adobe Acrobat Reader DC, this is probably the only guide you will need.

However there are other PDF viewers out there, better viewers in my opinion. Adobe Acrobat Reader DC, and versions before DC (11.x, 10.x, 9.x), has become bloated with features most users will never need, especially the online features are almost useless, at least from my point of view. My point of view is of course based on how the application behaves in a non-persistent and/or multi-user environment and general functionallity.

This guide I will show you how to install an alternative PDF Viewer from Foxit. With Foxit Reader you will, in my opinion, get a better performing and less bloated PDF Viewer, compared to Adobe Acrobat Reader DC and it’s just as easy, or maybe easier, to deploy and customize compared to Adobe Acrobat Reader DC.

To get started you will obviously need the Foxit Reader source files. To get those, go to the Foxit website https://www.foxitsoftware.com/

Go to the Log In box and either log in, if you have an account or create a new account. The account is needed to be able to get the Foxit Reader MSI installer, the XML Editor, the Foxit Customization Tool and the Group Policy administrative templates.

Once logged in, go to the download section and click Free Software

Here you will need the Enterprise Packaging which is either an MSI or, depending on the language selected, an ISO with an MSI.

 

Select the language needed, amount of users and make sure to select the MSI package type. As mentioned, depending on your selected language, you may not be able to select the MSI package type, only EXE or ISO is available. In that case select ISO, it will have en MSI package that we can extract and use going forward.

Once past the image verification, you will get to the actual download site. The MSI package download will automatically prompt you to save the file, if not, go ahead and download it manually.

You will need the MSI package, the XML Editor and the Foxit Customization Tool.

So, this it how it should look like, when you have all the needed components:

How to install using an MSI transforms file

Next, extract the FoxitCustomizationTool.zip file, this is used to create an MSI transforms file with pre-configured setup settings.

Fire up the Foxit Customization Tool

Go to File and click Open and select the FoxitReader93_enu_Setup.msi file

Once opened, this is where the good stuff is..

From here on, I will show you how I usually configures the transforms file. The settings shown may not reflect your needs, so consider what you select and/or deselect.

I always disable the Auto Update feature, in non-persistent setups this is recommended.

In the Features pane you can choose which features of Foxit Reader to install or not to install.

This installs the bare minimum features, which allows you to open PDF files in either the Foxit Reader application or within browser windows.

I usually remove any unwanted shortcuts, in this case the Foxit Reader desktop shortcut and the Activate Plugins Start Menu shortcut.

Now all you have to do is save the configuration to an MST file.

Go to File and click Save-As, provide a name for your new MST file and save it in the same directory as the FoxitReader93_enu_setup.msi.

You are now able to deploy Foxit Reader unattended via MDT, SCCM, Altiris, PowerShell etc. using this command line:

msiexec /I FoxitReader93_enu_setup.msi /qb TRANSFORMS=”FoxitReader93_enu_Setup_FCT.mst” ALLUSERS=1

How to install using command line parameters only

If you for some reason don’t want to use a transforms file, a wide range of command line parameters are available when using the MSI installer.

This command line should provide you with the same result as the transforms install method described above:

msiexec /I FoxitReader93_enu_setup.msi /qb ADDLOCAL=”FX_PDFVIEWER” MAKEDEFAULT VIEW_IN_BROWSER=1 DESKTOP_SHORTCUT=0 AUTO_UPDATE=0 NOTINSTALLUPDATE=1 ALLUSERS=1

The Foxit Reader Deployment and Configuration guide describes a few additional command line parameters. The guide can be found on the Foxit Reader download site.

This covers the deployment of the Foxit Reader. Now, we are going to look a bit closer at what’s possible with the XML Editor.

Foxit Reader UI Customization

The XML Editor is needed to customize the graphical user interface of Foxit Reader. This means that you can hide certain parts of the application that may not be relevant for your users to access. I will show a few examples here, but there are a lot of different areas of the UI in Foxit Reader that can be hidden, so it’s really just a matter of picking out the parts that suit your needs.

I’ll usually hide the Help and the Share tabs. The Help tab isn’t really providing any useful information to user and the Share tab makes it possible to integrate with Evernote, OneNote and Sharepoint which may not be available.

To make these changes to the UI you will need an XML file, which you create using the XML Editor.

Open the XML Editor, it should look like this:

Make sure to click the Interface button, and select Foxit Reader. Also in the version box, make sure to type in the correct version of Foxit Reader.

Next go to the Ribbon Set tab. In here you will see a lot of different check boxes, each representing either a feature or a tab to hide. As mentioned, I want to hide the Help and Share tabs, this is done simply by checking the corresponding boxes:

Next click Export and save the XML file:

The XML goes into the C:\Program Files (x86)\Foxit Software\Foxit Reader\ProfStore folder, just overwrite the existing profstore.xml file, as it’s a default XML containing the default out-of-the box configuration.

Look at this nice and clean UI:

You can download a pre-configured sample of profstore.xml file here. Be sure to review the customizations, before production usage.

Deployment script examples

The profstore.xml should be copied as a part of the deployment process. I have provided a couple of examples on how to create either a batch script or a PowerShell script to deploy Foxit Reader and copy the profstore.xml file.

Batch/CMD:

msiexec /I FoxitReader93_enu_setup.msi /qb TRANSFORMS=”FoxitReader93_enu_Setup_FCT.mst” ALLUSERS=1

copy profstore.xml “C:\Program Files (x86)\Foxit Software\Foxit Reader\ProfStore” /Y

PowerShell:

Start-Process -Wait FoxitReader93_enu_setup.msi -Argumentlist “/qb TRANSFORMS="FoxitReader93_enu_Setup_FCT.mst” ALLUSERS=1″

Copy-Item profstore.xml -Destination “C:\Program Files (x86)\Foxit Software\Foxit Reader\ProfStore” -Force

This concludes the guide.

We are now able to get the source files to Foxit Reader and make UI custumizations and deploy it. Now, there is no excuse, start testing Foxit Reader! I am sure you’ll agrre with me that Foxit Reader can easily take on Adobe Acrobat Reader.