• Windows

• PuTTY or equivalent SSH client on Windows

• vi or equivalent Text Editor

• NetScaler software release 9.2 nCore version on an enhancement build or NetScaler software release 9.3 nCore based

Background

When a client connects to a Web Interface site on a NetScaler appliance using ICA proxy mode, there is a client detection process which detects the presence of either the Web or full Receiver Client on the client. Generally, the Web client is usually deployed because the Web client is a small file. The full client formerly known as PNAgent or Program Neighbourhood, is usually used internally on a network for Services sites. Therefore, the full client is typically deployed using the Active Directory Group Policy or software deployment software.

The client detection process uses an Active-X Browser Helper Object as well as a Pop-up to detect and deploy the client. A NetScaler appliance uses a pop-up Window in the Web browser. If you are using Internet Explorer, then you must add the URL to the Trusted Sites and in some scenarios the Local Intranet. The decision to use either the Trusted Sites or Local Intranet zone is dependent on whether the local security policies applied to the Internet Explorer browser is local or by using Group Policy. The security settings vary with different versions of Internet Explorer.

By default, the Web Interface integrated on a NetScaler appliance does not include the functionality to automatically deploy client software.

When you create a Web Interface site on the appliance, you must specify a Site Path. The default location is /Citrix/XenApp.

1. Run the following command to switch to the shell prompt on the NetScaler appliance:
   shell

2. Run the following command to open the site path:
   cd /var/wi/tomcat/webapps/Citrix/AG
   Note: /Citrix/AG is a sample Site Path.

3. If the Clients directory does not exist, run the following command to create it:
   # mkdir Clients

4. Run the following commands to create the directories within the Clients directory:
   cd Clients/
   mkdir Windows
   mkdir Mac
   cd Windows/
   mkdir "Offline plug-in"
   mkdir "Online plug-in"

5. Use the most current version of the plug-ins downloaded from the Citrix Web site.

6. Copy the CitrixOnlinePluginWeb.exe file to the Online plug-in directory.

7. Copy CitrixOfflinePlugin.exe to the Offline plug-in directory.

8. If necessary download the Mac client as well and copy it to the Mac directory.
   Note: You can retrieve the clients from the XenApp 5/6 CD, but it is recommended to download the latest versions. Note that these are not CitrixOnlinePluginFull.exe and CitrixOfflinePluginFull.exe.

9. Run the following commands to edit the WebInterface.conf file:
   # cd /var/wi/tomcat/webapps/Citrix/AG/WEB-INF/
   # vi WebInterface.conf

10. Update the WebInterface.conf file with the following changes that are in boldface in the following example:
    #ClientIcaLinuxX86=Filename:linuxx86-11.0.140395.tar.gz,Directory:Linux,Mui:Yes,Version:11.0
    ClientIcaMac=Filename: CitrixOnlinePlugin_web11_2.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
    ClientIcaWin32=Filename:CitrixOnlinePluginWeb.exe,Directory:Windows,Mui:Yes,ClassID:238f6f83-b8b4-11cf-8771-00a024541ee3
    ClientStreamingWin32=Filename:CitrixOfflinePlugin.exe,Directory:Windows,Mui:Yes,ClassID:4384F3C5-4A9E-4E81-9AAE-4251C2813861

11. To enable automatic upgrade of the plug-ins find the following section in the WebInterface.conf file and remove comments and change Off to On:
    UpgradeClientsAtLogin=On

12. This is an optional step. If you require the download to start instantaneously then you must modify the following file:
    /var/wi/tomcat/webapps/Citrix/AG/WEB-INF/clientDetection/clientscripts/downloadClientPage.js

    Update the downloadClientPage.js file with the following changes that are in bold:

    function onLoadLayout() {
    <% // properly display the download button if high contrast mode is enabled. %>
    maintainAccessibility("DownloadButton");
    startDownload();
    }

13. Run the following command to restart the Apache Tomcat Java server, the server then restarts within 30 seconds:
    killall java