LinuxForHealth FHIR Server 5.1.0

This version of the LinuxForHealth FHIR Server supports HL7 FHIR versions 4.0.1 and 4.3.0.

This release fixes a 5.0.0 regression for resource types with long searchable strings and includes updates to validation and search paging.

Added

• DaVinci Payer Data Exchange (PDex) US Drug Formulary STU2
• Support for inheritance in FHIRPath is and as operators
• Validator support for pattern value constraints on FHIR Strings
• OperationOutcome warning to search response bundles when pages have shifted

Changed

• Upgrade to liberty 22.0.0.10
• Other dependency updates
• Avoid CodeQL warning by flipping logic around tenant config lookup
  • With this change, we will no longer dynamically pick up new tenants from the filesystem. All tenants must have their config files in place prior to starting the server. Updates to existing tenant config will still be discovered dynamically.
• Replace IBM FHIR Server in /metadata CapabilityStatement
• Reduce the default initial heap size
• Refresh fhir-persistence-schema parameter-names.properties

Fixed

• Truncate long String parameter values before persisting to the database

Security

• Warn fhir-smart users that Binary.securityContext will not affect access control

Migration Considerations

To migrate from a prior version to version 5.1.0:

1. Analyze configuration changes and prepare for the upgrade
   • #3716 introduces fhirServer/security/validateSecurityContext; currently it only affects fhir-smart behavior
2. Deploy the new server.

If upgrading from a version prior to 5.0.0, be sure to review the applicable migration considerations:

• 5.0.0 migration considerations

Note: for schema migrations, only the latest version of the fhir-persistence-schema tool must be run.

Using the Release

Run or extend the Docker image from https://github.com/LinuxForHealth/FHIR/pkgs/container/fhir-server or download fhir-install-5.1.0.zip and install as described at https://linuxforhealth.github.io/FHIR/guides/FHIRServerUsersGuide.

Executable jar files for the fhir-persistence-schema, fhir-swagger-generator, fhir-bucket, and fhir-path projects are also available:

• fhir-persistence-schema-5.1.0-cli.jar
• fhir-swagger-generator-5.1.0-cli.jar
• fhir-bucket-5.1.0-cli.jar
• fhir-path-5.1.0-cli.jar

Usage is documented in the corresponding README files:

• https://github.com/LinuxForHealth/FHIR/tree/main/fhir-persistence-schema
• https://github.com/LinuxForHealth/FHIR/tree/main/fhir-swagger-generator
• https://github.com/LinuxForHealth/FHIR/tree/main/fhir-bucket
• https://github.com/LinuxForHealth/FHIR/tree/main/fhir-path

For Maven users, all project binaries are posted to Maven Central with a groupId of org.linuxforhealth.fhir and a version of 5.1.0.