How to Configure the Citrix Program Neighborhood Agent

Citrix Program Neighborhood Agent is the client tool for LAN Connected infrastructure, as it provides the most features and centralized management.

Citrix Program Neighborhood Agent (PNA) consists of a server and client component. It is integrated in the Citrix Web Interface setup. The PNA Client is a part of the Citrix Presentation Server Client Packager. The PNA client provides centralized management of the client settings via the Access Management Console and Published Application settings.  PNA also offers pass-through authentication, automatic desktop and start menu integration, as well as client to server content redirection.

Citrix Program Neighborhood Agent will not be configured in the Citrix Server by default. We need to configure to get the config.xml file installed and copied to IIS.

After installing Web Interface, launch the Access Management Console (AMC). The Configure and run discovery invoke at the first time to identify the components.

Select the option, “Contact the following servers running the configuration service” and add the server running Web Interface.

After the discovery process completes, right click on the Web Interface node on the left pane of the AMC -> Select “Create Site”.

Select “Program Neighborhood Agent Services site”.

Select the default options for the remaining process of the Create Site Wizard.

Right click on the site and select “Manage server farms”.

On this screen, the default farm will be displayed. Enter at least one of the Citrix servers from the Citrix Farm with which the Program Neighborhood Agent Services site will communicate. The site communicates with the XML Service on the configured Citrix Server via the Farm XML Port (80 is the default). Refer to the Citrix Server Farm Properties in the Presentation Server Console if unsure what port number to enter. Best practice would be to enter at least two XML Servers for redundancy in case of failure

In the AM Console, right click config.xml, select “Configure authentication methods”.

Deselect “Prompt” and select “Pass-through. That means the credentials used on the local system will be used to logon to the Citrix Farm.

In the Change Session Options screen, one may customize the Client Session Sizes, Client Resources (color depth, Windows Keyboard Settings and Audio Settings), and Workspace Control Options.

In the Manage Server Settings screen, we can configure the automatic refresh frequency, Backup URLs, and Site Redirection, where an administrator can redirect users to an alternate site.

For a centrally managed installation, on the Start Menu Shortcuts, and Desktop Shortcuts screens, select “Use Server Farm Settings (defined in published application)”. This means that the location of the application shortcuts will be determined by Citrix Published Application, not by settings in the PNA Services Site.

On the Notification Area screen, the administrator can configure display of applications as a menu in the Citrix Program Neighborhood Connection Center and can control user enabling or disabling the Applications Menu display in the Citrix Program Neighborhood Connection Center.

On the Shortcut Removal Screen, the administrator can configure when a user’s Citrix Published Application Shortcuts are removed from the desktop and start menu.

Right click on the config.xml go to All Tasks, Manage Application Refresh. We can control more over when and how often a user’s application set is refreshed.

In a domain the PNA Client automatically passes-through the local credentials, so users can access Citrix Published Applications as if they were installed locally.

Published Application Configuration

Published applications have the following settings related to the Program Neighborhood Client.

Shortcut Presentation -> Application Shortcut Placement:

             Add to the Client’s Start Menu.

             Place under the Program Folder.

             Start Menu Folder

             Add shortcut to the client’s desktop.


Content Redirection allows a local client files to launch Citrix Published Applications installed in the Citrix server.


About Murugan B Iyyappan

Working as a Consultant - Citrix solutions architect with 18 years of experience in the IT industry. Expertise in Citrix products and Windows platform.
This entry was posted in Citrix XenApp and tagged , , . Bookmark the permalink.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s