Restore-image operation
The restore-image operation restores a file system or raw volume image that was backed up using the <backup-image> operation. The restore-image obtains the backup image from an IBM Tivoli Storage Manager server.
This operation can restore an active base image, or a point-in-time base image, with associated incremental updates.
The following table describes the elements for the restore-image request:
Adapter request elements for the restore-image operation
The following figure shows a sample adapter request for the restore-image operation:
Sample adapter request for the restore-image operation
<tsm-request>
<operation-name>restore-image</operation-name>
<command-request>
<timeout-secs>120</timeout-secs>
<command-options>
<pitdate>11/25/2008</pitdate>
<pittime>12:00:00</pittime>
<dateformat>MM/DD/YYYY</dateformat>
<timeformat>HH:MM:SS</timeformat>
<incremental />
<deletefiles />
<noprompt />
<verifyimage />
</command-options>
<command-arguments>
<source-filespec>e:</source-filespec>
</command-arguments>
</command-request>
</tsm-request>
<operation-name>restore-image</operation-name>
<command-request>
<timeout-secs>120</timeout-secs>
<command-options>
<pitdate>11/25/2008</pitdate>
<pittime>12:00:00</pittime>
<dateformat>MM/DD/YYYY</dateformat>
<timeformat>HH:MM:SS</timeformat>
<incremental />
<deletefiles />
<noprompt />
<verifyimage />
</command-options>
<command-arguments>
<source-filespec>e:</source-filespec>
</command-arguments>
</command-request>
</tsm-request>
The following figure shows the adapter response for the sample request:
Sample adapter response for the restore-image operation
<tsm-response>
<metadata>
<status>success</status>
<count>1</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc restore image -pitdate=11/25/2008 -pittime=12:00:00 - dateformat=1 -timeformat=1 -incremental -deletefiles -noprompt - verifyimage e:</command>
<line-count>19</line-count>
<execution-milliseconds>4859</execution-milliseconds>
<exit-code>0</exit-code>
<status>success</status>
</metadata>
<output>
<line index="1">IBM Tivoli Storage Manager</line>
<line index="2">Command Line Backup/Archive Client Interface</line>
<line index="3"> Client Version 5, Release 5, Level 0.0 </line>
<line index="4"> Client date/time: 11/25/2008 12:29:37</line>
<line index="5">(c) Copyright by IBM Corporation and other(s) 1990, 2007. All Rights Reserved.</line>
<line index="6">Node Name: WIN2STDVM</line>
<line index="7">Session established with server SERVER1: Linux/i386</line>
<line index="8"> Server Version 5, Release 5, Level 0.0</line>
<line index="9"> Server date/time: 11/25/2008 12:28:08 Last access: 11/25/2008 12:25:42</line>
<line index="10">Restore Image Function Invoked.</line>
<line index="11">Restoring 102,760,448 \\win2stdvm\e$ [Done] </line>
<line index="12">Restore processing finished.</line>
<line index="13">Total number of objects restored: 1</line>
<line index="14">Total number of objects failed: 0</line>
<line index="15">Total number of bytes transferred: 2.45 MB</line>
<line index="16">Data transfer time: 2.00 sec</line>
<line index="17">Network data transfer rate: 1,259.05 KB/sec</line>
<line index="18">Aggregate data transfer rate: 1,184.99 KB/sec</line>
<line index="19">Elapsed processing time: 00:00:02</line>
</output>
</command-output>
</commands-output>
</tsm-response>
<metadata>
<status>success</status>
<count>1</count>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>dsmc restore image -pitdate=11/25/2008 -pittime=12:00:00 - dateformat=1 -timeformat=1 -incremental -deletefiles -noprompt - verifyimage e:</command>
<line-count>19</line-count>
<execution-milliseconds>4859</execution-milliseconds>
<exit-code>0</exit-code>
<status>success</status>
</metadata>
<output>
<line index="1">IBM Tivoli Storage Manager</line>
<line index="2">Command Line Backup/Archive Client Interface</line>
<line index="3"> Client Version 5, Release 5, Level 0.0 </line>
<line index="4"> Client date/time: 11/25/2008 12:29:37</line>
<line index="5">(c) Copyright by IBM Corporation and other(s) 1990, 2007. All Rights Reserved.</line>
<line index="6">Node Name: WIN2STDVM</line>
<line index="7">Session established with server SERVER1: Linux/i386</line>
<line index="8"> Server Version 5, Release 5, Level 0.0</line>
<line index="9"> Server date/time: 11/25/2008 12:28:08 Last access: 11/25/2008 12:25:42</line>
<line index="10">Restore Image Function Invoked.</line>
<line index="11">Restoring 102,760,448 \\win2stdvm\e$ [Done] </line>
<line index="12">Restore processing finished.</line>
<line index="13">Total number of objects restored: 1</line>
<line index="14">Total number of objects failed: 0</line>
<line index="15">Total number of bytes transferred: 2.45 MB</line>
<line index="16">Data transfer time: 2.00 sec</line>
<line index="17">Network data transfer rate: 1,259.05 KB/sec</line>
<line index="18">Aggregate data transfer rate: 1,184.99 KB/sec</line>
<line index="19">Elapsed processing time: 00:00:02</line>
</output>
</command-output>
</commands-output>
</tsm-response>
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*