Understanding the %SFT_SOFTGRIDSERVER% environmental variable in Microsoft App-V

KBHere’s a new App-V Knowledge Base article we published today.  This one covers the %SFT_SOFTGRIDSERVER% environmental variable:

=====

Symptoms

After modifying the %SFT_SOFTGRIDSERVER% environment variable, Microsoft Application Virtualization (App-V) packages may fail to load or may connect to an incorrect server. In some cases, you may receive a 0A-10000002 error ("The specified Application Virtualization Server could not be accessed. Try again in a few minutes. If the problem persists, report the following error code to your System Administrator") if the system variable references a non-existent or inaccessible server.

This is most common in scenarios where the intent is to test packages located on a development server with the intention of later copying the package to the production environment. In this case, changes to either the user or system environmental variable %SFT_SOFTGRIDSERVER% will not be used by the App-V client.

In the case of user variables (that is, adding a variable called SFT_SOFTGRIDSERVER under Control Panel\System\Advanced System Settings\Advanced tab\Environmental Variables...\User variables for username), App-V does not read the %SFT_SOFTGRIDSERVER% for individual users. Only the system variable is honored.

In the case of system variables, this setting is only reflected after a system reboot. This is necessary for the App-V client services and drivers to properly and consistently read these variables. Any changes made to the %SFT_SOFTGRIDSERVER% variable are not reflected until either the Application Virtualization client service is restarted or the client operating system is rebooted.

Cause

This behavior is by design.

Resolution

There are several possible workarounds to enable this scenario:

  1. Change the system %SFT_SOFTGRIDSERVER% environmental variable and then either restart the Application Virtualization Client service or reboot the client (in most cases restarting the service is sufficient; if this does not resolve the issue, you may need to restart the client). This is obviously the easiest method, but may not be desirable in some environments (for instance on, on a heavily-utilized Terminal Server).
  2. Edit the OSD directly and replace the %SFT_SOFTGRIDSERVER% variable with the actual name of the development server, or use another variable.
  3. Use an alternate application source root (ASR) (https://technet.microsoft.com/en-us/library/cc843817.aspx).
  4. Use two separate versions of the application for testing.
More Information

User environmental variables override system environmental variables in Windows. Executables (including services and drivers) read environmental variables when they first launch, but do not subsequently re-read values.

=====

For the most current information please see the following KB:

KB2552111 - Understanding the %SFT_SOFTGRIDSERVER% environmental variable in Microsoft App-V

J.C. Hornbeck | System Center Knowledge Engineer

The App-V Team blog: https://blogs.technet.com/appv/
The WSUS Support Team blog: https://blogs.technet.com/sus/
The SCMDM Support Team blog: https://blogs.technet.com/mdm/
The ConfigMgr Support Team blog: https://blogs.technet.com/configurationmgr/
The SCOM 2007 Support Team blog: https://blogs.technet.com/operationsmgr/
The SCVMM Team blog: https://blogs.technet.com/scvmm/
The MED-V Team blog: https://blogs.technet.com/medv/
The DPM Team blog: https://blogs.technet.com/dpm/
The OOB Support Team blog: https://blogs.technet.com/oob/
The Opalis Team blog: https://blogs.technet.com/opalis
The Service Manager Team blog: http: https://blogs.technet.com/b/servicemanager
The AVIcode Team blog: http: https://blogs.technet.com/b/avicode
The System Center Essentials Team blog: http: https://blogs.technet.com/b/systemcenteressentials
The Server App-V Team blog: http: https://blogs.technet.com/b/serverappv

clip_image001 clip_image002