deepblue/windows-itpro-docs
1
0
Fork 0
mirror of https://github.com/MicrosoftDocs/windows-itpro-docs.git synced 2025-06-18 03:43:39 +00:00
Code Issues Actions 3 Packages Projects Releases Wiki Activity

Adding clarity to content, removed use of 'DO', removed HTML tags

Browse Source
This commit is contained in:
Carmen Forsmann
2021-09-16 14:08:57 -06:00
parent 616afba42f
commit bf1f2ab0cf
2 changed files with 14 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
windows/deployment/update/delivery-optimization-workflow.md
View File

@ -19,21 +19,22 @@ ms.topic: article
## Download Request Workflow
The DO workflow described below allows Delivery Optimization to securely and efficiently deliver requested content to the calling device.
The Delivery Optimization workflow described below allows Delivery Optimization to securely and efficiently deliver requested content to the calling device. Delivery Optimization leverages content metadata to determine all available locations to pull content from, as well as content verification.
* When a download starts, the DO client will attempt to get its content metadata, from the DO service, which is a hash file containing the SHA-256 hash of each piece in the file, typically piece = 1 MB. Separate metadata that is obtained, through an SSL channel, provides DO a way to verify the authenticity of the hash file itself once it is downloaded.
* When DO pulls a certain piece of the hash from another peer, it is verified against the known hash in the hash file.
* If a peer provides an invalid piece, that piece is discarded. A peer that sends multiple bad pieces is banned and will no longer be used as a source by the client performing the download.
* If DO is unable to obtain the hash file, or the verification of the hash file itself fails, the download will fall back to “Simple Mode” (pulling content only from an HTTP source) and peer to peer will not be allowed.
* Once DO is done downloading and puts together the file from all the pieces it got, the caller using DO (ConfigMgr for example) performs yet another check for the entire file as well as verify the signature of it prior to proceeding with installation.
* When a download starts, the Delivery Optimization client will attempt to get its content metadata, from the Delivery Optimization service, via an SSL channel. This content metadata is a hash file containing the SHA-256 block level hashes of each piece in the file (typically one piece = 1 MB). The authenticity of the content metadata file itself is verified prior to any content being downloaded.
* Once the content metadata file is verified, Delivery Optimization proceeds with accessing the requested pieces of the content file.
* When Delivery Optimization pulls a certain piece of the hash from another peer, it is verified against the known hash in the content metadata file.
* If a peer provides an invalid piece, that piece is discarded. When a peer sends multiple bad pieces it is banned and will no longer be used as a source by the Delivery Optimization client performing the download.
* If Delivery Optimization is unable to obtain the content metadata file, or if the verification of the hash file itself fails, the download will fallback to “Simple Mode” (pulling content only from an HTTP source) and peer to peer will not be allowed.
* Once Delivery Optimization downloading is complete, all retrieved pieces of the content are used to put the file together. At that point, the Delivery Optimization caller (e.g. ConfigMgr) performs another check of the entire file to verify the signature, prior to proceeding with installation.
## Delivery Optimization Service Endpoint And Data Information
|Endpoint hostname|Name|Description|Data sent from the computer to the Endpoint (Field/Description)
|----|-----|---------------|-----------------------|
|<ul><li>geover-prod.do.dsp.mp.microsoft.com</li><li>geo-prod.do.dsp.mp.microsoft.com</li><li>geo.prod.do.dsp.mp.microsoft.com</li><li>geover.prod.do.dsp.mp.microsoft.com</li></ul> | Geo | Service used to identify the geo location of the device in order to direct it to the nearest data center. | <ul><li>**Profile**: The device type (ex: PC vs Xbox)</li><li>**doClientVersion**: The version of the DoSvc Client</li><li>**groupID**: Group the device belongs to (set via DownloadMode = '2' (Group download mode) + groupID group policy / MDM policies)</li></ul> |
| <ul><li>kv*-prod.do.dsp.mp.microsoft.com</li><li>kv*.prod.do.dsp.mp.microsoft.com</li>|KeyValue|Bootstrap service, provides endpoints for all other services as well as device configs| <ul><li>**countryCode**: The country the client is connected from</li><li>**doClientVersion**: The version of the DoSvc Client</li><li>**Profile**: The device type (ex: PC vs Xbox)</li><li>**eId**: Client grouping Id</li><li>**CacheHost**: Cache host id<</li></ul> |
| <ul><li>cp*-prod.do.dsp.mp.microsoft.com</li><li>cp*.prod.do.dsp.mp.microsoft.com</li></ul> | Content Policy | Provides content specific policies as well as content metadata URLs | <ul><li>**Profile**: The device type (ex: PC vs Xbox)</li><li>**ContentId**: The content identifier</li><li>**doClientVersion**: The version of the dosvc client</li><li>**countryCode**: The country the client is connected from</li><li>**altCatalogId**: If ContentId isn't available, use the download URL instead</li><li>**eId**: Client grouping Id</li><li>**CacheHost**: Cache host id </li></ul> |
| <ul><li>disc*-prod.do.dsp.mp.microsoft.com</li><li>disc*.prod.do.dsp.mp.microsoft.com</li></ul> | Discovery | Provides the client with the geo-located Array to connect to. (There are two endpoints providing this functionality: /content and /v2/content) | <ul><li>**Profile**: The device type (ex: PC vs Xbox)</li><li>**ContentId**: The content identifier</li><li>**doClientVersion**: The version of the dosvc client</li><li>**partitionId**: Client partitioning hint</li><li>**altCatalogId**: If ContentId isn't available, use the download URL instead</li><li>**eId**: Client grouping Id</li></ul> |
| <ul><li>cn*-prod.do.dsp.mp.microsoft.com</li><li>cn*.prod.do.dsp.mp.microsoft.com</li></ul> | Arrays | Provides the client with list of peers that have the same content and belong to the same peer group. | <ul><li>**Profile**: The device type (ex: PC vs Xbox)</li><li>**ContentId**: The content identifier</li><li>**doClientVersion**: The version of the dosvc client</li><li>**altCatalogId**: If ContentId isn't available, use the download URL instead</li><li>**PeerId**: Identified of the device running DO client</li><li>**ReportedIp**: The internal / private IP Address</li><li>**IsBackground**: Is the download interactive or background</li><li>**Uploaded**: Total bytes uploaded to peers</li><li>**Downloaded**: Total bytes downloaded from peers</li><li>**DownloadedCdn**: Total bytes downloaded from CDN</li><li>**Left**: Bytes left to download</li><li>**Peers Wanted**: Total number of peers wanted</li><li>**Group Id**: Group the device belongs to (set via DownloadMode 2 + Group ID GP / MDM policies)</li><li>**Scope**: The Download mode</li><li>**UploadedBPS**: The upload speed in Bytes per Second</li><li>**DownloadBPS**: The download speed in Bytes per second</li><li>**eId**: Client grouping Id</li></ul> |
| <ul><li>dl.delivery.mp.microsoft.com</li><li>emdl.ws.microsoft.com</li></ul> | | Metadata download can come from different hostnames, however it is required for P2P |
|--------------------------------------------|--------------|---------------|-----------------------|
| geover-prod.do.dsp.mp.microsoft.com <br> geo-prod.do.dsp.mp.microsoft.com <br> geo.prod.do.dsp.mp.microsoft.com <br> geover.prod.do.dsp.mp.microsoft.com | Geo | Service used to identify the geo location of the device in order to direct it to the nearest data center. | **Profile**: The device type (ex: PC vs Xbox) <br> **doClientVersion**: The version of the DoSvc Client <br> **groupID**: Group the device belongs to (set via DownloadMode = '2' (Group download mode) + groupID group policy / MDM policies) |
| kv*-prod.do.dsp.mp.microsoft.com <br> kv*.prod.do.dsp.mp.microsoft.com | KeyValue | Bootstrap service, provides endpoints for all other services as well as device configs | **countryCode**: The country the client is connected from <br> **doClientVersion**: The version of the DoSvc Client <br> **Profile**: The device type (ex: PC vs Xbox) <br> **eId**: Client grouping Id <br> **CacheHost**: Cache host id |
| cp*-prod.do.dsp.mp.microsoft.com <br> cp*.prod.do.dsp.mp.microsoft.com <br> | Content Policy | Provides content specific policies as well as content metadata URLs | **Profile**: The device type (ex: PC vs Xbox) <br> **ContentId**: The content identifier <br> **doClientVersion**: The version of the dosvc client <br> **countryCode**: The country the client is connected from <br> **altCatalogId**: If ContentId isn't available, use the download URL instead <br> **eId**: Client grouping Id <br> **CacheHost**: Cache host id |
| disc*-prod.do.dsp.mp.microsoft.com <br> disc*.prod.do.dsp.mp.microsoft.com | Discovery | Provides the client with the geo-located Array to connect to. (There are two endpoints providing this functionality: /content and /v2/content) | **Profile**: The device type (ex: PC vs Xbox) <br> **ContentId**: The content identifier <br> **doClientVersion**: The version of the dosvc client <br> **partitionId**: Client partitioning hint <br> **altCatalogId**: If ContentId isn't available, use the download URL instead <br> **eId**: Client grouping Id |
| cn*-prod.do.dsp.mp.microsoft.com <br> cn*.prod.do.dsp.mp.microsoft.com | Arrays | Provides the client with list of peers that have the same content and belong to the same peer group. | **Profile**: The device type (ex: PC vs Xbox) <br> **ContentId**: The content identifier <br> **doClientVersion**: The version of the dosvc client <br> **altCatalogId**: If ContentId isn't available, use the download URL instead <br> **PeerId**: Identified of the device running DO client <br> **ReportedIp**: The internal / private IP Address <br> **IsBackground**: Is the download interactive or background <br> **Uploaded**: Total bytes uploaded to peers <br> **Downloaded**: Total bytes downloaded from peers <br> **DownloadedCdn**: Total bytes downloaded from CDN <br> **Left**: Bytes left to download <br> **Peers Wanted**: Total number of peers wanted <br> **Group Id**: Group the device belongs to (set via DownloadMode 2 + Group ID GP / MDM policies) <br> **Scope**: The Download mode <br> **UploadedBPS**: The upload speed in Bytes per Second <br> **DownloadBPS**: The download speed in Bytes per second <br> **eId**: Client grouping Id |
| dl.delivery.mp.microsoft.com <br> emdl.ws.microsoft.com | | Metadata download can come from different hostnames, however it is required for P2P |