DOCUMENTATION: What are the different fields in "bpimagelist -l" output?

Problem

DOCUMENTATION: What are the different fields in "bpimagelist -l" output?

Solution

Manuals:
NetBackup™ 6.0 Commands for UNIX and Linux, pages 132-138
NetBackup™ 6.0 Commands for Windows, pages 125-131
NetBackup™ 6.5 Commands for UNIX and Linux, pages 137-144
NetBackup™ 6.5 Commands for Windows, pages 131-137
Symantec NetBackup™ 7.0 Commands for UNIX, Windows and Linux, pages 148-155
Symantec NetBackup™ 7.1 Commands Reference Guide for UNIX, Windows and Linux, pages 160-167
Symantec NetBackup™ 7.5 Commands Reference Guide for UNIX, Windows and Linux, pages 166-173
Symantec NetBackup™ 7.6 Commands Reference Guide for UNIX, Windows and Linux, pages 161-169

Modification type:  Supplement

Modification:
The following entries appear in the output of the bpimagelist -l command.  The entries for the IMAGE and FRAG lines are in the charts below.  The HISTO line should always be -1 for all values.

# /usr/openv/netbackup/bin/admincmd/bpimagelist -l

IMAGE client_name, date1, date2, version, backupid, policy_name, client_type, proxy_client, creator, sched_label, sched_type, retention, backup_time, elapsed, expiration, compression, encryption, kbytes, num_files, copies, num_fragments, files_compressed, files_file, version, name1, options, primary, image_type, tir_info, tir_expiration, keywords, mpx, ext_security, raw, dump_lvl, fs_only, prev_BItime, BIfull_time, obj_desc, requestID, backup_stat, backup_copy, prev_image, jobid, num_resumes, resume_expr, ff_size, pfi_type, image_attrib[, ss_classification_id, ss_name, ss_completed, snap_time[, slp_version[, remoteExpiration, origin_master_server, origin_master_guid[, ir_enabled, client_charset, hold, indexing_status]]]]

HISTO -1 -1 -1 -1 -1 -1 -1 -1 -1 -1

FRAG copy_num, frag_num, KB, remainder, media_type, density, file_num, id/path, host, block_size, offset, media_date, dev_written, f_flags, media_desc/f_unused1, expiration, mpx, ret_level, checkpoint, resume_nbr, media_seq_no, media_subtype/unused4, ss_try_to_keep_date/unused3, copy_date/unused2, fragment_state/unused1[[, data_format], kms_key_tag[, slp_dest_tag[, mirror_parent, copy_on_hold]]]

 

The different fields in the IMAGE entry are:

FieldField HeaderExampleDescription
1Record HeaderIMAGE 
2Client NamemyclientThe name of the client being backed up.
3Date10 
4Date20 
5Version7The version id of the image data format: 7 = NetBackup 5.0 - 6.0, 8 = NetBackup 6.5 - 7.1, 9 = NetBackup 7.5 and later.
6Backup IDmyclient_1115034756The Backup ID recorded in the Image Database
7Class NamemypolicyThe name of the policy associated with this backup.
8Client Type13The type of client: 0 = STANDARD, 1 = PROXY, 2 = NONSTANDARD, 3 = APOLLO_WBAK, 4 = ORACLE, 6 = INFORMIX, 7 = SYBASE, 8 = MAC, 9 = WINDOWS, 10 = NETWARE, 11 = BACKTRACK, 12 = AUSPEX FASTBACKUP, 13 = WINDOWS NT, 14 = OS2, 15 = SQL SERVER, 16 = EXCHANGE, 17 = SAP, 18 = DB2, 19 = NDMP, 20 = FLASHBACKUP, 21 = SPLIT-MIRROR, 22 = AFS, 23 = DFS, 25 = LOTUS_NOTES, 26 = NCR_TERADATA, 27 = VAX_VMS, 28 = HP3000_MPE, 29 = FLASHBACKUP WINDOWS, 30 = VAULT, 31 = BE SQL SERVER, 32 = BE EXCHANGE, 33 = MACINTOSH, 34 = DISK STAGING,  35 = NBU CATALOG, 36 = GENERIC, 37 = CMS DB, 38 = PUREDISK EXPORT, 39 = ENTERPRISE VAULT, 40 = VMWARE, 41 = HYPER-V, 42 = NBU SEARCH.
9Proxy Client*NULL* 
10CreatorrootThe user who started the backup.
11Schedule LabelIncr_bkupThe name of the schedule that wrote the original backup.
12Schedule Type1The type of schedule: 0 = Full, 1 = Differentail Incremental, 2 = User Backup, 3 = User Archive, 4 = Cumulative Incremental.
13Retention Level3The Retention Level of the backup: 0 - 24 (use bpretlevel -l to see the Retention Period that corresponds to the Retention Level).
14Backup Time (Image Directory Name)1115034756The time that the backup started. This is a UNIX time value (number of seconds since Jan 1st 1970). Use bpdbm -ctime to get date and time.
15Elapsed Time in Seconds46How long the backup took to run to completion.
16Expiration (Image)1116244356The expiration time of the next copy of the image to expire. This is a UNIX time value (number of seconds since Jan 1st 1970). Use bpdbm -ctime to get date and time.
17Compression00 = Software Compression not used, 1 = Software Compression used.
18Encryption00 = Encryption not used, 1 = Encryption used.
19Kbytes Written5612The number of Kbytes backed up.
20Number of Files15The number of files backed up.
21Copies1The number of copies. A value greater than 1 indicates that the image has been duplicated.
22Number of Fragments2The number of fragments in all copies of the backup image.
23Files File Compressed00 = Files File is not Compressed, 1 = Files File is Compressed.
24Files Filemyclient_1115034756.INCR.fThe name of the Files File in the image database.
25Software Version*NULL* 
26Name1*NULL* 
27bpimagelist Input Options0 
28Primary Copy1Primary Copy number (this is the copy that is used by default for restores and duplications).
29Image Type00 = REGULAR or Normal Backup, 1 = PRE_IMPORT or Phase 1 import of this image is completed, 2 = IT_IMPORTED or Phase 2 import of this image is completed, this also means that an imported image was backed up.
30True Image Recovery Info00 = True Image Recovery was not used, 1 = True Image Recovery was used.
31True Image Recovery Expiration0The expiration date for the True Image Recovery (TIR) data. This is a UNIX time value (number of seconds since Jan 1st 1970). Use bpdbm -ctime to get the date and time. Zero if TIR was not used.
32Keywords*NULL*The keyword associated with the policy, NULL = no keyword used.
33MPX00 = Multiplexing was not used, 1 = Multiplexing was used.
34Extended Security Info00 = Extended security info not used, 1 = Extended security info was used.
35Individual File Restore from Raw00 = Not used, this only applies to Auspex FastBackup and Flashbackup type classes.
36Image Dump Level0Dump level for NDMP incremental backups.
37File System Only0This is a flag used for restores.
38Previous Block Incremental Time0Used for BLIB, 0 = NOT used, else previous BLIB backup time.
39Block Incremental Full Time0Used for BLIB, 0 = NOT used, else current BLIB backup time.
40Object Description*NULL* 
41Request ID0 
42Backup Status0Backup exit status: 0 = Successful, 150 = Administrator terminated, etc...
43Backup Copy0Backup copy type: 0 = Normal, 1 = 3rd Party Copy, 2 = Media Server Copy, 3 = NAS Copy, 4 = Persistent Frozen Image, 5 = NDMP Copy.
44Prev Backup Image*NULL*Used for Synthetic Backups. The backup id of the previous backup for the client in the policy.
45Job ID703The job ID.
46Number of Resumes0 
47Resume Expiration0 
48Files File Size348The Files File size in bytes.
49PFI Type0 
50Image Attribute0 

In NetBackup 6.5, storage lifecycles were introduced.  Additional fields were added to bpimagelist output:
FieldField HeaderExampleDescription
51Data Classification ID(a long hexadecimal value)ID value corresponding to Data Classification selected (for example, "Platinum").
52Storage Lifecycle PolicySLP_nameThe name of the Storage Lifecycle Policy (SLP), if used.
53STL_Completed3The status of the Storage Lifecycle processing for the image: 0 = NOT SLP MANAGED, 1 = NOT STARTED, 2 = IN PROCESS, 3 = COMPLETED.
54Snap Time0The creation date of the snapshot (if applicable). This is a UNIX time value (number of seconds since Jan 1st 1970). Use bpdbm -ctime to get date and time.


In NetBackup 6.5.5, one more field was added:
FieldField HeaderExampleDescription
55SLP Version1"Version" number of the SLP policy

In NetBackup 7.1, Automatic Image Replication (AIR) was introduced, and three more new fields were added, which are only used by AIR:
FieldField HeaderExampleDescription
56Remote Expiration1299000000Remote copy expiration time. This is a UNIX time value (number of seconds since Jan 1st 1970). Use bpdbm -ctime to get date and time.
57Origin Master ServernbumasterHostname of the original master server.
58Origin Master GUID Long string denoting the GUID of the original master server.

In NetBackup 7.5, the following fields were added:
FieldField HeaderExampleDescription
59IR Enabled10 = Instant Recovery not used, 1 = Catalog this snapshot for later use by Instant Recovery or SLP.
60Client Character Set1Integer representation of the charset used when the client calls bpcd.
61Image on Hold00 = No copies on hold, non-zero = Binary representation of which copy/copies are marked for legal hold.
62Indexing Status0File system metadata associated with the backup image may be indexed for NetBackup Search: 0 = NOT_ENABLED, 1 = ENABLED, 2 = COMPLETED, 3 = FAILED.



The different fields in the FRAG entry are:
FieldField HeaderExampleDescription
1Record HeaderFRAG 
2Copy Number1The copy number. Default: 1 for the first copy, 2 for the second copy, etc.
3Fragment Number1The fragment number within the backup copy. A fragment of -1 indicates it is a TIR fragment. In 7.1 and later, a fragment number of -2147482648 denotes it is an AIR fragment.
4Kilobytes32The size in Kbytes of the fragment.
5Remainder0The remainder in bytes.
6Media Type2The media type of the fragment. This is a numeric value that indicates the type of media used: 0 = Disk, 1 = Unitree, 2 = Tape, 3 = NDMP, 5 = Checkpoint, 6 = Disk Staging.
7Density13If the copy was written to tape, this is a numeric value that indicates the type of media that was used: 6 = HCART, 13 = DLT, 14 = HCART2, 15 = DLT2, 16 = 8MM, 17 = 8MM2, 19 = DTF, 20 = HCART3, 21 = DLT3, 22 = 8MM3.
8File Number48The file number. This is a numeric value that indicates the file number on the media. This number will be displayed in the Activity Monitor under the Job Detailed Status as "positioning to file".
9ID/PathA00001The Media ID or Basic Disk disk path that the backup was written to. Disk backup types other than Basic Disk display a Media ID of the form "@xxxxxx".
10Hostserver1The media server that wrote the backup. This is the hostname of the media server.
11Block Size65536The block size used when writing the backup.
12Offset155The block offset of the start of the fragment on the media.
13Media Date1112641625The media date. This is the "Assign Time" of this media when the image was written. This is a UNIX time value (number of seconds since Jan 1st 1970). Use bpdbm -ctime to get date and time.
14Device Written On2The device that the copy was written on. This is the tape drive index, or -1 for disk based backups.
15f_flags0This is an internal flag, and should always be 0.
16Media Descriptor*NULL*In 6.x and later, disk based backup location information. In 5.x, this should always be 0.
17Expiration1116244356The expiration time of the image. This is a UNIX time value (number of seconds since Jan 1st 1970). Use bpdbm -ctime to get date and time.
18MPX0A value of 0 indicates multiplexing was not used. A value of 1 indicates multiplexing was used.
19Retention Level65537The Retention Level of the image copy, plus 65536.
20Checkpoint0 
21Resume NBR0 
22Media Seq #0 
23Media Subtype1In 6.x, type of Disk Storage Unit. In 5.x, this should always be 0.
24Try to Keep Time0In 6.5 and above, for the first fragment of each copy - expiration date for capacity-managed copies written using a Storage Lifecycle Policy, otherwise 0. This is a UNIX time value (number of seconds since Jan 1st 1970). Use bpdbm -ctime to get date and time. In 5.x and 6.0, this should always be 0.
25Copy Creation Time1201888951In 6.5 and above, for the first fragment of each copy - the time that the copy was written, otherwise 0. This is a UNIX time value (number of seconds since Jan 1st 1970). Use bpdbm -ctime to get date and time. In 5.x and 6.0, this should always be 0.
26Unused10In 7.1 and earlier, this field is unused and should always be 0.

In NetBackup 6.5.2, the following field was added for the Key Management System (KMS): 
FieldField HeaderExampleDescription
27Key Tag*NULL*KMS Key.

In NetBackup 6.5.5, one more field was added for SLP: 
FieldField HeaderExampleDescription
28STL tag*NULL*SLP Destination Name.

In NetBackup 7.5, the usage of field #26 was changed, three additional fields were added, and the position of the "KMS Key" and "SLP Destination" values were moved to new locations, as follows:
FieldField HeaderExampleDescription
26Fragment State1SLP Fragment State: 1 = ACTIVE, 2 = TO BE DELETED, 3 = ELIGIBLE FOR EXPIRATION.
27Data Format1Backup Data Format: 1 = TAR, 2 = SNAPSHOT, 3 = NDMP.
28Key Tag*NULL*KMS Key.
29STL Tag*NULL*SLP Destination Name.
30Mirror Parent0Mirror Parent Copy Number.
31Copy On Hold0Copy Hold Status: 0=Not On Hold, 1=On Hold, ?=Unknown.

 

 


Terms of use for this information are found in Legal Notices.

Search

Survey

Did this article answer your question or resolve your issue?

No
Yes

Did this article save you the trouble of contacting technical support?

No
Yes

How can we make this article more helpful?

Email Address (Optional)