Copy or Restore Data for Files and Directories With Mass File Restoration Using CloudFS UI

This article covers mass file restoration using the CloudFS UI, available with CloudFS 8.1x

Pre-requisites

Panzura CloudFS nodes must be running CloudFS version 8.1.0.0 17445 or newer. Destination node's snapshots should be in sync (specifically with the source node).

Introduction

User or project directories can be restored by using mass file restoration, a recursive file system copy command that runs on the node. This method does not copy the restored files from the cloud into the local node's cache. Instead, mass file restoration restores the metadata for the files.

For Windows clients, Windows Previous Version (WPV) provides the same result as mass file restoration, and is managed by individual users, so that the administrator does not need to be involved in most small user restorations. However, WPV is single-threaded and performance issues can arise when copying many files or large files. In contrast, since mass file restoration deals only with the restored file metadata instead of copying the files themselves, it is a much faster operation. Using mass file restoration can be 5-10 times faster on a single large file and can be another 10 times faster with 10 threads running over a large number of files.

Best Practices

● Mass file restoration should always be run from the destination node and, preferably, to an empty directory.

● Panzura recommends that large scale copies using mass file restoration be performed in low demand time periods. Contents should be copied to an empty or new subdirectory within the share created by an Administrator user, this ensures the right to access the new directory after the copy is complete.

● The source and destination path MUST be expressed in the POSIX format (for example: “/cloudfs/node/dir/”) instead of the UNC format (for example: “\\node\cloudfs\node\dir\”).

Examples

Example: Restore to a new location

In the CloudFS UI, navigate to Maintenance > CloudFS Operations > CloudFS Browser. Within the browser navigate to the ".snapshot" folder to access your snapshots:

Choose a point in time from which you would like to restore data:

Choose the node from which you would like to restore data (source):

Choose a share / folder to restore (source) and click "MANAGE" in the "Action" column:

The "Restore Versions" dialog will appear. Verify the source path from which data will be restored and click the "Restore" button:

Click the "BROWSE" button to select a destination path:

Select a destination or create a new folder, then click "CONFIRM":

Verify the source path and destination path, and click "START" to begin the restore process:

Optional: set minimum and maximum resource usage for this restore process. If you're unsure, don't worry. We got it.

Navigate to the "Restore Tasks" section of the CloudFS Browser to view the progress of the restore:

Once the restore process has completed, status can be viewed in the CloudFS Browser:

Error Codes


ERROR #	ERROR MESSAGE	DETAILS
001	Src stat fails, skipping copy	REASON: ERR 001 <src> stat fails, skipping copy Cannot stat the source file RECOMMENDATION: 1. Check the existence and the accessibility of the source file 2. Retry fs_ddcopy from source parent directory
002	Src not a regular file, directory, or link, skipping copy	REASON: ERR 002 <src> not a regular file, directory, or link, skipping copy Wrong file type: fs_ddcopy will not copy file types other than a regular file, directory, or link RECOMMENDATION: 1. Check the type, existence, and accessibility of the source file 2. Retry fs_ddcopy from source parent directory
003	Src copy failed @<line number>	REASON: ERR 003 <src> copy failed @<line number> due to <reason> Internal error RECOMMENDATION: Retry fs_ddcopy from the source parent directory
004	Src 1:Failed	REASON: ERR 004 <src> 1:Failed with <reason> The destination file exists. but CloudFS cannot stat the source file or cannot copy its extended attributes RECOMMENDATION: 1. Check the existence and the accessibility of the source file 2. Manually fix file attributes, if necessary 3. Retry fs_ddcopy from source parent directory
005	Src 2:Failed	REASON: ERR 005 <src> 2:Failed with <reason> RECOMMENDATION: 1. Check the existence and the accessibility of the source file and make sure no other processes are accessing the target file 2. Retry fs_ddcopy from source parent directory
006	Src 3:Failed to copy link xattrs	REASON: ERR 006 <src> 3:Failed to copy link xattrs {<reason>} Failure to copy extended attributes for a link. RECOMMENDATION: 1. Check the existence and the accessibility of the source link 2. Manually fix file attributes, if necessary 3. Retry fs_ddcopy from source parent directory
007	Src 4:Failed to copy xattrs	REASON: ERR 007 <src> 4:Failed to copy xattrs {<reason>} Failure to copy the extended attributes for a file. RECOMMENDATION: 1. Check the existence and the accessibility of the source file, and make sure no other processes are accessing the target file 2. Manually fix file attributes, if necessary 3. Retry fs_ddcopy from source parent directory
008	No such file or directory	REASON: The target directory does not exist. RECOMMENDATION: Change the destination to an existing path. (errno: 2)
009	Copy interrupted	REASON: The system call was interrupted. RECOMMENDATION: Retry fs_ddcopy process. (errno: 4)
010	Try again	REASON: The target directory is temporarily unavailable. RECOMMENDATION: Wait a few minutes and retry fs_ddcopy process.(errno: 11)
011	Permission denied	REASON: Permission setting of destination directory does not allow the specified access. RECOMMENDATION: Change destination path to a valid or writable one, or change permissions for target directory. (errno: 13)
012	Out of memory	REASON: No more space available on the device. RECOMMENDATION: Add disk to the device. (errno: 28)
013	Can’t write to <dest>	REASON: The target directory is Read-only. RECOMMENDATION: Change the destination path to a valid or writable one, or change settings for target directory. (errno: 30)
014	Unkown (errno: <errno>)	REASON: Unexpected error occurred. RECOMMENDATION: Please contact Panzura Support for assistance. (errno: <errno>)
015	Try again	REASON: The target directory is temporarily unavailable. RECOMMENDATION: Wait a few minutes and retry fs_ddcopy process.(errno: 11)
016	Permission denied	REASON: Permission setting of destination directory does not allow the specified access. RECOMMENDATION: Change destination path to a valid or writable one, or change permissions for target directory. (errno: 13)
017	Out of memory	REASON: No more space available on the device. RECOMMENDATION Add disk to the device. (errno: 28)
018	Can’t write to <dest>	REASON: The target directory is Read-only. RECOMMENDATION: Change the destination path to a valid or writable one, or change settings for target directory. (errno: 30)
019	Unkown (errno: <errno>)	REASON: Unexpected error occurred. RECOMMENDATION: Please contact Panzura Support for assistance. (errno: <errno>)

Summary

This process can be used to copy files & directories between different locations in the CloudFS very quickly. Since data is already in the cloud, and tracked in the CloudFS via metadata, the process can then skip copying the data, and copy only the metadata. Therefore, content is moved much more quickly than conventional methods (for example: rsync, cp, or robocopy).

Recover from ransomware, corruptions, accidental deletions with fs_ddcopy in a fast, efficient manner.