JPSS Common Ground System Document Versioning - Update Milt Panas May 10, 2011 JPSS CGS Form J /22/2010

JPSS Common Ground System Page 2  Issue – Data Product Document Versioning  Description –For Data products archived in CLASS, can the product format documentation be easily retrieved years after the product was created?  Example –Let's say an SST product for a particular day (e.g. Jan 1, 2012) was generated using Mx5 and archived in CLASS. Ten years later, the SST algorithm and associated format documents (CDFCB-X) have been updated 3 times, but someone goes back and retrieves the SST from Jan 1, The current CDFCB-X doesn't describe the Mx5 version of the SST. Can the Mx5 version of the CDFCB-X be easily identified and retrieved. Issue Description

JPSS Common Ground System Page 3  Data Product Metadata –N_Software_Version - Version of IDPS software that created the Data Product.... Example: I –N_Algorithm_Version - Indicates the version number of the algorithm... Example: 1.O –N_NPOESS_Document_Ref - Provides an array of strings containing the filename of the documentation relevant to the algorithm that produced the particular data product – includes CDFCB-X, NPOESS Data Product Profile XML, and OAD filenames D _NPOESS-CDFCB-X-Vol-IV-Part-2_E_ _I1.5.0.pdf,D _NPOESS-CDFCB-X-Vol-IV-Part-2_E_CrIMSS-EDR-PP.xml,D37021_OAD-CrIMSS- EDR_B_ _I1.5.0.pdf  Version Description Document (VDD) –Based on Software version Example: VD I A IDPS SW NPP OPS VDD.docx –N_Algorithm_Version is listed in the VDD  Release Packages –Created based on Software Version (same as N_Software_Version) Contains Software and Documentation (except ITAR and FOUO) –Archived in CLASS –Use the Software Version number to find the Documentation in CLASS Response

JPSS Common Ground System Page 4  Issue – Updates to previously released Documents  Description –For Data products archived in CLASS, can the product format documentation be easily Updated years after the product/Documentation were created if an error is found?  Example –Previous example SST product for a particular day (e.g. Jan 1, 2012) was generated using Mx5 and archived in CLASS. Ten years later, an error is found in the associated format documents (CDFCB-X). Can the Mx5 version of the CDFCB-X be easily updated. Related Issue Description

JPSS Common Ground System Page 5  No existing process for this  Possible solution –Revision update and re-release Update the old revision (e.g. Rev A) of the CDFCB-X to make the update. Number the revision to indicate its an update (e.g. Rev A.1) Release packages have a versioning mechanism for updates to the package (-n) –Example –Software Release package I has Rev A of the CDFCB-X Vol. VI Part 2. Ten years later, we find an error in the CDFCB-X volume that needs to be fixed. Update CDFCB-X Vol. VI Part 2 to Revision A.1 Update the Document VDD in the Release package Update the SW Release package as I containing the CDFCB-X Vol. VI Part 2 Rev A.1 –Updated Release package is archived in CLASS (this needs to be worked) –Use the same Software Version number to find the updated Documentation in CLASS  N_NPOESS_Document_Ref –This includes the exact filename of the CDFCB-X Volume. If a change is made to a Revision, from A to A.1, the document references in this Metadata on all the delivered products will be obsolete. –It would not be possible to update all delivered copies of the products Solution

JPSS Common Ground System Page 6  Possible Updated solution –Change the definition of the N_NPOESS_Document_Ref Metadata. Instead of exact filenames, use document numbers and generic names. When a Revision update is made form A to A.1, the document number and generic name stays constant Users will need to use the Document number and Software version to find the correct revision of the document –CLASS Update When CLASS ingests a Release package, a “key” may be needed that links the SW Version and the Document Number –Example Release package I has CDFCB-X Vol. VI Part 2 Rev A N_NPOESS_Document_Ref = DOC: D NPOESS-CDFCB- X-Vol-IV-Part-2; XML: D NPOESS-CDFCB-X-Vol-IV-Part-2 CrIMSS-EDR-PP; OAD: D37021 OAD-CrIMSS-EDR Release package I changes CDFCB-X Vol. VI Part 2 Rev A.1 N_NPOESS_Document_Ref is still valid (May need to adjust XML document numbers) In CLASS – Document can be found as: I D Updated Solution