7.2.16 mv

Move Exascale files.

Syntax

mv source1 target1 [ sourceN targetN ]...
   [{ -w | --wallet } wallet-location ] 
   [{ -T | --trace } trace-level ] 
   [{ -j | --json } [ --compact ]]

Command Options

The options for the mv command are:

• source1-N: Specifies the source file being moved.

• target1-N: Specifies the target location of the file. The value cannot be a directory.

• -w, --wallet: Optionally specifies the path to the Exascale wallet directory.

• -T, --trace: Optionally enables tracing, with the trace level (trace-level) set to 1 (minimum tracing), 2 (medium tracing), or 3 (maximum tracing). If the trace level is not specified, then minimum tracing is enabled by default.

  The trace file is written to the first accessible location in the following list:

  1. If the $ADR_BASE environment variable is set:

     $ADR_BASE/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc

  2. /var/log/oracle/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc

  3. /tmp/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc

• -j, --json: Displays the output in JSON format.

• --compact: Displays JSON formatted output in a compact format, without white space and line breaks.

Usage Notes

Note the following information when using this command:

• The source and target locations must reside in the same Exascale vault.

• You can use a wildcard (%) in the source location to specify multiple source files, in which case the corresponding target location must also contain a matching wildcard. For example, see Example 7-30.

Examples

Example 7-30 Move Multiple Files on Exascale Storage

The following example uses the wildcard character (%) to move multiple files from @my-data/location1/prefix1% to @my-data/location2/another-location/prefix2%. Using the example command, a file named @my-data/location1/prefix1mydata would be moved to @my-data/location2/another-location/prefix2mydata.

$ xsh mv @my-data/location1/prefix1% @my-data/location2/another-location/prefix2%