hpcpack download
Applies To: Microsoft HPC Pack 2012, Microsoft HPC Pack 2012 R2
Downloads a package or file from a Windows Azure storage account. You can specify an account by using the node template name, the head node and node template name, or the Windows Azure storage account name and its storage key or Shared Access Signature (SAS) token. By default, files and packages are downloaded from a container named hpcpackages in the storage account.
Note
This subcommand was introduced in HPC Pack 2008 R2 with Service Pack 1 (SP1) and is not supported in previous versions.
Syntax
hpcpack download <packageName> /nodetemplate:<nodeTemplateName>
[/container:<containerName>] [/path:<targetPath>] [/blocksize:<blockSize>]
[/unpack] [/usehttp]
hpcpack download <packageName> /scheduler:<headNodeName>
/nodetemplate:<nodeTemplateName> [/container:<containerName>]
[/path:<targetPath>] [/blocksize:<blockSize>] [/unpack] [/usehttp]
hpcpack download <packageName> /account:<storageAccountName> (/key:<storageKey>|/sas:<sasToken>)
[/container:<containerName>] [/path:<targetPath>] [/blocksize:<blockSize>]
[/unpack] [/usehttp]
hpcpack download {/? | /help}
Parameters
Parameter |
Description |
|---|---|
<packageName> |
Specifies the package or file that you want to download. |
/nodetemplate |
Specifies a Windows Azure node template. hpcpack uses the Windows Azure account name and storage key that is associated with the node template. |
/sas |
Specifies a Shared Access Signature (SAS) token. Note This parameter was introduced in Microsoft® HPC Pack 2012 and is not supported in previous versions. |
/scheduler |
Specifies the head node of the cluster. You can use this parameter along with the /nodetemplate parameter if there is no default head node specified on your computer. |
/account |
Specifies the public name of the Windows Azure storage account (the same storage name that you specify in the Windows Azure Node Template). This is the value of <storageAccountName> in the public URL of the account: https:// <StorageAccountName>.blob.core.windows.net. If you specify /account, you must also specify /key. |
/key |
Specifies the access key for the Windows Azure storage account. If you specify /key, you must also specify /account. |
/container |
Specifies the name of the container in the Windows Azure storage account that you want to download the file from. If you do not specify this parameter, files and packages are downloaded from default location: a container named hpcpackages in the storage account. |
/targetPath |
Specifies where you want to save the downloaded files. By default files are downloaded to the current directory. Path can be relative to the current directory, or an absolute path. For example: C:\AzurePackages\myPackage.zip. |
/blocksize |
Specifies the size of the block, in bytes, that the file will be separated into when downloading. The default block size is 4 MB (4194304 bytes). 4 MB is also the maximum block size. You might want to specify a smaller block size if you are experiencing an unstable network connection. |
/unpack |
Specifies that you want hpcpack to extract the zipped files after downloading. This is particularly useful if you are downloading files to Windows Azure nodes, so that you do not need to install unzipping tools on the nodes. Note hpcpack download can only extract zipped files that are created by hpcpack create, not zipped files that are created by other tools. |
/usehttp |
Specifies that you want to override the default https channel over port 443 and force the communication to http over port 80. Note This parameter was introduced in HPC Pack 2008 R2 with Service Pack 3 (SP3) and is not supported in previous versions. |
/? |
Displays Help at the command prompt. |
/help |
Displays Help at the command prompt. |
Examples
To download myPackage.zip from the default storage container to C:\myFiles on the local computer.
HpcPack download myPackage.zip /scheduler:headnode /nodetemplate:"nodetemplate name" /path:c:\myFiles
To download myData.zip from a storage container named myInputData and save the file, already unzipped, to the E:\approot folder (you can run this from a Windows Azure Node to prefetch data for a job).
HpcPack download myData.zip /account:accountName /key:storageKey /container:myInputData /blocksize:<blocksize> /path:e:approot\myInputData /unpack