Product Documentation

Deploy plug-ins on windows systems

The WANOP Client Plug-in is an executable Microsoft installer (MSI) file that you download and install as with any other web-distributed program. Obtain this file from the MyCitrix section of the Citrix.com website.

Note: The WANOP Client Plug-in user interface refers to itself as “Citrix Acceleration Plug-in Manager.”

The only user configuration needed by the plug-in is the list of appliance addresses. This list can consist of a comma-separated list of IP or DNS address. The two forms can be mixed. You can customize the distribution file so that the list points to your appliance by default. Once installed, operation is transparent. Traffic to accelerated subnets is sent through an appropriate appliance, and all other traffic is sent directly to the server. The user application is unaware that any of this is happening.

Installation

To install WANOP Client Plug-in Plug-in accelerator on Windows system:

  1. The Repeater*.msi file is an installation file. Close all applications and any windows that might be open, and then launch the installer it in the usual way (double-click on in a file window, or use the run command).

    Figure 1. Initial Installation Screen:

    localized image

    The steps below are for an interactive installation. A silent installation can be performed with the command:

    msiexec /i client_msi_file /qn

  2. The installation program prompts for the location in which to install the software. The directory that you specify is used for both the client software and the disk-based compression history. Together, they require a minimum of 500 MB of disk space.

  3. When the installer finishes, it might ask you to restart the system. After a restart, the WANOP Client Plug-in Plug-in starts automatically.

    Figure 2. Final Installation Screen

    localized image

  4. Right-click the Accelerator icon in the task bar and select Manage Acceleration to launch the Citrix Plug-in Accelerator Manager.

    Figure 3. Citrix Accelerator Plug in Manager, Initial (Basic) Display

    localized image

  5. If the .MSI file has not been customized for your users, specify the signaling address and the amount of disk space to use for compression:

    • In the Appliances: Signaling Addresses field, type the signaling IP address of your appliance. If you have more than one Plug-in-enabled appliance, list them all, separated by commas. Either IP or DNS addresses are acceptable.

    • Using the Data Cache slider, select the amount of disk space to use for compression. More is better. 7.5 GB is not too much, if you have that much disk space available.

    • Press Apply.

      The WANOP Client Plug-in accelerator is now running. All future connections to accelerated subnets will be accelerated

      On the plug-in’s Advanced Rules tab, the Acceleration Rules list should show each appliance as Connected and each appliance’s accelerated subnets as Accelerated. If not, check the Signaling Addresses IP field and your network connectivity in general.

Troubleshoot plug-ins

Plug-in installation generally goes smoothly. If not, check for the following issues:

Common problems:

  • If you do not reboot the system, the WANOP Client Plug-in will not run properly.

  • A highly fragmented disk can result in poor compression performance.

  • A failure of acceleration (no accelerated connections listed on the Diagnostics tab) usually indicates that something is preventing communication with the appliance. Check the Configuration: Acceleration Rules listing on the plug-in to make sure that the appliance is being contacted successfully and that the target address is included in one of the acceleration rules. Typical causes of connection failures are:

    • The appliance is not running, or acceleration has been disabled.

    • A firewall is stripping WANOP Client Plug-in TCP options at some point between the plug-in and appliance.

    • The plug-in is using an unsupported VPN.

Deterministic network enhancer locking error

On rare occasions, after you install the plug-in and restart your computer, the following error message appears twice:

Deterministic Network Enhancer installation requires a reboot first, to free locked resources. Please run this install again after restarting the computer.

If this occurs, do the following:

  1. Go to Add/Remove Programs and remove the WANOP Client Plug-in, if present.

  2. Go to Control Panel > Network Adapters > Local Area Connection > Properties, find the entry for Deterministic Network Enhancer, clear its check box, and click OK. (Your network adapter might be called by a name other than “Local Area Connection.”)

  3. Open a command window and go to c:\windows\inf (or the equivalent directory if you have installed Windows in a non-standard location).

  4. Type the following command:

    find “dne2000.cat” oem*.inf

  5. Find the highest-numbered oem*.inf file that returned a matching line (the matching line is CatalogFile= dne2000.cat) and edit it. For example:

    notepad oem13.inf

  6. Delete everything except the three lines at the top that start with semicolons, and then save the file. This will clear out any inappropriate or obsolete settings and the next installation will use default values.

  7. Retry the installation.

Other installation problems

Any problem with installing the WANOP Client Plug-in is usually the result of existing networking, firewall, or antivirus software interfering with the installation. Usually, once the installation is complete, there are no further problems.

If the installation fails, try the following steps:

  1. Make sure the plug-in installation file has been copied to your local system.

  2. Disconnect any active VPN/remote networking clients.

  3. Disable any firewall and antivirus software temporarily.

  4. If some of this is difficult, do what you can.

  5. Reinstall the WANOP Client Plug-in.

  6. If this doesn’t work, reboot the system and try again.

Deploy plug-ins on windows systems