Configuring (or) Migrating from the XenApp Services (PNAgent) URL

book

Article ID: CTX692265

calendar_today

Updated On:

Description

 

image.png

Resolution

We recommend migrating from the XenApp Services URL to the Store URL (highlighted below). Each XenApp Services URL already has a corresponding Store URL associated with it.

image.png

Additionally, you must reconfigure Citrix Workspace App to reflect the Store URL.  

 The steps to do this depend on the following: 

  • How the PNAgent store was configured (GPO, manual, or through installer) 
  • If it’s a HTTP only store
  • If Domain pass-through is enabled
  • Through SelfService command line

Store config:

GPO: If the PNAgent store was configured using GPO, exit Workspace app, remove “PNAgent” URL from GPO settings and use store discovery URL, for example https://storefront.example.com/citrix/store/discovery

Below are the steps to change the GPO:

    • Open the Citrix Workspace app Group Policy Object administrative template by running gpedit.msc.

    • Under the Computer Configuration node, go to Administrative Templates > Classic Administrative Templates (ADM) > Citrix Components > Citrix Workspace > StoreFront.

    • Select Citrix Gateway URL/StoreFront Accounts List.

    • Select the Enabled option and click Show. If you enable this policy setting, you can enter a list of StoreFront Accounts and NetScaler Gateway URL.

    • Enter the URL in the Value field.

    • Specify the store URL that is used with the Citrix Workspace app:
      STOREx="storename;http[s]://servername.domain/citrix/<storename>/discovery;[On, Off]; [storedescription]"

Manual: If the PNAgent store was configured manually, then the user has to 

       Two options are available if the store was configured using the installer command line.

Option 1:

Option 2:

HTTP Only store:

 If you are using HTTP only URL, then follow the steps mentioned in the article - https://support.citrix.com/s/article/CTX134341-how-to-configure-citrix-receiver-for-windows-to-manually-add-http-stores?language=en_US

Domain pass-through enabled: 

If you are using the domain pass-through auth method, you need to add the store URL to an intranet or trusted zones as mentioned in https://docs.citrix.com/en-us/citrix-workspace-app-for-windows/authentication#modify-the-internet-explorer-settings 

Through SelfService command line:

If you are using the command line, you need to add the store URL as mentioned in https://support.citrix.com/external/article/CTX200337/driving-the-citrix-receiver-selfservice.html 

 


Background

CWA 2403 onwards, the support for “PNAgent” has been deprecated and removed.

https://docs.citrix.com/en-us/citrix-workspace-app-for-windows/deprecation.html

image.png

Issue/Introduction

Configuring PNAgent stores  (e.g., https://url/citrix/store/pnagent/config.xml), causes Citrix Workspace App for Windows (version 2409 or later) to display below error message on refresh or sign-in stating, “To resolve this issue, contact your helpdesk with this information: Error while parsing.” 

Additional Information

https://docs.citrix.com/en-us/citrix-workspace-app-for-windows/deprecation.html

https://docs.citrix.com/en-us/citrix-workspace-app-for-windows/store-configuration#using-the-group-policy-object-administrative-template

https://docs.citrix.com/en-us/citrix-workspace-app-for-windows/authentication.html#domain-pass-through-single-sign-on-authentication-with-kerberos

https://support.citrix.com/s/article/CTX134341-how-to-configure-citrix-receiver-for-windows-to-manually-add-http-stores?language=en_US