Description
The nbstlutil command can be found in /usr/openv/netbackup/bin/admincmd (UNIX) or <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 listV7.5.0 I nbmaster1 nbmaster1_1376070449 nbmaster1 1376070449 POLICYNAME 13 0 SLPNAME 3 1376070877 Platinum 1 00000000-0000-0000-0000-000000000000 0 0 1376070453
V7.5.0 C nbmaster1 nbmaster1_1376070449 1 1400176049 1400176049 nbmaster1-hcart2-robot-tld-0 3 85 0 1 0 *NULL* 1400176049 1376070664 1400176049 0 0 0 1 1
V7.5.0 F nbmaster1 nbmaster1_1376070449 1 1 0 E01005 nbmaster1 *NULL* 2 1 1 0 0 E01005 *NULL* *NULL*
V7.5.0 F nbmaster1 nbmaster1_1376070449 1 2 0 E01005 nbmaster1 *NULL* 2 1 1 0 0 E01005 *NULL* *NULL*
V7.5.0 F nbmaster1 nbmaster1_1376070449 1 3 0 E01005 nbmaster1 *NULL* 2 1 1 30780416 0 E01005 *NULL* *NULL*
V7.5.0 C nbmaster1 nbmaster1_1376070449 2 1400176049 0 STU_ADV_DISK 3 90 1 0 1 *NULL* 1400176049 1376070990 1400176049 1 1 0 1 2
V7.5.0 F nbmaster1 nbmaster1_1376070449 2 1 1 @aaaab nbmaster1 *NULL* 0 6 3 30539776 0 @aaaab *NULL* 1;AdvancedDisk;nbmaster1;DP_ADVDISK_NBMASTER1;S:\;0
The different fields in the IMAGE entry are:
| Field | Field Header | Example | Description |
|---|---|---|---|
| 1 | Version | V7.5.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, 1=Differential, 4=Cumulative |
| 10 | Storage Service (Lifecycle) name | testcycle | |
| 11 | Storage Service (Lifecycle) State | 1 | 1=NOT_STARTED, 2=IN_PROCESS, 3=COMPLETE, 0=NOT_MANAGED, 9=NOT_STARTED_BUT_INACTIVE, 10=IN_PROCESS_BUT_INACTIVE |
| 12 | Time In Process | 0 | Time when state was changed to "2" (IN_PROCESS) |
| 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.5.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 | 2147483647 | ctime value |
| 7 | Try to Keep time | 1234567890 | for "Capacity Managed" copies; may show the true expiration when the source copy is being kept at INFINITE retention for duplication purposes |
| 8 | Destination | my_adv_disk | Name of storage unit |
| 9 | Duplication Status | 3 | 1=NOT_STARTED, 2=IN_PROCESS, 3=COMPLETE, 4=DELETED, 5=STORAGE_SERVICE_STATE_NA(not available), 9=NOT_STARTED_BUT_INACTIVE, 10=IN_PROCESS_BUT_INACTIVE 14=IMPORT PENDING (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 | 2147483647 | |
| 16 | Last Retry Time | 1234567891 | |
| 17 | Expire Time | 2147483647 | |
| 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.5.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 7.5:# nbstlutil list -backupid nbmaster1_1376070449 -UImage:
Master Server : nbmaster1
Backup ID : nbmaster1_1376070449
Client : nbmaster1
Backup Time : 1376070449 (Fri Aug 09 13:47:29 2013)
Policy : POLICYNAME
Client Type : 13
Schedule Type : 0
Storage Lifecycle Policy : SLPNAME
Storage Lifecycle State : 2 (IN_PROCESS)
Time In Process : 1376070877 (Fri Aug 09 13:54:37 2013)
Data Classification ID : Platinum
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 : 1376070453 (Fri Aug 09 13:47:33 2013)
Copy:
Master Server : nbmaster1
Backup ID : nbmaster1_1376070449
Copy Number : 1
Copy Type : 0 (BACKUP)
Expire Time : 2147483647 (Mon Jan 18 22:14:07 2038)
Expire LC Time : 2147483647 (Mon Jan 18 22:14:07 2038)
Try To Keep Time : 1400176049 (Thu May 15 13:47:29 2014)
Residence : nbmaster1-hcart2-robot-tld-0
Copy State : 3 (COMPLETE)
Job ID : 85
Retention Type : 0 (FIXED)
MPX State : 1 (TRUE)
RetryCount : 0
Last Retry Time : 1376070664 (Fri Aug 09 13:51:04 2013)
Source : 0
Destination ID : (none specified)
Last Retry Time : 1376070664
Replica: : 0
DataFormat : 1 (DF_TAR)
SLP Index : 1
Fragment:
Master Server : nbmaster1
Backup ID : nbmaster1_1376070449
Copy Number : 1
Fragment Number : 1
Resume Count : 0
Media ID : E01005
Media Server : nbmaster1
Storage Server : (none specified)
Media Type : 2 (RMEDIA)
Media Sub-Type : 1 (BASIC)
Fragment State : 1 (ACTIVE)
Fragment Size : 30780416
Delete Header : 0
Fragment ID : E01005
Snap MountHost : (none specified)
Media Description : (none specified)
Copy:
Master Server : nbmaster1
Backup ID : nbmaster1_1376070449
Copy Number : 2
Copy Type : 1 (DUPLICATE)
Expire Time : 2147483647 (Mon Jan 18 22:14:07 2038)
Expire LC Time : 2147483647 (Mon Jan 18 22:14:07 2038)
Try To Keep Time : 1384105649 (Sun Nov 10 12:47:29 2013)
Residence : STU_ADV_DISK
Copy State : 2 (IN_PROCESS)
Job ID : 90
Retention Type : 1 (CAPACITY_MANAGED)
MPX State : 0 (FALSE)
RetryCount : 1
Last Retry Time : 1376070878 (Fri Aug 09 13:54:38 2013)
Source : 1
Destination ID : (none specified)
Last Retry Time : 1376070878
Replica: : 0
DataFormat : 0 (DF_UNDEFINED)
SLP Index : 2
In the Netbackup 6.5.5 release update, the Version feature was introduced, allowing for images in process to retain the prior Lifecycle configuration options. The version number is added as the 14th field for the IMAGE record listing from nbstlutil, (example below and noted in table above):
# nbstlutil list -backupid client-name_1266872694
V6.5 I masterserver-name client-name_1266872694 client-name 1266872694 Lifecycle_WindowsNT 13 1 daily-1-3 1 0 *NULL* 1
V6.5 C masterserver-name client-name_1266872694 1 2147483647 1266915894 *NULL* 3 0 0 0 0 *NONE* 2 147483647
V6.5 F masterserver-name client-name_1266872694 1 -1 0 @aaaak mediaserver-name *NULL* 0 6 1 14403 1 @aaaak
V6.5 F masterserver-name client-name_1266872694 1 1 0 @aaaak mediaserver-name *NULL* 0 6 1 39936 1 @aaaak
See the Netbackup 6.5.5 Documentation Updates (linked below) for more information on "Version-ing".
Attachments
Was this content helpful?
Translated Content
Please note that this document is a translation from English, and may have been machine-translated. It is possible that updates have been made to the original version after this document was translated and published. Veritas does not guarantee the accuracy regarding the completeness of the translation. You may also refer to the English Version of this knowledge base article for up-to-date information.