Bulletproof Guide to Citrix Receiver Start Menu Integration

An article by Trond Eirik Haavarstein from xenappblog

In this post I’m going to show you how to setup Citrix Receiver Start Menu Integration and troubleshoot in case it doesn’t work.

First off, to get this working you NEED to use HTTPS. Check out my previous posts Securing Citrix X1 StoreFront with Powershell and Citrix StoreFront Complete Automation.

I’m using Citrix Receiver 4.3 TP and Citrix Storefront 3.0 TP. Let’s install Citrix Receiver using the following Powershell code:

Write-Verbose "Setting Arguments" -Verbose
$StartDTM = (Get-Date)

$Vendor = "Citrix"
$Product = "Receiver"
$PackageName = "CitrixReceiver4.3TP"
$InstallerType = "exe"
$Version = "4.3TP"
$LogPS = "C:WindowsTemp$Vendor $Product $Version PS Wrapper.log"
$LogApp = "C:WindowsTemp$Product.log"
$Destination = "${env:ChocoRepository}" + "$Vendor$Product$Version$packageName.$installerType"
$UnattendedArgs = '/silent /includeSSON'

Start-Transcript $LogPS

CD $Version

Write-Verbose "Starting Installation of $Vendor $Product $Version" -Verbose
(Start-Process "$PackageName.$InstallerType" $UnattendedArgs -Wait -Passthru).ExitCode

Write-Verbose "Customization" -Verbose
copy-item "C:ProgramDataMicrosoftWindowsStart MenuProgramsCitrix Receiver.lnk" -Destination "C:ProgramDataMicrosoftWindowsStart MenuProgramsStartupCitrix Receiver.lnk" -Recurse

Write-Verbose "Stop logging" -Verbose
$EndDTM = (Get-Date)
Write-Verbose "Elapsed Time: $(($EndDTM-$StartDTM).TotalSeconds) Seconds" -Verbose
Write-Verbose "Elapsed Time: $(($EndDTM-$StartDTM).TotalMinutes) Minutes" -Verbose
Stop-Transcript

This will install Citrix Receiver with Single Sign On and copy the icon to the Startup folder.

Please be aware that if you install 4.3 Technical Preview you need to do some manual clicks. This will go away when it’s official.

Bulletproof Guide to Citrix Receiver Start Menu Integration 06

One of the most common mistakes is forgetting to add your Storefront URL to the Trusted Zone List. You’ll find the GPO in Administrative Templates – Windows Components – Internet Explorer – Internet Control Panel – Security Page.

Bulletproof Guide to Citrix Receiver Start Menu Integration 04

Let’s create a Group Policy for Citrix Single Sign On with Storefront Configuration. You need to import the ADM templates.

I’m keeping the ADM templates with the binaries. You’ll find these under C:Program Files (x86)CitrixICA ClientConfiguration.

Bulletproof Guide to Citrix Receiver Start Menu Integration 05

Bulletproof Guide to Citrix Receiver Start Menu Integration 09

Navigate to Administrative Templates – Classic Administrative Templates – Citrix Components – Citrix Receiver – User Authentication – Local username and password. Set the following:

Bulletproof Guide to Citrix Receiver Start Menu Integration 10

Navigate to Administrative Templates – Classic Administrative Templates – Citrix Components – Citrix Receiver – Storefront – Storefront Accounts List. Enable the policy and define your Store.

Store;https://sf-01.ctxlab.vmw/Citrix/Store/discovery;On;SF01

Bulletproof Guide to Citrix Receiver Start Menu Integration 11

Navigate to Administrative Templates – Classic Administrative Templates – Citrix Components – Citrix Receiver – Self Service and enable the first 3 policies.

I prefer to enable SelfServiceMode and Add/Remove Account at this stage. This makes it much easier for troubleshooting.

Bulletproof Guide to Citrix Receiver Start Menu Integration 12

Bulletproof Guide to Citrix Receiver Start Menu Integration 13

This is how I link the Internet Explorer and Citrix Receiver SSON policies.

Bulletproof Guide to Citrix Receiver Start Menu Integration 14

Now restart the computer and make sure it belongs to the OU where you have linked the GPO.

Head over to Store and configure Domain Pass-through.

Bulletproof Guide to Citrix Receiver Start Menu Integration 02

Bulletproof Guide to Citrix Receiver Start Menu Integration 03

To add the application shortcut to the Start Menu you need to set KEYWORDS:auto.

Bulletproof Guide to Citrix Receiver Start Menu Integration 15

Logon to your test computer. If everything works it should look like this.

Bulletproof Guide to Citrix Receiver Start Menu Integration 16

When you disable SelfServiceMode you’ll get all applications populated via the Citrix Receiver Start Menu Integration.

Bulletproof Guide to Citrix Receiver Start Menu Integration 22

Troubleshooting

Single Sign On

The first step is to verify that the Single Sign On process ssonsvr.exe is running in Task Manager.

Bulletproof Guide to Citrix Receiver Start Menu Integration 17

Now open your browser and verify that you get Single Sign On to StoreWeb. Please note that this works with both HTTP and HTTPS.

Bulletproof Guide to Citrix Receiver Start Menu Integration 18

Add Account

The Store has not been configured in GPO.

Bulletproof Guide to Citrix Receiver Start Menu Integration 07

Your apps are not available at this time

Bulletproof Guide to Citrix Receiver Start Menu Integration 19

Your Store is not configured to use HTTPS.

Bulletproof Guide to Citrix Receiver Start Menu Integration 21

You can verify this by clicking Accounts. If you have the Store configured with HTTPS in GPO, but the account show HTTP, you have certification problems. Verify that HTTPS works with StoreWeb.

Bulletproof Guide to Citrix Receiver Start Menu Integration 20

Citrix Receiver Start Menu Integration not working

Make sure to go through the steps above. If you can manually add icons in Citrix Receiver / StoreWeb and they show up in the Start Menu there´s something wrong with your application keywords.

Resources

Be Sociable, Share!
 

Tags:

Comments

No comments so far.

  • Leave a Reply
     
    Your gravatar
    Your Name