Upgrade rdf-toolkit and Java

[b0bkaT]

Background

Requirements

Requirement 1

The CI currently uses rdf-toolkit version 1.8, but version 1.10 is available. UCO should upgrade rdf-toolkit to version 1.10 and in turn upgrade to at least Java 11 (minimum requirement for using rdf-toolkit 1.10).

Risk / Benefit analysis

Benefits

UCO's CI will be utilizing the latest version of rdf-toolkit. Additionally, JRE 8 is end-of-life.

Risks

• Java 11 does not work on prior rdf-toolkit versions.
• All of UCO's and CASE resources that use rdf-toolkit currently inherit CASE's original adoption of rdf-toolkit. Hence, they currently require Java 8. So, this will have downstream effects - those repositories, and any adopters who followed the same practice, will need to rework their environments to include Java >= 11.
• According to various sources: the end-of-life for Java 11 is Sept. 30, 2023. So, this puts UCO in another near-EOL situation. Testing should be done to review rdf-toolkit compatibility with Javas > 11.

Competencies demonstrated

Competency 1

N/A

Solution suggestion

• Upgrade Java from v8 to v11 in CI workflow.
• Pin version 1.11.0 of rdf-toolkit using current lib/Makefile and recorded SHA2-512 hash.
• Revise all references to rdf-toolkit within CASE to use UCO as imported as a submodule. This is an expansion of responsibility of a UCO issue, creeping into CASE, but is seen as necessary to keep a shared technology synchronized.
• The solution is implemented for UCO in PR 398.
• The solution is implemented for CASE in PR 90.

Coordination

• Tracking in Jira ticket OC-235
• Administrative review to be completed
• Requirements to be discussed in Ontology Committee (OC) meeting, 2022-05-05
• Requirements Review vote occurred, passing, on 2022-05-17
• Requirements development phase completed.
• Solution announced to OCs on 2022-05-28
• Solutions Approval to be discussed in OC meeting, 2022-06-02
• Solutions Approval vote occurred, passing, on 2022-06-13
• Solutions development phase completed.
• Implementation for UCO merged into develop
• Implementation for CASE merged into develop
• Milestone linked in UCO
• Milestone linked in CASE
• Documentation logged in pending release page for UCO
• Documentation logged in pending release page for CASE

[ajnelson-nist]

Some discussion is happening w.r.t. risks. A comment will come when that's done being updated.

[ajnelson-nist]

Risks have been updated.

[ajnelson-nist]

Requirement 1 was revised to say we should upgrade to at least Java 11, not necessarily exactly Java 11.

[ajnelson-nist]

The solution is posted, and interestingly pre-commit caught a normalization update that observable.ttl needed.