Export (0) Print
Expand All

How to Configure the Client for Application Package Retrieval

Updated: December 4, 2009

Applies To: Application Virtualization

When the client is configured with an Application Virtualization (App-V) Management Server as its publishing server, by default at the next publishing refresh cycle, the client retrieves from the server the Open Software Descriptor (OSD) and package manifest files for each package that the user is authorized to use. The client uses the package source information that is defined in these files to determine where to find the package content, icons, and file type associations.

If you want the client to obtain the package content (SFT file) from a local App-V Streaming Server or other alternate source such as a Web server or file server, instead of from the App-V Management Server, you can configure the ApplicationSourceRoot registry key value on the computer to point to the local content share on the other server. The OSD file still defines the original source path for the package content. However the client uses the value of the ApplicationSourceRoot setting in place of the server and share that are specified in the content path in the OSD file. This redirects the client to retrieve the content from the other server.

You can also configure the OSDSourceRoot and IconSourceRoot registry key values if you want to override those settings in the package manifest file or in the paths sent by a publishing server. The OSDSourceRoot specifies a source location for OSD file retrieval for an application package during publication. The IconSourceRoot specifies a source location for icon retrieval for an application package during publication.

noteNote
  • The IconSourceRoot and OSDSourceRoot settings override the values in the package manifest file, so if you try to deploy a package by using the Windows Installer (.msi) file method, it will also override the values in the package manifest file that is contained within that .msi file.

  • During both the publishing and HTTP(S) streaming operations,App-V 4.5 SP1 clients use the proxy server settings that are configured in Internet Explorer on the user’s computer.

To configure the ApplicationSourceRoot registry key value

  • Configure the ApplicationSourceRoot in the following registry key value with either a UNC path or a URL:

    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SoftGrid\4.5\Client\Configuration\ApplicationSourceRoot

    The correct format for the Universal Naming Convention (UNC) path is \\computername\sharefolder\[folder][\] , where folder is optional. The computername can be a Fully Qualified Domain Name (FQDN) or an IP address, and sharefolder can be a drive letter. Only the \\computername\sharedfolder or drive letter portion of the OSD path is replaced.

    The correct format for the URL path is protocol://servername:[port][/path][/] , where port and path are optional. If port is not specified, the default port for the protocol is used. Only the protocol://server:port portion of the OSD URL is replaced.

    ImportantImportant
    Environment variables are not supported in the ApplicationSourceRoot definition.

    The following table lists examples of acceptable URL and UNC path formats.

     

    ApplicationSourceRoot OSD File HREF Path Result Comments

    rtsps://mainserver:322

    rtsp://appserver/productivity/office2k3.sft?customer=seq

    rtsps://mainserver:322/productivity/office2k3.sft?customer=seq

    rtsps://mainserver:322/prodapps

    rtsp://appserver/productivity/office2k3.sft?customer=seq

    rtsps://mainserver:322/prodapps/productivity/office2k3.sft?customer=seq

    https://mainserver:443/prodapps

    rtsp://appserver/productivity/office2k3.sft?customer=seq

    https://mainserver:443/prodapps/productivity/office2k3.sft?customer=seq

    rtsps://mainserver:322/prodapps

    rtsp://%SFT_APPVSERVER%:554/productivity/office2k3.sft?customer=seq

    rtsps://mainserver:322/prodapps/productivity/office2k3.sft?customer=seq

    rtsps://mainserver:322

    \\uncserver\share\productivity\office2k3.sft

    rtsps://mainserver:322/productivity/office2k3.sft

    ‘\’ converted to ‘/’

    rtsps://mainserver:322

    file://\\uncserver\share\productivity\office2k3.sft

    rtsps://mainserver:322/productivity/office2k3.sft

    ‘\’ converted to ‘/’

    \\uncserver\share

    rtsp://appserver/productivity/office2k3.sft?customer=seq

    \\uncserver\share\productivity\office2k3.sft

    ‘/’ converted to ‘\’ and parameter dropped when converting to UNC path

    \\uncserver\share\prodapps

    rtsp://appserver/productivity/office2k3.sft?customer=seq

    \\uncserver\share\prodapps\productivity\office2k3.sft

    ‘/’ converted to ‘\’ and parameter dropped when converting to UNC path

    M:

    \\uncserver\share\productivity\office2k3.sft

    M:\productivity\office2k3.sft

    M:\prodapps

    \\uncserver\share\productivity\office2k3.sft

    M:\prodapps\productivity\office2k3.sft

To configure the OSDSourceRoot value

  • Configure the OSDSourceRoot in the following registry key value with either a UNC path or a URL:

    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SoftGrid\4.5\Client\Configuration\OSDSourceRoot

    Acceptable formats for the OSDSourceRoot include UNC paths and URLs, as in the following example:

    \\computername\sharefolder\resource or \\computername\content or <drive>:\foldername

    http://computername/productivity/ or https://computername/productivity/

To configure the IconSourceRoot value

  • Configure the IconSourceRoot in the following registry key value with either a UNC path or a URL:

    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SoftGrid\4.5\Client\Configuration\IconSourceRoot

    Acceptable formats for the IconSourceRoot include UNC paths and URLs, as in the following example:

    \\computername\sharefolder\resource or \\computername\content or <drive>:\foldername

    http://computername/productivity/ or https://computername/productivity/

See Also

-----
You can learn more about MDOP in the TechNet Library, search for troubleshooting on the TechNet Wiki, or follow us on Facebook or Twitter.
-----
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft