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

Article:TECH5584  |  Created: 2000-01-15  |  Updated: 2013-12-20  |  Article URL http://www.symantec.com/docs/TECH5584
Article Type
Technical Solution


Environment

Subject

Issue



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:

Field Field Header Example Description
1 Record Header IMAGE  
2 Client Name myclient The name of the client being backed up.
3 Date1 0  
4 Date2 0  
5 Version 7 The 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.
6 Backup ID myclient_1115034756 The Backup ID recorded in the Image Database
7 Class Name mypolicy The name of the policy associated with this backup.
8 Client Type 13 The 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.
9 Proxy Client *NULL*  
10 Creator root The user who started the backup.
11 Schedule Label Incr_bkup The name of the schedule that wrote the original backup.
12 Schedule Type 1 The type of schedule: 0 = Full, 1 = Differentail Incremental, 2 = User Backup, 3 = User Archive, 4 = Cumulative Incremental.
13 Retention Level 3 The Retention Level of the backup: 0 - 24 (use bpretlevel -l to see the Retention Period that corresponds to the Retention Level).
14 Backup Time (Image Directory Name) 1115034756 The 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.
15 Elapsed Time in Seconds 46 How long the backup took to run to completion.
16 Expiration (Image) 1116244356 The 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.
17 Compression 0 0 = Software Compression not used, 1 = Software Compression used.
18 Encryption 0 0 = Encryption not used, 1 = Encryption used.
19 Kbytes Written 5612 The number of Kbytes backed up.
20 Number of Files 15 The number of files backed up.
21 Copies 1 The number of copies. A value greater than 1 indicates that the image has been duplicated.
22 Number of Fragments 2 The number of fragments in all copies of the backup image.
23 Files File Compressed 0 0 = Files File is not Compressed, 1 = Files File is Compressed.
24 Files File myclient_1115034756.INCR.f The name of the Files File in the image database.
25 Software Version *NULL*  
26 Name1 *NULL*  
27 bpimagelist Input Options 0  
28 Primary Copy 1 Primary Copy number (this is the copy that is used by default for restores and duplications).
29 Image Type 0 0 = 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.
30 True Image Recovery Info 0 0 = True Image Recovery was not used, 1 = True Image Recovery was used.
31 True Image Recovery Expiration 0 The 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.
32 Keywords *NULL* The keyword associated with the policy, NULL = no keyword used.
33 MPX 0 0 = Multiplexing was not used, 1 = Multiplexing was used.
34 Extended Security Info 0 0 = Extended security info not used, 1 = Extended security info was used.
35 Individual File Restore from Raw 0 0 = Not used, this only applies to Auspex FastBackup and Flashbackup type classes.
36 Image Dump Level 0 Dump level for NDMP incremental backups.
37 File System Only 0 This is a flag used for restores.
38 Previous Block Incremental Time 0 Used for BLIB, 0 = NOT used, else previous BLIB backup time.
39 Block Incremental Full Time 0 Used for BLIB, 0 = NOT used, else current BLIB backup time.
40 Object Description *NULL*  
41 Request ID 0  
42 Backup Status 0 Backup exit status: 0 = Successful, 150 = Administrator terminated, etc...
43 Backup Copy 0 Backup copy type: 0 = Normal, 1 = 3rd Party Copy, 2 = Media Server Copy, 3 = NAS Copy, 4 = Persistent Frozen Image, 5 = NDMP Copy.
44 Prev Backup Image *NULL* Used for Synthetic Backups. The backup id of the previous backup for the client in the policy.
45 Job ID 703 The job ID.
46 Number of Resumes 0  
47 Resume Expiration 0  
48 Files File Size 348 The Files File size in bytes.
49 PFI Type 0  
50 Image Attribute 0  

In NetBackup 6.5, storage lifecycles were introduced.  Additional fields were added to bpimagelist output:
Field Field Header Example Description
51 Data Classification ID (a long hexadecimal value) ID value corresponding to Data Classification selected (for example, "Platinum").
52 Storage Lifecycle Policy SLP_name The name of the Storage Lifecycle Policy (SLP), if used.
53 STL_Completed 3 The status of the Storage Lifecycle processing for the image: 0 = NOT SLP MANAGED, 1 = NOT STARTED, 2 = IN PROCESS, 3 = COMPLETED.
54 Snap Time 0 The 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:
Field Field Header Example Description
55 SLP Version 1 "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:
Field Field Header Example Description
56 Remote Expiration 1299000000 Remote copy expiration time. This is a UNIX time value (number of seconds since Jan 1st 1970). Use bpdbm -ctime to get date and time.
57 Origin Master Server nbumaster Hostname of the original master server.
58 Origin Master GUID   Long string denoting the GUID of the original master server.

In NetBackup 7.5, the following fields were added:
Field Field Header Example Description
59 IR Enabled 1 0 = Instant Recovery not used, 1 = Catalog this snapshot for later use by Instant Recovery or SLP.
60 Client Character Set 1 Integer representation of the charset used when the client calls bpcd.
61 Image on Hold 0 0 = No copies on hold, non-zero = Binary representation of which copy/copies are marked for legal hold.
62 Indexing Status 0 File 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:
Field Field Header Example Description
1 Record Header FRAG  
2 Copy Number 1 The copy number. Default: 1 for the first copy, 2 for the second copy, etc.
3 Fragment Number 1 The 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.
4 Kilobytes 32 The size in Kbytes of the fragment.
5 Remainder 0 The remainder in bytes.
6 Media Type 2 The 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.
7 Density 13 If 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.
8 File Number 48 The 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".
9 ID/Path A00001 The 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".
10 Host server1 The media server that wrote the backup. This is the hostname of the media server.
11 Block Size 65536 The block size used when writing the backup.
12 Offset 155 The block offset of the start of the fragment on the media.
13 Media Date 1112641625 The 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.
14 Device Written On 2 The device that the copy was written on. This is the tape drive index, or -1 for disk based backups.
15 f_flags 0 This is an internal flag, and should always be 0.
16 Media Descriptor *NULL* In 6.x and later, disk based backup location information. In 5.x, this should always be 0.
17 Expiration 1116244356 The 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.
18 MPX 0 A value of 0 indicates multiplexing was not used. A value of 1 indicates multiplexing was used.
19 Retention Level 65537 The Retention Level of the image copy, plus 65536.
20 Checkpoint 0  
21 Resume NBR 0  
22 Media Seq # 0  
23 Media Subtype 1 In 6.x, type of Disk Storage Unit. In 5.x, this should always be 0.
24 Try to Keep Time 0 In 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.
25 Copy Creation Time 1201888951 In 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.
26 Unused1 0 In 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): 
Field Field Header Example Description
27 Key Tag *NULL* KMS Key.

In NetBackup 6.5.5, one more field was added for SLP: 
Field Field Header Example Description
28 STL 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:
Field Field Header Example Description
26 Fragment State 1 SLP Fragment State: 1 = ACTIVE, 2 = TO BE DELETED, 3 = ELIGIBLE FOR EXPIRATION.
27 Data Format 1 Backup Data Format: 1 = TAR, 2 = SNAPSHOT, 3 = NDMP.
28 Key Tag *NULL* KMS Key.
29 STL Tag *NULL* SLP Destination Name.
30 Mirror Parent 0 Mirror Parent Copy Number.
31 Copy On Hold 0 Copy Hold Status: 0=Not On Hold, 1=On Hold, ?=Unknown.

 

 




Legacy ID



193085


Article URL http://www.symantec.com/docs/TECH5584


Terms of use for this information are found in Legal Notices