Upgrading Health Connect
The process for upgrading Health Connect to a new major release or maintenance release is similar to upgrading the underlying InterSystems IRIS technology:
-
Read the special considerations for upgrading Health Connect listed below.
-
Complete the Upgrading InterSystems IRIS procedure in the InterSystems IRIS Installation Guide.
-
Return here and complete the post-upgrade steps below necessary for your situation.
SSL/TLS Configuration in the Configure Secure Communication Dialog
If you are upgrading from a version prior to 2022.2 and your system is configured for secure communication, meaning that you had an Active configuration in the Configure SSL Access option in the Installer Wizard prior to your upgrade, note that the Configure SSL Access dialog in the Installer Wizard has been renamed to Configure Secure Communication. In the new dialog you must now specify an SSL/TLS Configuration in order to make the secure communication settings Active. A default value of HS.Secure.Demo was entered for the SSL/TLS Configuration setting when you upgraded.
If you previously had an Active configuration in the Configure SSL Access option, you must modify the default value to reflect the SSL/TLS configuration in use on your instance as follows:
-
Navigate to the Installer Wizard.
-
Select the new Configure Secure Communication option.
-
Confirm that your Secure Port is identified and the These Settings are Active checkbox is selected.
-
In the SSL/TLS Configuration field, select the name of the SSL/TLS configuration in use on your instance.
-
Click Save.
Post-Upgrade Steps for Pre-2021.1 FHIR Endpoints
If you are upgrading from a version prior to 2021.1, the following steps that may be required depending upon on how you have customized your FHIR server. Perform these tasks in the following order:
-
If your FHIR server uses custom subclasses, you must modify your architecture subclasses.
-
If your FHIR endpoint uses custom search parameters, migrate them to a FHIR package and apply them to the endpoint.
Once you have completed these steps you can re-index the search tables.
Step 1: Modifying Architecture Subclasses
As part of the FHIR architecture that was introduced in Health Connect 2020.1, you can use a custom InteractionsStrategy to implement a custom FHIR server. If your FHIR server’s endpoint uses a custom InteractionsStrategy, including if it uses a subclass of the Resource Repository, complete the following steps:
-
Complete the upgrade of your Health Connect instance.
-
Using your IDE, do one of the following in your endpoint’s namespace:
-
If the InteractionsStrategy of your endpoint extended the Resource Repository (HS.FHIRServer.Storage.Json.InteractionsStrategy), create a subclass of HS.FHIRServer.Storage.Json.RepoManager.
-
If the InteractionsStrategy of your endpoint subclassed HS.FHIRServer.API.InteractionsStrategy directly, create a subclass of the HS.FHIRServer.API.RepoManager superclass.
-
-
Add the following parameters to your subclass of the Repo Manager:
-
StrategyClass — Specifies the subclass of your InteractionsStrategy.
-
StrategyKey — Specifies the unique identifier of the InteractionsStrategy. This must match the value of the StrategyKey parameter in the InteractionsStrategy subclass.
-
-
If your InteractionsStrategy subclass included custom code for the methods that manage the Service, you must move that logic to the new methods in the Repo Manager subclass that you created. Specifically, you must move custom code from the Create, Delete, Decommission, and Update methods to the corresponding methods in your Repo Manager subclass (CreateService, DeleteService, DecommissionService, and UpdateService ).
Step 2: Migrating Custom Search Parameters to a FHIR Package
In earlier versions of Health Connect, using custom FHIR search parameters required you to define a custom metadata set. In this version, defining FHIR metadata, including custom search parameters, has been migrated to FHIR packages. When you upgrade from an earlier version, the upgrade will remove any custom metadata sets, and configure the FHIR endpoint with the base FHIR package, either STU3 or R4, depending on what was in use before the upgrade.
If you use custom FHIR search parameters, you must manually migrate them to a FHIR package and apply them to the endpoint before they can be used. The instructions for creating and applying FHIR packages are in the “FHIR Profiles and Adaptations” chapter of FHIR Support in InterSystems Products. Using the files that you originally used to used to create the custom metadata set, perform the steps below in the recommended order:
-
Import your package or confirm that your package has been imported.
-
To complete this procedure, you must re-index the endpoint. You will do this in a later post-upgrade step.
Alternatively, you can perform these steps using the FHIR Package API.
Re-Indexing FHIR Search Tables
Re-index any FHIR search tables that require it:
-
In the Management Portal, navigate to Health > myFHIRnamespace > FHIR Configuration.
-
Select the Server Configuration card.
-
For each existing endpoint, select Reindex Now.
-
When prompted, click Select All, and then select Reindex.
Note:This step may take some time to complete.
Validate Production Interfaces
You can validate that your upgraded system behaves the way you expect it to by using the Production Validator. The Production Validator extracts HL7 headers, messages, and operation messages to a temporary database, which is then copied to an upgraded InterSystems IRIS for Health instance and replayed. By comparing the original messages to the messages processed on the upgraded system, you can evaluate and address differences.
Import SDA3 Schema
If you are using SDA3 or SDA3 transformations, you must import the SDA3 schema. For instructions, see the installation steps.
Upgrading from Health Connect 15.03
Health Connect 2019.1 was the first release of Health Connect that is powered by InterSystems IRIS. Because of this change in underlying technology, a special upgrade procedure is required when upgrading from a previous version of Health Connect. If you are upgrading to Health Connect 2019.1 or later from Health Connect 15.03, see the InterSystems IRIS In-Place Conversion Guide, which is available from the InterSystems WRC DocumentsOpens in a new tab page.