Welcome Serena Central users!
The migration of the Serena Central community is happening today. Be sure to read THIS MESSAGE to get your new login set up to access your account.
Micro Focus Expert
Micro Focus Expert
127 views

(DP) Support Tip: Basic Troubleshooting steps for any restore issues using CLI

Basic Troubleshooting for Restore Issues/Error.

For any restore issues, it would be best to get information and details on the backed-up object - the one you need to restore.

Key is to identify the backup session ID and run a query on the backup media.


1. Identify the backup session ID

omnidb -sess

or if you know which backup specification

omnidb -sess -datalist <Datalist> -detail

OR

omnidb -session -datalist "IntegrationName BackupSpecificationName" -detail


You should have the SESS_ID - 2017/XX/YY-YY


2. Get details on the backup - specifically on the backup media

omnidb -sess <SESS_ID> -report

omnidb -sess <SESS_ID> -detail

omnidb -sess <SESS_ID> -media

Replace <SESS_ID> with the specific backup session ID.

Example :

omnidb -sess 2015/07/03-473 -media

Medium Label Medium ID Free Blocks
===============================================================================
[AHY525] AHY525 97020480:500f5213:1998:0001 2248030424


Do take note of the medium label and medium ID.

 

3. Identify the backup device you can use to query backup tape(s).

omnidownload -list_device -detail

omnidownload -list_libraries -detail

You can also refer to the above backup session report if you want to use the same device used at backup time.

Do ensure that the device you've selected is free/idle.


Examples :

Assuming drive "HP:Ultrium 4-SCSI_1_PROD" is free and backup tape is in slot 1.

(Extract from omnidownload)

NAME "HP:Ultrium 4-SCSI_1_PROD" <======= Identified and selected drive
DESCRIPTION "CLAIMED:HP LTO4 Drive"
HOST PROD-TEST
POLICY SCSI-II
TYPE LTO-Ultrium
POOL "Default LTO-Ultrium"
LIBRARY "HP:EML E-Series_PROD"
DRIVES
"Tape0:0:0:0C"
"1"
MULTIPATH
"PROD";"Tape0:0:0:0C"
BLKSIZE 256
LOCKNAME "HP:Ultrium 4-SCSI:HU17380DCA"
SANSTABLEADDR
DEVSERIAL "HU17380DCA"
RESTOREDEVICEPOOL NO
COPYDEVICEPOOL NO

 

4. Load the backup tape(s) into one of the free slots

Optional : Run a slot scan to ensure this is the correct backup tape

omnimm -repository_update <DriveName> -slot <SlotID>

omnimlist -device <BackupDevice> -slot <SlotID>


Examples :

omnimm -repository_update "HP:Ultrium 4-SCSI_1_PROD" -slot 1

OR

omnimlist -device "HP:Ultrium 4-SCSI_1_PROD" -slot 1


Check the output and ensure you have the backup tape in corresponding slot.

 

5. Run LIST FROM MEDIA

omnimlist -device <BackupDevice> -slot <slotID> -header -monitor

=> check the backup tape header info

omnimlist -device <BackupDevice> -catalog -slot <SlotID> -monitor


Examples :

omnimlist -device "HP:Ultrium 4-SCSI_1_PROD" -slot 1 -header -monitor

Output

[Normal] From: MSM@PROD-TEST "HP:Ultrium 4-SCSI_1_PROD" Time: 8/28/2016 4:18:45 PM
Data Protector medium "[AHY525] AHY525" found.

=================================================================================
VOL1OMNI-2-[HP OmniBack II v1.0 ]D%-3310000003 [HP OmniBack II v1.0 ]1
=================================================================================

AHY525 is valid Data Protector media:

Media ID = 97020480:500f5213:1998:0001
Media Label = AHY525
Media Location =
Media data format type = 0
Media data format subtype = 0
Tape format version = 3
Pool Label = IMG-TIER2-BACKUP
Padding information = -1
Date initialized = 7/25/2015 9:55:31 AM
Date last access* = 7/25/2015 10:05:22 AM
Date last write* = 7/25/2015 10:05:22 AM
Date last overwrite* = 7/25/2015 10:05:22 AM
Number of writes* = 0
Number of overwrites* = 1
Device capacity = 819431424
Device information
type = 13
block size = 65536
preerased start position = 0
preerased end position = 0
number of segments = 0

 


omnimlist -device "HP:Ultrium 4-SCSI_1_PROD" -catalog -slot 1 -monitor

Extract output :

Session : 2015/07/03-473

Object name : PROD-DB:/root_vdm_9/userdata_sys '/root_vdm_9/userdata_sys'
Object type : FileSystem
Disk Agent ID : 1435949109
Object status : Completed
=======================================================================================
Protection Owner Group Size [B] Time Path
=======================================================================================

drwxr-xr-x 37208 32934 1024 06/12/2011 09:02:39 /root_vdm_9/userdata_sys/userdata/JOHN.DOE/


Session : 2015/07/03-473

Object name : PROD-DB:/root_vdm_8/userprofile_sys '/root_vdm_8/userprofile_sys'
Object type : FileSystem
Disk Agent ID : 1435949114
Object status : Completed
=======================================================================================
Protection Owner Group Size [B] Time Path
=======================================================================================

drwxr-xr-x 37208 32934 1024 28/05/2015 15:40:24 /root_vdm_8/userprofile_sys/profiles/JOHN.DOE/

 


6. Run QUERY OF THE IDB FOR CATALOG INFORMATION

Take note of the output from above "omnidb -sess <SESS_ID> -media" and then you can run :

omnimm -catalog [mediumID or mediumLabel]

Example :

omnimm -catalog AHY525

or

omnimm -catalog 97020480:500f5213:1998:0001

 

You can compare the output of item no. 5 (omnimlist) and no. 6 (omnimm) to do a catalog inventory of the backed-up objects. The output of both catalog query (omnimlist and omnimm) should be simillar - particular on these entries Session ID / Object name / Object type and the backed-up object details such as path/filename.

 


IMPORTANT : Do always dump the DP CLI output to 1 text file each - using a unique filename.

 

The output from LIST FROM MEDIA and QUERY OF THE IDB FOR CATALOG INFORMATION should confirm if the backed-up object is still valid and exists in the backup media, and if you can use DP GUI to browse for restore.

Depending on the restore issue, the above basic information will easily identify how to move forward in troubleshooting and resolving restore errors.

Labels (1)
0 Likes
The opinions expressed above are the personal opinions of the authors, not of Micro Focus. By using this site, you accept the Terms of Use and Rules of Participation. Certain versions of content ("Material") accessible here may contain branding from Hewlett-Packard Company (now HP Inc.) and Hewlett Packard Enterprise Company. As of September 1, 2017, the Material is now offered by Micro Focus, a separately owned and operated company. Any reference to the HP and Hewlett Packard Enterprise/HPE marks is historical in nature, and the HP and Hewlett Packard Enterprise/HPE marks are the property of their respective owners.