add nohash prefetch item

Clients and relays collect files by action ID and ordinal number identifying the exact file to use, rather than any file provided by the URL. SHA1 or SHA256 hash algorithm are not allowed with this prefetch command.

This command adds a download item to the prefetch queue. It must reside between a begin prefetch block and an end prefetch block command. This is a singular command and it can only specify a single download at a time. Relevance substitution is not allowed with the arguments of this command, permitting the IBM BigFix Server to cache the download when the action is created. If the Client requests any ordinal files, the relay will collect them all. The client downloads the item only if this command is in a TRUE condition block.

Syntax

add nohash prefetch item [name=<n>] [size=<s>] url=<u>

Where:

<n>

Is an optional name, limited to 32 characters (including alphanumeric, dashes, underlines and non-leading periods). If no name is explicitly specified, the name will be derived from the final component of the URL (following the final slash). Only one download item can be specified per command.

<s>

Is an optional file size. Although it is not required, when it is known and specified, the program can provide meaningful progress information.

<u>

Is a required url. If the name is not specified, then it will be derived from final component of the supplied URL.

The arguments may be in any order desired, but unrecognized commands generate a syntax error.

Example

begin prefetch block 
      add nohash prefetch item url=http://www.mysite/downloads/download25.exe
end prefetch block
wait {download path "download25.exe"}

This example uses a static download in a prefetch block and retrieves it without a hash. This technique is intrinsically insecure, but it uses a white-list on the IBM BigFix Server to validate the URL.

Version 7.2 and above