Configuring the Device Update Agent Component to Poll a Web Server

  • Article

The Device Update Agent runs as a service on your device. It polls a specified location for updates. You can configure Device Update Agent to poll a Web server or a local media device in Target Designer.

This section describes how to configure DUA to poll a Web server. For information about configuring Device Update Agent to poll a local media device, see Configuring the Device Update Agent Component to Poll a Media Device.

To configure Device Update Agent to poll a Web server

  1. Review your Web server settings, including Web server host name, port, location of the Device Update Program file, and access permissions.

  2. In Target Designer, expand the Device Update Agent component node and choose Settings. The Device Update Agent tab appears in the details pane.

    The following table shows the recommended Device Update Agent component settings to use to poll a Web server.

    Note   You can improve the security of your network by using HTTPS instead of standard HTTP. HTTPS transfers encrypted information between computers by using a Secure Socket Layer (SSL). For more information about configuring HTTPS on your Web server, see your Web server documentation.

    Device Update Agent component setting Description Recommendation
    Service Account:

    Local System | Administrator

    		 Selects the account permissions to use when DUA updates the device. The Administrator Account component must be included in your run-time image if the Administrator service account is selected. Administrator
    Run on Start Configures DUA to poll immediately when the system starts. Selected
    Require HTTP support Selects whether or not Device Update Agent retrieves updates from a remote Web server. Selected
    Poll Interval Selects the interval, in seconds, between polls.  
    Poll Jitter Sets an offset to the Poll Interval. If selected, the poll will occur randomly within the poll interval. Selected
    Working Directory This is a temporary storage directory on the device that DUA uses when it updates a run-time image. C:\DUA
    Poll Time/Day Selects the dates and times that DUA polls for updates.  
    Select Command Path Type

    [Local | Remote using HTTP]

    		 Selects whether to use a local system directory or a remote Web server to poll for updates. Remote using HTTP
    Hostname Hostname or IP address of the Web server. Example:

    Mywebserver.domain.com
    Complete Path to the Command File including Filename and Extension The complete path that DUA polls. Because DUA uses a pull mechanism to retrieve updates, the device update program must be specified. This field must not be left blank. If it is left blank, your run-time image will not build. Example:

    /updates/commands.dup

    The following table shows the recommended configurations to use in Advanced Settings.

    Device Update Agent component setting Description Recommendation
    HTTP | HTTPS Selects whether to use HTTP or Secure HTTP (HTTPS). HTTPS
    Host Port Selects the server port to poll. For HTTP, the default port is 80, for HTTPS, the default port is 443. 443
    Proxy access type Unspecified: Proxy name.

    0: Default proxy. Retrieves proxy information from registry.

    1: No proxy. All host names are resolved locally.

    3: Named proxy. Passes all requests to the proxy server unless it is included in the bypass list.

    		 Optional
    Proxy Name Name of the proxy server to use when polling. Optional
    Proxy Bypass List Host names or IP addresses that should bypass the proxy. Optional
    Protocol Version HTTP protocol version, defaults to HTTP 1.1. HTTP 1.1
    Protocol Accept Type Media types that the HTTP client can accept, for example, text/*. Unspecified (accept all types)

    The following table shows the recommended configurations to use in Security Settings.

    Device Update Agent component setting Description Recommendation
    Autologon Level 0: Medium. Use default credentials for intranet requests only.

    1: Low. Use default credentials for all requests. Default behavior if a value is not specified.

    2: High. Never use default credentials.

    		 2
    User Name User name for host. <username>
    Password Password for host. <password>

    When you use HTTPS, it is recommended that you assign DUA a specific username and password on the server. This can be a new account specific to DUA, or an existing account. When you assign a username and password to DUA, verify that the account exists on the server and that it has the appropriate access permissions to the update files. For more information, see Configuring IIS to Serve the Device Update Program.

    For more information about the registry settings set by DUA, see DUA Registry Settings.

See Also

Device Update Agent | How to Configure DUA to Poll a Web Server | How to Configure DUA to Poll a Media Device

Last updated on Wednesday, October 18, 2006

© 2006 Microsoft Corporation. All rights reserved.