First Registry Users Workshop - Tuesday, 6/28

[jordanpadams]

Dear PDS Registry Users,

The first monthly Registry User Workshop is happening Tuesday, June 28, 2022 at 9:05AM
PDT.

Scope of the Workshop

The workshop is intended to be a demo/hands-on training where at the end of the session, you
should have some data ingested and published in your Node’s registry and accessible to the
public. We plan to work with node personnel to debug any issues in real-time. Additionally, we
would like this workshop to be both a training and a Q&A where node technical staff have an
opportunity to ask questions in a forum that is more conducive to detailed technical discussions.
This workshop will not include a significant architecture or detailed overview of what the registry
is, why it exists, etc., since that has been presented at past management council and various
working group meetings. If you would like a refresher on that material, please see the reference
material at the end of this email.

If you have questions or concerns about the material we plan to present, or have additional information or details you would like us to discuss during this workshop, please let us know.

Who Should Participate

Any node personnel are welcome to follow along with the presentation. If you wish to participate in the hands-on training, please coordinate with your node personnel accordingly in setting up the tools and selection of data sets, as will be discussed later in this email.

For Hands-on Training Participants

Workshop Pre-Requisites:

By Monday 12pm Pacific (6/27/22)
We need some more information from you to ensure we are ready to help debug issues and
double-check our network configurations:

• Name and Node: Let us know if you plan on participating in the hands-on training, and
  the node to which you are affiliated.

• Execution IP Address: We would like to verify the IP address you will be connecting from matches the range we have configured on your registry.

  a. Log into your Node’s machine you plan to run the Registry Tools from, within your Institution’s network. We cannot allow access to the registry from personal laptops or workstations outside your institution’s network.

  b. Run curl on the following URL to get your IP:

curl http://checkip.amazonaws.com

Note: This requires curl to be installed on your machine. This is also a prerequisite for debugging purposes when utilizing the registry and API.

• Bundle LIDVID: For the training, you will need a valid PDS4 Bundle at the ready to load into your registry. This bundle should be on the machine you plan to run Harvest (and just got the IP of). If you have more than 1 person at your node planning to execute the tutorial, please coordinate with them to use different bundles. This bundle must adhere to the following requirements:
  a. The bundle must be valid. Please check with your team to ensure the bundle you are attempting to load has been validated successfully.
  b. The bundle must be accessible online. There must be an existing web address to your bundle.
  c. The bundle must be unique and not already registered in your registry. Check with other folks on your team that you select unique bundles, and for those individuals who have already ingested some data, be sure to check that the bundle has not already been ingested. If you do not have a bundle that meets these criteria, or would simply prefer to ingest some test data for the time being, just let us know and we can supply you with a test bundle. We will provide the commands to delete any test bundles after the workshop.

Anytime prior to the start of the workshop:

• Install the Registry Loader Tools on the system used above by following instructions at https://nasa-pds.github.io/registry/install/tools.html. Standalone Harvest and Registry Manager are the only tools needed for this workshop. All other tools mentioned in the documentation (Harvest Client, Supplementer, Scalable Harvest, etc.) are for more advanced usage, and are only needed in specific use cases. We will work with individual nodes on a case-by-case basis when those tools are needed.

• Install the Webex Desktop application (optional): This will give you more flexibility to navigate to a break room if we encounter significant difficulties debugging issues in real-time. https://www.webex.com/downloads.html

Questions on Installation?

The preferred method of the Registry Discussion Board on Github, however, email pds-registry@jpl.nasa.gov is also always available.

Please let us know if you have any additional questions.

Thanks,
EN Team

Reference Materials

• Registry documentation
• Registry 101 presentation from March 2021
• Registry Intro from JUICE Workshop from May 2021
• Data Services Update from Nov 2021 (includes AWS architecture)

[jordanpadams]

Hello everyone, thanks to all that attended the workshop today. Here is some wrap-up information:

• Wiki page for the Demo/tutorial steps: https://github.com/NASA-PDS/registry/wiki/Registry-Workshop---06-28-2022
• Recording: https://jpl.webex.com/jpl/ldr.php?RCID=5e8a6ef8c4de62963b71ab22f39f0964

Additionally, here are some of the new requirements/enhancements created from the discussions:

• As a user, I want my registry authorization information to be securely managed on the file system registry-loader#17
• As a user, I want to view more detailed documentation on the Registry schema #75
• Timeout errors when internet connection is unstable registry-loader#19
• Missing numerous JSON files from PDS4 releases within the last 2 years registry-loader#20
• As a user, I want to update 1 or more metadata values in the registry registry-loader#21