hpcfile get

Downloads one or more files from a cluster node. You can download the files to the local computer or to a shared folder on the network.

Note

This subcommand was introduced in HPC Pack 2008 R2 with Service Pack 1 and is not supported in previous versions.

Syntax

hpcfile get [/scheduler:{address}] [/head:{length}] [/tail:{length}]   
 [/quiet:{true|false}] [/lines:{true|false}] [/targetnode:{node}] [/file:{path}]   
 [/destfile:{path}] [/encoding:{encoding}] [/stdout:{true|false}]  
  
hpcfile get {/? | /help}  

Parameters

Parameter Description
/scheduler Specifies the name of the cluster head node.
/targetnode Specifies the name of the cluster node.

You can only specify one target node.
/file Specifies the fully qualified path of the source file (that is, the file that you want to download).

You can use the asterisk (*) as a wild card character.

For example, to download all text files in C:\Users\myName, specify: C:\Users\myName\*.txt
/destfile Specifies the fully qualified path of the destination folder (that is, where you want to save the downloaded files). This can be a path on the local computer, or a path to a shared folder on the network.

If not specified, hpcfile downloads the files to the current directory on the local computer.

If you are downloading a single file and want it saved with a different name, you can specify a file name. For example, C:\Users\myName\myCopy.txt.
/encoding Specifies the encoding of the source file. If this parameter is not specified, the encoding is determined by examining the first several bytes of the file. UTF-8, little-endian Unicode, and big-endian Unicode are automatically recognized. You should specify this parameter when the encoding of the source file cannot be automatically recognized.
/head If specified, the command operates on the first <length> bytes or lines of the file.

For example, to operate on the first 4 KB of a file, specify the parameter as follows: /head:4096. This example requires /lines to be set to false.
/lines When /lines is set to false (default), the <length> value of the /head or /tail parameter is interpreted as the number of bytes. When true, the <length> value of the /head or /tail parameter is interpreted as the number of lines. The short form of this option is /l.
/tail If specified, the command only operates on the last <length> bytes or lines of the file.

For example, to operate on the last 4 KB of a file, specify the parameter as follows: /tail:4096. This example requires /lines to be set to false.
/quiet If specified, the utility will always overwrite the destination file (if it exists) instead of prompting. The short form of this option is /q.
/stdout When true, the contents of each file are written to stdout. This option cannot be used if a destination file is specified. The short form of this parameter is /o.
/? Displays Help at the command prompt.
/help Displays Help at the command prompt.

Examples

To download all text files (.txt) from C:\Users\myName on NODE002 and save them to C:\myFiles on the local computer:

hpcFile get /scheduler:myHeadNode /targetNode:NODE002 /file: "C:\Users\myName\*.txt" /destFile: "C:\myFiles"

To download C:\Users\myName\myLog.txt from NODE002 and save it as C:\myFiles\myLogNODE002.txt on the local computer:

hpcFile get /scheduler:myHeadNode /targetNode:NODE002 /file: "C:\Users\myName\myLog.txt" /destFile: "C:\myFiles\myLogNODE002.txt"