Citrix states in their article: CTX101483

CTX101483 - Error: The ICA Client is needed for this utility and is not installed or Shadowing is grayed out in the Citirx Management Console

This document was published at: http://support.citrix.com/kb/entry.jspa?externalID=CTX101483

Document ID: CTX101483, Created on: Feb 25, 2003, Updated: Feb 9, 2004

Products: Citrix MetaFrame XP 1.0 for Microsoft Windows 2000, Citrix MetaFrame XP 1.0 for Microsoft NT 4.0 Server Terminal Server Edition, Citrix MetaFrame XP 1.0 for Microsoft Windows 2003, Citrix MetaFrame 1.8 for Microsoft Windows 2000, Citrix MetaFrame 1.8 for Microsoft NT 4.0 Server Terminal Server Edition

Symptom

After upgrading the ICA Client on the MetaFrame server to Version 7.0, the following error message appears when using the shadow taskbar:

“The ICA Client is needed for this utility and is not installed. Do you wish to install it now?”

Selecting yes results in the following error message:

“Cannot find the setup program for the ICA client. Please reinstall the ICA Client and run the application again.”

The Citrix Management Console option to shadow may be grayed out.

After configuring users to shadow, ensure the workstation or server has the ICA Win32 Client installed.

See the readme for Hotfix XE102W076 or it’s equivalent and Troubleshooting and Explaining Citrix ICA Shadowing for additional information.

Cause

Upgrading or clean installations using the 7.00 ICA Client Ica32.msi file seems to be the culprit. Upgrading or clean installations of the client using Ica32.exe appears to be fine. The problem also occurs with Ica32a.msi, PNAgent.

Using 3rd Party utilities, filemon and regmon, from SysInternals, MetaFrame is looking for Wfica32.exe in an incorrect directory like the following:

250 2:33:23 PM wshadow.exe:3104 OPEN Q:\Documents and Settings\jConaty1\"q:\program files\citrix\system32\ica passthrough\ NAME INVALID

On the good log, it looks like the following:

250 2:51:41 PM wshadow.exe:3304 OPEN Q:\progra~1\citrix\system32\icapas~1\ SUCCESS Options: Open Directory Access: All

251 2:51:41 PM wshadow.exe:3304 DIRECTORY Q:\progra~1\citrix\system32\icapas~1\ SUCCESS FileBothDirectoryInformation: wfica32.exe

Changing the user profile user environment variable to Q:\ works.

Resolution

There are three possible resolutions:

1. Reinstall the ICA Client.

For issues occurring with Feature Release 2, reinstall using ica32.exe.

For issues occurring with Feature Release 3, reinstall using ica32.msi.

2. As an administrator, unregister and reregister wfica from a command prompt:

"[installpath]wfica32.exe" /regserver

where [installpath] is the installed location of wfica32.exe

For example:

C:\Program Files\Citrix\ICA Client>wfica32.exe /unregserver

C:\Program Files\Citrix\ICA Client>wfica32.exe /regserver

This re-registers wfica32.exe with a short-path notation so that it can communicate with pre-Service Pack 3 MetaFrame servers.

3. Use the registry editor to modify the default string value to the exact path of the wfica.exe file as follows

WARNING! This fix requires you to edit the registry. Using Registry Editor incorrectly can cause serious problems that may require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk.

[HKEY_CLASSES_ROOT\WinFrameICA\shell\open\command]

@="C:\Program Files\Citrix\ICA Client\wfica32.exe" "%1"

To launch the Shadow Toolbar, Feature Release 2 needs the short path (drive:\PROGRA~1\Citrix\ICACLI~1\wfica32.exe "%1").

Feature Release 3 needs the long path ("drive:\Program Files\Citrix\ICA Client\wfica32.exe" "%1").

4. You can deploy a simple batch file using Installation Manager that re-registers Wfica32.exe; for example, use the command "[installpath]wfica32.exe" /regserver, where [installpath] is the location where Wfica32.exe is installed — usually c:\program files\citrix\ica client. This re-registers Wfica32.exe with a short-path notation.