Skip to content

B12.0 Beta Testing

Jordan Padams edited this page Oct 31, 2021 · 3 revisions

Overview

Welcome to the PDS Engineering Node B12.0 Beta Testing portal. Below is all the information you will need on beta testing the PDS4 Information Model, and several tools and services that have been improved since the last build.

Please test and report any identified issues by end of day November 12, 2021, or earlier if possible.

For more information on all the updates completed in this build, you can checkout our Release Description Document here. Additionally, our Software Build Summary contains links to all the software in the EN Software Catalog and their accompanying user guides.

Please test and report any identified issues by end of day November 12, 2021, or earlier if possible.

Our plan is to incorporate your findings into Build 12.0 System Release scheduled for December 3, 2021.

Please feel free to contact us if you have any questions.

PDS4 Information Model

Below are links to applicable documentation for updates implemented for PDS4 Information Model v1.17.0.0 (1H00).

Please report all problems by creating tickets at https://github.com/NASA-PDS/pds4-information-model/issues

Tools and Services

Here are the tools and services we are most highly prioritizing for beta testing. If you would like to test additional tools/services, see our Release Description Document for more details on all the other components that were worked on over this build period.

NOTE: As issues are identified and fixed, new versions of the software will be released. Watch the repository to get notified of new releases, by clicking the "Watch" dropdown in the top right corner of the github repository.

Tool Description User's Guide Download Changelog Feedback
LDDTool The software tools and data necessary for generating the Information Model including PDS4 ontology, data, and information model. 🔍 💾 👣 📝
Validate Validates PDS4 product labels, data and PDS3 Volumes 🔍 💾 👣 📝
PDS Registry + API Registry application enabling a PDS node to register all its data products for long term preservation and sharing with the rest of the PDS system. 🔍 💾 👣 📝

Discipline LDDs

Pull requests should already be created in your repos with the new IM added to your builds (updated pds4_versions.txt). A how-to guide on reviewing a pull request can be found here: https://pds-data-dictionaries.github.io/development/ldd-how-to.html#reviewing-a-pull-request

If the build failed (red X next to the commit), this means something went wrong. Head the Actions tab to see what went wrong.

If the build was successful (green checkmark next to commit), this means everything built and validated as expected. Please review the branch and the generated LDDs to verify they were generated as expected.

Once you have completed your review and everything builds successfully, feel free to approve and merge the pull request. Once merged, this new version of the LDD will be automatically included in the new PDS Data Dictionaries web page when the IM is released.

NOTE: Only the v1.17.0.0 (1H00) version of the LDD will be released with the IM. If you would like the LDD released for other IM versions, you will need to submit a request for the other versions here.

Testing Tips

Validate

Since the PDS4 Information Model is a "candidate" release, updates are deployed into develop directories through the beta testing and I&T lifecycle. When attempting to test with validate, there are a few ways you can "point" your labels towards this candidate release of the IM:

  1. Specify the schemas / schematron via command-line, e.g.
# Assuming you have downloaded the schema and schematron to your current directory where you are running validate
validate -x PDS4_PDS_1H00.xsd -S PDS4_PDS_1H00.sch -t my_test_product.xml
  1. Use an XML Catalog file

  2. Update your schematron URLs and schemaLocation to point to the candidate release URLs (note: this will only work for :

<!-- Before -->
<?xml-model href="https://pds.nasa.gov/pds4/pds/v1/PDS4_PDS_1G00.sch"?>

<!-- After -->
<?xml-model href="https://pds.nasa.gov/datastandards/schema/develop/pds/PDS4_PDS_1H00.sch"?>

<!-- Before -->
 xsi:schemaLocation="http://pds.nasa.gov/pds4/pds/v1 
                     https://pds.nasa.gov/pds4/pds/v1/PDS4_PDS_1G00.xsd">

<!-- After -->
 xsi:schemaLocation="http://pds.nasa.gov/pds4/pds/v1 
                     https://pds.nasa.gov/datastandards/schema/develop/pds/PDS4_PDS_1H00.xsd">