hpcfile get

Applies To: Microsoft HPC Pack 2008 R2, Microsoft HPC Pack 2012, Microsoft HPC Pack 2012 R2

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"