Citrix XenApp

Legacy Citrix apps not launching on newer Web Interface servers


If you ever try adding a legacy Citrix Presentation Server 4.0 farm to a Web Interface and the apps don’t launch, check the application event log on your Web Interface servers for Error 31203 messages like below:

Source: Citrix Web Interface
Event ID: 31203
The farm XXXXX has been configured to use launch references, but a
launch reference was not received from the Citrix XML Service.
Check that the farm supports launch references or disable launch
reference requests. [Unique Log ID: XXXXXXX]

Launch references are only support with Presentation Server 4.5 and above. To fix this, go to your WebInterface.conf on your Web Interface servers:


and change RequireLaunchReference and OverrideIcaClientname to Off and On respectively:


Update September 4, 2012:
I was informed by our Citrix SE this issue impacts Storefront as well. The work around above will work by changing the same settings in the web.config of the Storefront site.

About Jason Samuel

Jason Samuel lives in Houston, TX with a primary focus on strategic advisory and architecture of end-user computing, security, enterprise mobility, virtualization, and cloud technologies from Citrix, Microsoft, & VMware. He also has an extensive background in web architecture and networking over his 20+ year career in IT. He is an Author, Speaker, and Local User Group Community Leader. He is certified in several technologies and is 1 of 63 people globally that is a recipient of the prestigious Citrix Technology Professional (CTP) award. He is 1 of 42 people in the world that has been awarded as a VMware EUC Champion and VMware vExpert. He is a featured author on DABCC which provides the latest IT Community News on Cloud, Data Center, Desktop, Mobility, Security, Storage, & Virtualization. In his spare time Jason enjoys writing how-to articles and evangelizing the technologies he works with. Disclaimer: The content and opinions expressed in articles and posts are his own and are by no means associated with his employer.

Recommended for you


  1. IronVarmint

    September 13, 2012 at 2:29 PM

    I’m migrating an old Metaframe farm to XenApp 6.5 and have been scratching my head with this question for a few hours now. I thought there might be a setting in the webinterface.conf somewhere. I tried removing socket pooling, but that wasn’t it. Finally I put the right terms into Google and got here. Thank you again Jason for all the information on your site!

  2. Adam S

    August 2, 2014 at 1:57 AM

    Genius mate.
    Thanks heaps.

Leave a Reply

Your email address will not be published. Required fields are marked *