IBM FHIR Server 4.8.1

This version of the IBM FHIR Server supports HL7 FHIR Specification version v4.0.1.

This release includes dependency updates, validation support for canonical pattern constraints (needed for the next revision of CARIN for BlueButton), and other minor changes as described below.

Added

• Validation support for Pattern Value Constraint with $this in the Path
• Provide configurable properties for max page size and max number of included resources on search results
• Support different default bulkdata storageProviders for import vs export

Changed

• Allow persistence interceptors to modify the incoming resource
• Load compartment definitions from the registry

Deprecated

• exportPublic + ACL-based approach to exported object expiry
• The fhir-server-distribution.zip name (deprecated in 4.8.0)

Fixed

• FetchResourcePayloadsDAO hits an error condition under debug without _since parameter

Security

• Update dependencies per Sonatype Lift CVE Report

Migration Considerations

To migrate from a prior version of the IBM FHIR Server to version 4.8.1:

1. Analyze configuration changes and prepare for the upgrade
   • The bulkdata configuration in fhir-server-config.json now supports designating a default storageProvider for import and export.
   • The bulkdata exportPublic property is now deprecated. All bulk export users relying on S3 ACL-based expiry should move to presigned URLs as described in the User's Guide.
   • #1868 introduces fhirServer/core/maxPageSize and fhirServer/core/maxPageIncludeCount for overriding the default max page size (1000) and max number of resources to include on a single page (1000).
   • #2296 introduces fhirServer/core/serverResolveFunctionEnabled (default=false) for controlling whether the server should resolve resources from the database (or not); for example during validation while evaluating fhirpath constraints.
2. Deploy the new server.

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

• 4.8.0 migration considerations

Using the Release

Run or extend the Docker image from https://hub.docker.com/r/ibmcom/ibm-fhir-server or download fhir-install-4.8.1.zip and install as described at https://ibm.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-4.8.1-cli.jar
• fhir-swagger-generator-4.8.1-cli.jar
• fhir-bucket-4.8.1-cli.jar
• fhir-path-4.8.1-cli.jar

Usage is documented in the corresponding README files:

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

For Maven users, all project binaries are posted to Maven Central with a version of 4.8.1.