How to interpret the different fields in "nbstlutil list" output in 8.x, 9.x and 10.x

Article: 100011244
Last Published: 2023-06-23
Ratings: 1 3
Product(s): NetBackup & Alta Data Protection

Description

How to interpret the different fields in "nbstlutil list" output in 8.x, 9.x and 10.x?

The nbstlutil command can be found in

  • /usr/openv/netbackup/bin/admincmd (UNIX)
  • <install_path>\VERITAS\NetBackup\bin\admincmd (Windows)


nbstlutil list -backupid <backupID> shows information about the specified backupID taken from the EMM database.

  • The -U command line switch presents this data in a "user-friendly" format.
  • The -l switch provides a "compact" output where data is presented on a single line in a more easily parsable format.


Without a switch, -l is implied:

# nbstlutil list

V7.6.0 I MASTERSERVER nbclient1_1386088762 nbclient1 1386088762 POLICY_NAME 0 0 SLP_NAME 3 false 0 *NULL* 1  00000000-0000-0000-0000-000000000000 0 0 1386088763
V7.6.0 C MASTERSERVER nbclient1_1386088762 1 1387298362 1387298362 stu_hcart2-robot-tld-0 5 68 0 0 0 *NULL* 1387298362 1386088865 1387298362 0 0 0 1 1
V7.6.0 F MASTERSERVER nbclient1_1386088762 1 1 0 E01009 MEDIASERVER *NULL* 2 1 1 102432768 0 E00123 *NULL* *NULL*
V7.6.0 C MASTERSERVER nbclient1_1386088762 2 1387298362 1387298362 stu_advdisk 5 71 0 0 1 *NULL* 1387298362 1386089859 1387298362 2 1 0 1 2
V7.6.0 F MASTERSERVER nbclient1_1386088762 2 1 2 @aaaab MEDIASERVER *NULL* 0 6 1 102432768 0 @aaaab *NULL* 1;AdvancedDisk;MEDIASERVER;DISKPOOL;Z:\;0


The different fields in the IMAGE entry are:
 

Field Field Header Example Description
1 Version V7.6.0  
2 Record Header I IMAGE
3 Master hostname master.fully.qualified.com  
4 Backup ID client_1234567890  
5 Client hostname client  
6 Backup time 1234567890 ctime value
7 Policy name testpolicy  
8 Client type 0  
9 Schedule type 0  0=FULL
10 Storage Service (Lifecycle) name testcycle  
11 Storage Service (Lifecycle) State 1 1=NOT_STARTED, 2=IN_PROCESS, 3=COMPLETE, 0=NOT_MANAGED
12 Time In Process 0  
13 Data Classification ID "Platinum" or *NULL* ID value corresponding to Data Classification selected
14 Version Number 0 (6.5.5 +) The version of the lifecycle being read for processing this image
15 Origin Master Server ID 00000000-0000-0000-0000-000000000000  
16 Import From Replica Time 0  
17 Required Expiration Date 0  
18 Created Date Time 1234567891  


The different fields in the COPY entry are:
 
Field Field Header Example Description
1 Version V7.6.0  
2 Record Header C COPY
3 Master hostname master.fully.qualified.com  
4 Backup ID client_1234567890  
5 Copy Number 1  
6 Expiration Time 1234567890 ctime value; this is no longer set to INFINITE for Copy Protection, but the COPY STATE controls this
7 Try to Keep time 1234567890 ctime value; this is no longer set to INFINITE for Copy Protection, but the COPY STATE controls this
8 Destination my_adv_disk Name of storage unit
9 Copy State 5

1=NOT_STARTED, 2=IN_PROCESS, 3=JOBCOMPLETE, 4=DELETED, 5=COPYCOMPLETE, 6=CANCELLED, 7=CANT_PROCESS, 8=DEFERRED

(0=NOT_MANAGED)

10 Job ID 1234  
11 Expiration Type 0 0=FIXED, 1=CAPACITY MANAGED, 2=EXPIRE_ON_DUP
12 Media Multiplexing State 0 Multiplexed copy? 0=No, 1=Yes
13 Source 0  
14  Destination ID  *NULL*  
15  Expire Time 1234567891  
16 Last Retry Time 1234567891  
17 Expire Time 1234567891  
18 Retry Count 0  
19 Copy Type 0 0=BACKUP 1=DUPLICATION 2=SNAPSHOT 3=REPLICATE_TO_REMOTE_MASTER 5=BACKUP_FROM_SNAPSHOT 7=SNAPSHOT-REPLICATION
20 Replica 0  
21 Data Format 1 1=DF_TAR, 2=SNAPSHOT
22 SLP Index 1  


The different fields in the FRAGMENT entry are:
 
Field Field Header Example Description
1 Version V7.6.0  
2 Record Header F FRAGMENT
3 Master hostname master.fully.qualified.com  
4 Backup ID client_1234567890  
5 Copy Number 1  
6 Fragment Number 1  
7 Resume Count 0  
8 Media ID A00001 The Media ID or BasicDisk disk path the backup was written to. All disk types other than BasicDisk will display a Media ID of the form "@xxxxx"
9 Media Server Name media.fully.qualified.com  
10 Storage Server Name sts.fully.qualified.com  
11 Storage Unit Type 2 0=DISK, 1=UNITREE, 2=RMEDIA, 3=NDMP, 4=FASTRAX, 5=CKPT, 6=DISKSTAGE
12 Storage Unit Sub-Type 1 1=BASIC, 2=NEARSTORE, 3=SNAPVAULT, 4=unused, 5=unused, 6=STSDYNAMIC
13 Fragment State 1 1=ACTIVE, 2=TO_BE_DELETED, 3=ELIGIBLE_FOR_EXPIRATION, 4=RESTORABLE
14 Fragment Size 131072  Shown in bytes
15 Delete Header 1  
16 Fragment ID A00001  
17 Snap Mount Host *NULL*  
18 Media Description *NULL* Can contain the snapshot information, or the Disk Pool information (helpful for Replication Director or other SLP Managed Snapshots)



Here is an example of the -U output when using NetBackup 10.2:


# nbstlutil list -backupid nbmaster1_1376070449 -U


Image:
 Master Server                 : MASTERSERVER
 Backup ID                     : nbclient1_1386088762
 Client                        : nbclient1
 Backup Time                   : 1386088762 (Tue Dec 03 11:39:22 2013)
 Policy                        : POLICY_NAME
 Client Type                   : 0
 Schedule Type                 : 0
 Storage Lifecycle Policy      : SLP_NAME
 Storage Lifecycle State       : 3 (COMPLETE)
 Storage Lifecycle Is Inactive : false
 Time In Process               : 0 (Wed Dec 31 19:00:00 1969)
 Data Classification ID        : (none specified)
 Version Number                : 1
 OriginMasterServer            : (none specified)
 OriginMasterServerID          : 00000000-0000-0000-0000-000000000000
 Import From Replica Time      : 0 (Wed Dec 31 19:00:00 1969)
 Required Expiration Date      : 0 (Wed Dec 31 19:00:00 1969)
 Created Date Time             : 1386088763 (Tue Dec 03 11:39:23 2013)

 Copy:
   Master Server       : MASTERSERVER
   Backup ID           : nbclient1_1386088762
   Copy Number         : 1
   Copy Type           : 0 (BACKUP)
   Expire Time         : 1387298362 (Tue Dec 17 11:39:22 2013)
   Expire LC Time      : 1387298362 (Tue Dec 17 11:39:22 2013)
   Try To Keep Time    : 1387298362 (Tue Dec 17 11:39:22 2013)
   Residence           : stu_hcart2-robot-tld-0
   Copy State          : 5 (COPYCOMPLETE)
   Job ID              : 68
   Retention Type      : 0 (FIXED)
   MPX State           : 0 (FALSE)
   RetryCount          : 0
   Last Retry Time     : 1386088865 (Tue Dec 03 11:41:05 2013)
   Source              : 0
   Destination ID      : (none specified)
   Replica:            : 0
   DataFormat          : 1 (DF_TAR)
   SLP Index           : 1

   Fragment:
     Master Server     : MASTERSERVER
     Backup ID         : nbclient1_1386088762
     Copy Number       : 1
     Fragment Number   : 1
     Resume Count      : 0
     Media ID          : E00123
     Media Server      : MEDIASERVER
     Storage Server    : (none specified)
     Media Type        : 2 (RMEDIA)
     Media Sub-Type    : 1 (BASIC)
     Fragment State    : 1 (ACTIVE)
     Fragment Size     : 102432768
     Delete Header     : 0
     Fragment ID       : E00123
     Snap MountHost    : (none specified)
     Media Description : (none specified)
    
 Copy:
   Master Server       : MASTERSERVER
   Backup ID           : nbclient1_1386088762
   Copy Number         : 2
   Copy Type           : 1 (DUPLICATE)
   Expire Time         : 1387298362 (Tue Dec 17 11:39:22 2013)
   Expire LC Time      : 1387298362 (Tue Dec 17 11:39:22 2013)
   Try To Keep Time    : 1387298362 (Tue Dec 17 11:39:22 2013)
   Residence           : stu_advdisk
   Copy State          : 5 (COPYCOMPLETE)
   Job ID              : 71
   Retention Type      : 0 (FIXED)
   MPX State           : 0 (FALSE)
   RetryCount          : 2
   Last Retry Time     : 1386089859 (Tue Dec 03 11:57:39 2013)
   Source              : 1
   Destination ID      : (none specified)
   Replica:            : 0
   DataFormat          : 1 (DF_TAR)
   SLP Index           : 2

   Fragment:
     Master Server     : nbmaster1
     Backup ID         : nbclient1_1386088762
     Copy Number       : 2
     Fragment Number   : 1
     Resume Count      : 2
     Media ID          : @aaaab
     Media Server      : MEDIASERVER
     Storage Server    : (none specified)
     Media Type        : 0 (DISK)
     Media Sub-Type    : 6 (STSDYNAMIC)
     Fragment State    : 1 (ACTIVE)
     Fragment Size     : 102432768
     Delete Header     : 0
     Fragment ID       : @aaaab
     Snap MountHost    : (none specified)
     Media Description : 1;AdvancedDisk;MEDIASERVER;DISKPOOL;Z:\;0

Was this content helpful?