How to Configure Client Detection and Deployment on Citrix Web Interface for NetScaler

Edit: Updated this post for deployment using the new Citrix Receiver for Windows 3.0 and Citrix Receiver for Mac 11.4

When you are here after searching the web you have probably found out that the Web interface for NetScaler doesn’t nicely deploy (push) the Citrix client as you are used to from Citrix Web Interface for Windows. Here I am going to explain how you can deploy the Citrix Client from Web interface for NetScaler. At least for Windows and Mac. This blog post was based on a document I got from Andrew Sandford, tech support Citrix Systems Ireland. They are working on an official KB article to address this problem. In the mean time I hope this can help some people out.

1. Use WinSCP (or puTTY if you feel comfortable using commandline and tools like vi) to enter the Citrix NetScaler;

2. Go to you Citrix Web Interface directory, in my example I use /Citrix/XenApp, the default first site on Citrix NetScaler: /var/wi/tomcat/webapps/Citrix/XenApp;

3. Create a Clients directory within the XenApp folder ( #mkdir Clients within the Linux shell)
Under the newly created Clients directory create the following directories:
Windows (#mkdir Windows within the Linux shell)
Mac ( #mkdir Mac within the Linux shell)
Under Windows create the following directories:
Online plug-in (#mkdir “Online plug-in” within the Linux shell, quote or you will get 2 directories)
Offline plug-in (#mkdir “Offline plug-in” within the Linux shell, quote or you will get 2 directories)

4. Download the latest Citrix Web clients from the Citrix website.

5. Copy the downloaded CitrixReceiver.exe file with WinSCP to: /var/wi/tomcat/webapps/Citrix/XenApp/Clients/Windows/Online plug-in/
Copy the downloaded CitrixOfflinePlugin.exe file with WinSCP to: /var/wi/tomcat/webapps/Citrix/XenApp/Clients/Windows/Offline plug-in/
Copy the downloaded CitrixReceiver_11.4.dmg file with WinSCP to: /var/wi/tomcat/webapps/Citrix/XenApp/Clients/Mac/

6. Uncomment and edit the following line in /var/wi/tomcat/webapps/Citrix/XenApp/WEB-INF/WebInterface.conf:
# ClientIcaLinuxX86=Filename:linuxx86-11.0.140395.tar.gz,Directory:Linux,Mui:Yes,Version:11.0
ClientIcaMac=Filename: CitrixReceiver_11.4.dmg,Directory:Mac,Mui:Yes
# ClientIcaSolarisSparc=Filename:solaris.tar.Z,Directory:Unix,Mui:No,Version:8.59
# ClientIcaSolarisX86=Filename:solx86.tar.Z,Directory:Unix,Mui:No,Version:8.5


7. Enable autodetect by uncommenting and editing the following /var/wi/tomcat/webapps/Citrix/XenApp/WEB-INF/WebInterface.conf line:

8. Restart the Java Webserver by entering the following Linux command:
#killall java
It will take about 30 seconds for the webserver to be up and running again, if you are impatient (like me Smile) you can monitor if the java webserver has started again by entering the following command:
#ps aux | grep java

Depending on the browser being used and existing policies it should be possible that the url has to be added to the Trusted Sites within Internet Explorer. With Internet Explorer 9 you will have to add the url anyway or users will get the download ICA file notifications when trying to start Citrix published applications.


The new Citrix Receiver for Windows 3.0:

Citrix Receiver 3.0-1



About Henny Louwers
I work as a Consultant specialized in Application Delivery, Virtualization of Servers, Desktops and Apps.

6 Responses to How to Configure Client Detection and Deployment on Citrix Web Interface for NetScaler

  1. Jarl Nelson says:

    Thank you for this excellent information! I am having one issue after following all of your instructions. Even after adding the URL to the Trusted Sites list on the client browser (IE8 on Windows XP), the “Look for an information bar” message you displayed above still appears and blocks the user from clicking on the big “INSTALL” button, so the web plug-in is never installed.


  2. Jarl Nelson says:

    I did some additional troubleshooting this morning. I am not sure why Citrix put in step #7 in your instructions, but when I took out that step I am now able to successfully load the Online plug-in. The issue seems to be that with step #7 in place, users are never able to click the checkbox stating “I agree with the Citrix license agreement”. When I removed step 7 from the mix, I am able to see portion of the screen where I can check the appropriate box after which time the installation proceeds successfully.


    • Thanks for the feedback Jarl! Will test it as soon as I have the chance and remove it if I’m seeing the same result.


  3. Andrew Sandford says:

    To restart java on NetScaler:

    #killall java

    The daemon will detect the server has gone down in about 60 seconds and restart it automatically.


    • Great, thanks for the update Andrew!


  4. Ran into your website today. Thanks for sharing, saves me some time figuring it all out!


%d bloggers like this: