Skip to content

Latest commit

 

History

History
216 lines (134 loc) · 6.74 KB

xcp-nfs-reference-sync.adoc

File metadata and controls

216 lines (134 loc) · 6.74 KB
sidebar permalink keywords summary
sidebar
xcp-nfs-reference-sync.html
netapp, xcp, reference, nfs, command, commands
XCP NFS command reference

sync

View the descriptions, parameters, and examples for the XCP sync command, including when the sync command is used with the dry run option.

sync

The XCP NFS sync command scans for changes and modifications to a source NFS directory by using a catalog index tag name or the number of a previous copy operation. Incremental changes to the source are copied and applied to the target directory. The old catalog index numbers are replaced with new ones after the sync operation.

Note
During the sync operation, modified files and directories are copied to the destination NFSv3 export again.
Syntax
xcp sync -id <catalog_name>
Important
The -id <catalog_name> parameter is required with the sync command.

The following table lists the sync parameters and their description.

Parameter Description

sync -id <catalog_name>

Specifies the catalog name of a previous copy index. This is a required parameter for the sync command.

sync -nonames

Excludes user and group names from file listings and reports.

sync -bs <n[k]>

Specifies the read/write block size (default: 64k).

sync -dircount <n[k]>

Specifies the request size when reading directories.

sync -parallel <n>

Specifies the maximum number of concurrent batch processes (default: 7).

sync -preserve-atime

Restores all files to the last accessed date on the source.

sync -nonames

Use the the -nonames parameter with the sync command to exclude user and group names from file listings or reports.

Syntax
xcp sync -id <catalog_name> -nonames

sync -bs <n[k]>

Use the the -bs <n[k]> parameter with the sync command to specify the read/write block size. The default block size is 64k.

Syntax
xcp sync -id <catalog_name> -bs <n[k]>

sync -dircount <n[k]>

Use the the -dircount <n[k]> parameter with the sync command to specify the request size when reading directories. The default value is 64k.

Syntax
xcp sync -id <catalog_name> -dircount <n[k]>

sync -parallel

Use the the -parallel parameter with the sync command to specify the maximum number of concurrent batch processes. The default value is 7.

Syntax
xcp sync -id <catalog_name> -parallel <n>

-preserve-atime

Use the the -preserve-atime parameter with the sync command to restore all files to the last accessed date on the source.

The -preserve-atime option resets the access time to the original value set before the XCP read operation.

Syntax
xcp sync -preserve-atime -id <catalog_name>

sync dry-run

The sync command with the dry-run option looks for changes or modifications made to the source NFS directory using the previous catalog index number of a copy operation. This command also detects files and directories that are new, moved, deleted, or renamed since the previous copy operation. The command reports the source changes but does not apply them to the target.

Syntax
xcp sync dry-run -id <catalog_name>
Important
The -id <catalog_name> parameter is required with the sync dry-run command option.

The following table lists the sync dry-run parameters and their description.

Parameter Description

sync dry-run -id <catalog_name>

Specifies the catalog name of a previous copy index. This is a required parameter for the sync command.

sync dry-run -stats

Performs a deep scan of the modified directories and reports everything that is
new.

sync dry-run -l

Prints details about files and directories that changed.

sync dry-run -nonames

Excludes user and group names from file listings and reports.

sync dry-run -dircount <n[k]>

Specifies the request size when reading directories.

sync dry-run -parallel <n>

Specifies the maximum number of concurrent batch processes (default: 7).

sync dry-run -id <catalog_name>

Use the the -id <catalog_name> parameter with sync dry-run to specify the catalog name of a previous copy index.

Important
The -id <catalog_name> parameter is required with the sync dry-run command option.
Syntax
xcp sync dry-run -id <catalog_name>

sync dry-run -stats

Use the the -stats parameter with sync dry-run to perform a deep scan of the modified directories and report everything that is new.

Syntax
xcp sync dry-run -id <catalog_name> -stats

sync dry-run -l

Use the the -l parameter with sync dry-run to print details about files and directories that changed.

Syntax
xcp sync dry-run -id <catalog_name> -l

sync dry-run -nonames

Use the the -nonames parameter with sync dry-run to exclude user and group names from file listings or reports.

Syntax
xcp sync dry-run -id <catalog_name> -nonames

sync dry-run -dircount <n[k]>

Use the the -dircount <n[k]> parameter with sync dry-run to specify the request size when reading directories. The default value is 64k.

Syntax
xcp sync dry-run -id <catalog_name> -dircount <n[k]>

sync dry-run -parallel

Use the the -parallel parameter with sync dry-run to specify the maximum number of concurrent batch processes. The default value is 7.

Syntax
xcp sync dry-run -id <catalog_name> -parallel <n>