IBM FHIR Server 4.9.1

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

This release includes important dependency updates and focuses on fixing bugs and improving canonical reference search.

Added

• Support for deploying via Helm chart
  • the helm chart source is at https://github.com/Alvearie/alvearie-helm and we've published a helm repo and registered it at https://artifacthub.io/packages/helm/alvearie/ibm-fhir-server
• Support for searching via canonical references

Changed

• Performance enhancement: retrieve uncached COMMON_TOKEN_VALUE_IDs in a single request
• $bulkdata-status needs to indicate when no data was exported
• FHIRNotificationService should emit event for patch update
• FHIRPath cli output should indicate field names and hierarchy
• Make 'requiresAccessToken' configurable in the Bulk Export Status Report
  • This change introduces config parameter fhirServer/bulkdata/storageProviders/" + provider + "/requiresAccessToken
• Bulk Export Status should contain the required "error" field

Deprecated

• Old fhir-persistence-jdbc caches and related methods

Fixed

• Threading issue using static Calendar with JDBC ResultSet.getTimestamp
• System-only search of chained token parms and global _profile, _tag, and _security parms results in unexpected errors
• Bulkdata Enable Parquet uses old style configuration and fails upon Parquet usage
• Bulkdata with parquet results in stackoverflow
• CodeSystem/$validate-code causes and NPE when display is not present in the data
• NPE when sending an invalid content with an invalid operationdefinition on Translate
• Composition/$document reports a 500 when it's a bad user request.
• JSON Patch test operation should not result in a new resource version
• On a patch passing in a unsuported operator causes errror
• BulkData: Delete Job

Security

• Update ibm cos dependencies
• Update azure dependencies

Migration Considerations

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

1. Analyze configuration changes and prepare for the upgrade
   • Config parameter fhirServer/bulkdata/storageProviders/" + provider + "/requiresAccessToken was added for #2714
2. Deploy the new server.
3. Perform re-indexing.
   • Re-indexing is required to take advantage of the new canonical search behavior added in #772

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

• 4.9.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://hub.docker.com/r/ibmcom/ibm-fhir-server or download fhir-install-4.9.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.9.1-cli.jar
• fhir-swagger-generator-4.9.1-cli.jar
• fhir-bucket-4.9.1-cli.jar
• fhir-path-4.9.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.9.1.