PN Agent Access Over The WAN

PN Agent Access Over The WAN


Citrix PN Agent is one of the delivery methods (Along with Program Neighourhood and Web Interface) through which Citrix XenApp Published Applications can be provided to users.

The PN Agent client provides the ability for Single Sign On and also the ability to integrate Published Application Icons in to a users Desktop and Start Menu.

With the introduction of Mobile Clients like the iPhone / iTouch Receiver client, this article provides the steps to deploy a PN Agent Site across the WAN through a Citrix Access Gateway.


  • A Citrix XenApp Server Farm
  • Published Applications
  • A Web Interface installation
  • A Citrix Access Gateway appliance

Creating The PN Agent Site

The PN Agent site creation is a straight forward task and does not need any additional steps performed to be configured to delpoy via a CAG.  The steps to configure PN Agent to deploy via a Citrix Access Gateway Appliance are explained in the section Editing The WebInterface.conf File further down.

To create a new PN Agent site perform the following steps :-

  • Launch the Citrix Access Management Console on the Web Interface Server
  • Click on Create Site in the Common Tasks box
  • When prompted select Program Neighborhood Agent Services Siteand click on Next
  • Configure the Path for the site E.G. /Citrix/PNAgent as the Default shows and click on Next
  • Select Local File(s) and click on Next
  • Confirm the settings by clicking on Next
  • Once the site has created click on Next to configure this site now

Configuring The PN Agent Site

Once the site is created it the Wizard will move on to the Site Configuration steps if you ticked the configure this site now option during creation.

To configure a basic PN Agent Site perform the following steps :-

  • Click on Next when prompted with the Welcome screen
  • Under the Specify Server Farm screen configure the Farm Name to the name of the Citrix Farm you will connect to (N.B. The Farm Name does not have to be the actual name of the Citrix Farm being used but helps with continuity)
  • Click on Add and enter the name of at least one Citrix Server or Data Collector in the Farm
  • Configure the Server Port to the XML Port number in use on the Citrix Servers
  • Click on Next and when prompted with the Select Application Typescreen select Remote and click on Next
  • Click on Finish to complete configuring of the Site

Editing The Webinterface.conf File

The actual integration with a Citrix Access Gateway is performed by editing the WebInterface.conf file for the Site and the following steps provide an explanation of this :-

  • Navigate to the Folder containing your new PN Agent Site – E.G. C:\Inetpub\Wwwroot\Citrix\PNAgent
  • Go in to the conf folder and edit the WebInterface.conf file with Notepad
  • Locate the line ClientAddressMap=*,normal and change it to the folowing :-


  • Locate the line # CSG_Server=[IP address or FQDN of the Secure Gateway server] and change it to the following :- – E.G.

N.B. Remember to remove the # from the start of the line to uncomment it

  • Locate the line # CSG_STA_URL1=[URL for the Secure Ticketing Authority] and change it to the following :-


N.B. Remember to remove the # from the start of the line to uncomment it

  • Save and Exit the file

Testing The Implementation

Once the WebInterface.conf has been edited to test the implementation set-up a machine with the PN Agent client on it and when prompted point it to E.G. –

The PN Agent should prompt for logon and once the correct credentials and Domain have been supplied it should then connect you to the PN Agent Site and populate the Published Applications Icons in to the Agent Menu along with any configured to go to the Desktop or Start Menu of the machine.