Backup-image operation


The backup-image operation creates an image backup of one or more volumes on your system.

  • Microsoft Windows Clients: These volumes can be formatted FAT, FAT32, or NTFS volumes, or unformatted RAW volumes. If a volume is NTFS-formatted, only those blocks used by the file system are backed up.
  • UNIX Clients:
    • For Linux clients, image backup is supported only on partitions with ID 0x83 or logical volumes created with the Linux Logical Volume Manager. Backing up other partitions, such as extended partitions that contain mounted file systems or database data can produce inconsistent backup data if the data changes during the image backup operation.
    • The usage of GPFS snapshot, and image backup is not supported for GPFS file systems on:
      • Linux x86/x86_64
      • Linux on POWER
      • Linux for IBM zSeries

        The following table describes the elements for the adapter request:
        The [confluence_table-plus] macro is a standalone macro and it cannot be used inline.

The following figure shows a sample adapter request for the backup-image operation:

Sample adapter request for the backup-image operation

<tsm-request>
 <operation-name>backup-image</operation-name>
 <command-request>
   <timeout-secs>120</timeout-secs>
   <command-options>
     <compressalways>no</compressalways>
     <compression>yes</compression>
     <imagegapsize>10k</imagegapsize>
     <mode>Selective</mode>
     <snapshotcachesize>10</snapshotcachesize>
     <snapshotcachelocation>e:</snapshotcachelocation>
     <snapshotfsidleretries>1</snapshotfsidleretries>
     <snapshotfsidlewait>4s,500ms</snapshotfsidlewait>
   </command-options>
   <command-arguments>
     <volume-list>e:</volume-list>
   </command-arguments>
 </command-request>
</tsm-request>


The following figure shows the adapter response for the sample request:

Sample adapter response for the backup-image operation

<tsm-response>
 <metadata>
   <status>success</status>
   <count>1</count>
 </metadata>
 <commands-output>
   <command-output>
     <metadata>
       <command>dsmc backup image -compressalways=no -compression=yes -        imagegapsize=10k -mode=Selective -snapshotcachesize=10 -        snapshotcachelocation=e: -snapshotfsidleretries=1 -        snapshotfsidlewait=4s,500ms e:</command>
       <line-count>27</line-count>
       <execution-milliseconds>5422</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 09:37:12</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 09:35:37  Last access:         11/25/2008 09:33:24</line>
       <line index="10">Backup Image Function Invoked.</line>
       <line index="11">Image backup of volume 'e:'</line>
       <line index="12">Using static image backup for volume         '\\win2stdvm\e$'</line>
       <line index="13">Volume -->    102,760,448 \\win2stdvm\e$ [Sent]         </line>
       <line index="14">Image Backup processing of '\\win2stdvm\e$' finished         without failure.</line>
       <line index="15">Total number of objects inspected:        1</line>
       <line index="16">Total number of objects backed up:        1</line>
       <line index="17">Total number of objects updated:          0</line>
       <line index="18">Total number of objects rebound:          0</line>
       <line index="19">Total number of objects deleted:          0</line>
       <line index="20">Total number of objects expired:          0</line>
       <line index="21">Total number of objects failed:           0</line>
       <line index="22">Total number of bytes transferred:   170.56 KB</line>
       <line index="23">Data transfer time:                    2.00 sec</line>
       <line index="24">Network data transfer rate:           85.28 KB/sec</line>
       <line index="25">Aggregate data transfer rate:         88.05         KB/sec</line>
       <line index="26">Objects compressed by:                   94%</line>
       <line index="27">Elapsed processing time:           00:00:01</line>
     </output>
   </command-output>
 </commands-output>
</tsm-response>

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*