AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systems

Imagetofile

Use the imagetofile option with the restore image command to specify that you want to restore the source image to a file.

You might need to restore the image to a file if bad sectors are present on the target volume, or if you want to manipulate the image data. Later, you can use a data copy utility of your choice to transfer the image from the file to a disk volume.

Linux operating systemsLinux supports mounting an image file as a logical volume, so you can get access to file data within the image. The following are some examples:

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systems
  • The file system /usr has been backed up by Tivoli® Storage Manager. The following command restores the file system image to the file /home/usr.img:
    # dsmc restore image /usr /home/usr.img -imagetofile
  • To mount the image file at the /mnt/usr directory, the following mount command can be executed:
    # mount /home/usr.img /mnt/usr -o loop=/dev/loop0

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsNow the image contents are available from /mnt/usr as if a regular file system was mounted at that directory.

Supported Clients

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsThis option is valid for AIX®, HP-UX, all Linux, and Solaris clients. The Tivoli Storage Manager client API does not support this option.

Windows operating systemsThis option is valid for all Windows clients. The Tivoli Storage Manager client API does not support this option.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-IMAGETOfile-------------------------------------------------><

Parameters

There are no parameters for this option.

Examples

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsCommand line:
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsdsmc restore image /usr /home/usr.img -imagetofile
Windows operating systemsCommand line:
Windows operating systemsdsmc restore image d: e:\diskD.img -imagetofile