Restore NAS

The restore nas command restores the image of a file system that belongs to a Network Attached Storage (NAS) file server. When you are using an interactive command-line session with a non-administrative ID, Tivoli® Storage Manager prompts for an administrator ID.

The NAS file server performs the outboard data movement. A server process performs the restore.

If you used the toc option with the backup nas command or the include.fs.nas option to save Table of Contents (TOC) information for each file system backup, you can use the QUERY TOC server command to determine the contents of a file system backup with the RESTORE NODE server command to restore individual files or directory trees. You can also use the web client to examine the entire file system tree and select files and directories to restore. If you do not save TOC information, you can still restore individual files or directory trees with the RESTORE NODE server command, if you know the fully qualified name of each file or directory and the image in which that object was backed up.

AIX operating systems Oracle Solaris operating systems Use the nasnodename option to specify the node name for the NAS file server. The NAS node name identifies the NAS file server to the Tivoli Storage Manager server. You must register the NAS node name at the server. Place the nasnodename option in your client system-options file (dsm.sys). The value in the client system-options file is the default, but this value can be overridden on the command line.

Windows operating systems Use the nasnodename option to specify the node name for the NAS file server. The NAS node name identifies the NAS file server to the Tivoli Storage Manager server. You must register the NAS node name at the server. Place the nasnodename option in your client options file (dsm.opt). The value in the client options file is the default, but this value can be overridden on the command line.

You can use the pick option to display a list of NAS images that are owned by the NAS node you specify. From this list, you can select one or more images to restore. If you select multiple images to restore with the pick option, do not use the monitor option or you serialize the restores. To start multiple restore processes simultaneously when you are restoring multiple images, do not specify monitor=yes.

Use the monitor option to specify whether you want to monitor a NAS file system image restore and display processing information on your screen.

Use the monitor process command to display a list of current restore processes for all NAS nodes for which your administrative user ID has authority. The administrative user ID should have at least client owner authority over both the NAS node and the client workstation node they are using either from command line or from the web.

Use the cancel process command to stop NAS restore processing.

AIX operating systems Oracle Solaris operating systems Regardless of client platform, NAS file system specifications use the forward slash (/) separator, as in this example: /vol/vol0.

A NAS file system specification uses the following conventions:

Regardless of client platform, NAS file system specifications use the forward slash (/) separator, as in this example: /vol/vol0.
NAS file system designations on the command line require brace delimiters {} around the file system names, such as: {/vol/vol0}.

Supported Clients

AIX operating systems Oracle Solaris operating systems This command is valid for AIX®, and Solaris clients only.

Windows operating systems This command is valid for all Windows clients.

Syntax


>>-REStore NAS--+------------+---- --sourcefilespec------------->
                '- --options-'                          

>--+------------------------+----------------------------------><
   '- --destinationfilespec-'

Parameters

sourcefilespec: Specifies the name of the NAS file system image you want to restore. This parameter is required unless you use the pick option to display a list of NAS images from which to choose. You cannot use wildcard characters when you specify the sourcefilespec.
destinationfilespec: Specifies the name of an existing mounted file system on the NAS device over which you want to restore the image. This parameter is optional. The default is the original location of the file system on the NAS device.

Table 1. Restore NAS command: Related options
Option	Where to use
dateformat	Client user option file (dsm.opt) or command line.
dateformat	Client option file (dsm.opt) or command line.
inactive	Command line only.
mode	Command line only.
monitor	Command line only.
nasnodename	Client system options file (dsm.sys) or command line.
nasnodename	Client options file (dsm.opt) or command line.
numberformat	Client user option file (dsm.opt) or command line.
numberformat	Client option file (dsm.opt) or command line.
pick	Command line only.
pitdate	Command line only.
pittime	Command line only.
timeformat	Client user option file (dsm.opt) or command line.
timeformat	Client option file (dsm.opt) or command line.

Examples

Task: Restore the NAS file system image /vol/vol1 to the /vol/vol2 file system on the NAS file server called nas1.
Command: restore nas -nasnodename=nas1 /vol/vol1 /vol/vol2
Task: Restore the NAS file system image /vol/vol1 to the /vol/vol2 file system on the NAS file server called nas1.
Command: restore nas -nasnodename=nas1 {/vol/vol1} {/vol/vol2}
Task: Restore inactive NAS images.
Command: restore nas -nasnodename=nas2 -pick -inactive