windows-itpro-docs/mdop/appv-v4/how-to-configure-the-client-for-application-package-retrieval.md
Nicholas Brower 1ae3f0b230 Merged PR 4822: "msdate update (generated from most recent commit date)"
"msdate update (generated from most recent commit date)"
2017-12-05 22:36:05 +00:00

8.3 KiB
Raw Blame History

title, description, author, ms.assetid, ms.pagetype, ms.mktglfcycl, ms.sitesec, ms.prod, ms.date
title description author ms.assetid ms.pagetype ms.mktglfcycl ms.sitesec ms.prod ms.date
How to Configure the Client for Application Package Retrieval How to Configure the Client for Application Package Retrieval jamiejdt 891f2739-da7a-46da-b452-b8c0af075525 mdop, appcompat, virtualization deploy library w8 06/16/2016

How to Configure the Client for Application Package Retrieval

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.

Note  

  • 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 users 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.

    Important   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/

How to Configure the App-V Client Registry Settings by Using the Command Line