OpenText product name changes coming to the community soon! Learn more.

Wikis - Page

Support Tip: Restore a file with TapeAnalyser

0 Likes

Did you know the TapeAnalyser support tool is capable of restoring a file from tape? Here are a couple of things you better know to make things go smooth.

  • TapeAnalyser can be found in "Program Files\OmniBack\bin\utilns" on Windows or in "/opt/omni/sbin/utilns" on Linux.
  • The device specified with the -device option is the OS device file (or path on Windows), not the logical DP device name.
  • When used with tape devices, the tape should be loaded already before running TapeAnalyser. One possibility is to use uma. See also: Support Tip: "uma" standalone usage for library robotics control.
  • When executing operations with TapeAnalyser, the tape is always being rewound at the start and at the end, regardless from the type of device file used (also with no-rewind device file).
  • As a rewind is always happening, positioning, if desired, should be done with the -range option (and not with -mt).
  • The syntax to specify a file on Windows requires some special attention. See the example below.

The general syntax for restoring a file with TapeAnalyser is:

        TapeAnalyser -device DeviceName -type <type>
                -filename FileName
                [ -newfilename NewFileName   ]
                [ -header ]
                [ -range seg1 blk1 seg2 blk2 ]

On linux this is working pretty straight-forward:

[root@system utilns]# ./TapeAnalyser -device /dev/nst1 -type 10 -filename /tmp/1 -newfilename /tmp/1.restored
Opening medium /dev/nst1
=================================
File successfully restored
[root@system utilns]#ll /tmp/1*
-rw-r--r--  1 root root  0 Aug  2 10:42 /tmp/1
-rw-r--r--  1 root root  0 Aug  2 15:51 /tmp/1.restored
[root@system utilns]#

On Windows, it's a little trickier to specify the file and path names and it is different for both the options, as can be seen in the following example:

C:\Program Files\OmniBack\bin\utilns>TapeAnalyser -dev scsi3:0:1:0C -type 10 -filename /MYDIR/2.txt -newfilename C:\MYDIR\restored2.txt
Opening medium scsi3:0:1:0C
=================================
File successfully restored

C:\Program Files\OmniBack\bin\utilns>dir C:\MYDIR\*2*
 Volume in drive C has no label.
 Volume Serial Number is ????-????

 Directory of C:\MYDIR

10/02/2023  11:58                13 2.txt
02/08/2023  14:57                13 restored2.txt
               2 File(s)             26 bytes
               0 Dir(s)  25.747.279.872 bytes free

C:\Program Files\OmniBack\bin\utilns>

You may be interested to some of my other Support Tips too: Support Tips listed per category.

Labels:

How To-Best Practice
Support Tips/Knowledge Docs
Comment List
Related
Recommended