Manual Chapter : Restoring a Volumes Files

Applies To:

Show Versions Show Versions

ARX

  • 6.3.0
Manual Chapter
Appendix 3, Tracking Files on Your Back-End Storage, explained how to find back-end file locations at any given time. This chapter explains some methods for restoring them to an ARX service.
You can use the output from show file-history virtual-service or find to retrieve files from your backup server. For example, consider the following command which shows the location of the a_adams.dat file as of the last series of backups (September 14 in this example):
bstnA# show file-history virtual-service ac1.medarch.org ARCHIVES date 09/14/2009 file a_adams.dat path /2005/planA
You can use the find command to locate the same file as of now. This shows that the file migrated to the filer at 192.168.25.27 since September 14:
bstnA# find global-server ac1.medarch.org cifs ARCHIVES path /2005/planA/a_adams.dat
A restore operation automatically copies a restored file from the staging area to its managed volume, which then places the file into the share where it currently resides:
Before you use the restore data command (described below), you need to identify the file server with the staging-area directory. This is the source for the ARX-restore operation. In most cases, the staging area is on the same filer where the file originally resided, in a directory outside of any imported share. In this case, the external-filer configuration already exists to support the imported share(s), and you can skip to the next section.
bstnA(gbl)# external-filer nasE1
bstnA(gbl-filer[nasE1])# ip address 192.168.25.51
The restore data command invokes the restore operation:
restore data namespace volume vol path dest-path
filer src-filer {nfs export | cifs share}+ source-path src-path
[recurse] [remove-source]
namespace volume vol path dest-path identifies the file or directory to restore:
namespace is 1-30 characters. Use the namespace from the show file-history virtual-service or find output, shown earlier.
vol is 1-1024 characters. Type ? for a list of volumes in the above namespace, and choose the volume behind the clients front-end share. If you cannot find the complete path you need (such as /claims/stats), choose the volume that is the root of your path (/claims).
dest-path is also 1-1024 characters. This could be the remainder of the path you started with the vol, above (for example, /stats). The restore process creates a /restore directory below this path, and places the restored file(s) in there.
filer src-filer {nfs export | cifs share}+ source-path src-path points to the filer with the staging area and the backup file(s):
src-filer (1-64 characters) is the external-filer name for the filer with the staging area,
nfs export (1-1024 characters) identifies the NFS export, and
cifs share (1-1024 characters) identifies the CIFS share. For a multi-protocol share, enter both paths: nfs export cifs share.
src-path (1-1024 characters) is the path to the backup file(s). This is the staging-area directory.
You can enter the optional recurse and remove flags in any order:
recurse (optional) causes the restore operation to descend into subdirectories.
remove-source (optional) activates a clean-up routine after the restore is finished; the restore operation removes the backup files after confirming a successful restore to the volume.
Every restore operation produces a report as it runs. The CLI shows the report name after you invoke the command. Use show reports for a full list of restore reports, and use show, tail, or grep to view one report. The report shows the progress of the operation.
bstnA# restore data insur volume /claims path stats filer nasE1 nfs /root_vdm_4/backups cifs BACKUPS source-path /stats recurse
bstnA# show reports restore.7._claims.rpt
From any remote host that supports the Secure SHell (SSH) protocol, you can run the restore data command and see the report. Use the following syntax with ssh:
ssh admin-user@mip restore data...
admin-user is the username for a valid administrative account at the ARX (use show users to list all of them, as shown in Listing All Administrative Users, on page 2-14 of the ARX® CLI Network-Management Guide),
mip is a management-IP address for the ARX (use show interface mgmt to show the out-of-band management interface, or show interface vlan to show all in-band management interfaces), and
restore data... is the full restore data command, described above. Surround this with quotation marks ().
For example, the following command sequence re-runs the above restore data command from a remote machine, mgmt17.
juser@mgmt17:~$ ssh admin@10.1.1.7 restore data insur volume /claims path stats filer nasE1 nfs /root_vdm_4/backups cifs BACKUPS source-path /stats recurse
juser@mgmt17:~$ ssh admin@10.1.1.7 show reports restore.9._claims.rpt
bstnA(gbl)# show restore data
show restore data [namespace [volume vol-path [path path]]]
namespace (1-30 characters) selects a namespace,
vol-path (1-1024 characters) narrows the scope to a specific volume, and.
path (1-1024 characters) narrows the scope further, to a specific virtual path in the volume (for example, /home/jrandom). This is relative to the vol-path.
bstnA(gbl)# show restore data insur volume /claims path /stats
The show restore data command displays a running history of all restore operations. The history goes back indefinitely, so the command can display a very large number of records over time. You can clear all of these records at once, or all records for a particular namespace, volume, or path. From priv-exec mode, use the clear restore data command:
clear restore data [namespace [volume vol-path [path path]]]
namespace (optional, 1-30 characters) identifies one namespace with restore records. If this option is omitted, the command clears all restore-operation records from the history.
vol-path (optional, 1-1024 characters) narrows the scope to one volume, and
path (optional, 1-1024 characters) narrows the scope further to a specific virtual path. This is relative to the vol-path.
Before clearing the records, a prompt requests confirmation; enter yes to confirm. After you clear the records, they no longer appear in the show restore data output.
bstnA(gbl)# show restore data
bstnA# clear restore data
bstnA# show restore data
cancel restore data namespace volume vol-path path path
namespace (1-30 characters) identifies the namespace,
vol-path (1-1024 characters) is the volume, and
path (1-1024 characters) is the specific virtual path that is being restored. This is relative to the vol-path.
A prompt requests confirmation before the CLI cancels the restore; enter yes to confirm that you want to cancel the operation.
bstnA# cancel restore data wwmed volume /acct path /