Share via


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