Skip to content

Commit 91efcec

Browse files
links
1 parent 6fcd5c4 commit 91efcec

File tree

1 file changed

+7
-8
lines changed

1 file changed

+7
-8
lines changed

articles/healthcare-apis/fhir/migration-strategies.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -32,8 +32,7 @@ To migrate your data, follow these steps:
3232
## Step 1: Assess readiness
3333

3434
Compare the differences between Azure API for FHIR and Azure Health Data Services. Also review your architecture and assess if any changes need to be made.
35-
36-
| **Capabilities** | **Azure API for FHIR** | **Azure Health Data Services** | | |
35+
|---**Capabilities** |---**Azure API for FHIR** |---**Azure Health Data Services** | | |
3736
|-------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|---|
3837
| **Settings** | Supported: Local RBAC • SMART on FHIR Proxy | Planned deprecation - Local RBAC (9/6/23) - SMART on FHIR Proxy (9/21/26) | | |
3938
| **Data storage Volume** | More than 4 TB | Current support is 4 TB. Reach out to CSS team if you need more than 4 TB. | | |
@@ -48,9 +47,9 @@ Compare the differences between Azure API for FHIR and Azure Health Data Service
4847

4948
- **Sync agent is being deprecated**. If you're using sync agent to connect to Dataverse, see [Overview of data integration toolkit](/dynamics365/industry/healthcare/data-integration-toolkit-overview?toc=%2Findustry%2Fhealthcare%2Ftoc.json&bc=%2Findustry%2Fbreadcrumb%2Ftoc.json)
5049

51-
- **FHIR Proxy is being deprecated**. If you're using FHIR Proxy for events, refer to the built-in [eventing](./../events/events-overview.md/) feature. Alternatives can be customized and built using the [Azure Health Data Services toolkit](https://github.com/microsoft/azure-health-data-services-toolkit).
50+
- **FHIR Proxy is being deprecated**. If you're using FHIR Proxy for events, refer to the built-in [eventing](../events//events-overview.md/) feature. Alternatives can be customized and built using the [Azure Health Data Services toolkit](https://github.com/microsoft/azure-health-data-services-toolkit).
5251

53-
- **SMART on FHIR proxy is being deprecated**. You need to use the new SMART on FHIR capability. More information: [SMART on FHIR](/healthcare-apis/fhir/smart-on-fhir)
52+
- **SMART on FHIR proxy is being deprecated**. You need to use the new SMART on FHIR capability. More information: [SMART on FHIR](smart-on-fhir.md)
5453

5554
- **Azure Health Data Services FHIR Service does not support local RBAC and custom authority**. The token issuer authority needs to be the authentication endpoint for the tenant that the FHIR Service is running in.
5655

@@ -64,12 +63,12 @@ First, create a migration plan. We recommend the migration patterns described in
6463

6564
| Migration Pattern | Details | How? |
6665
|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
67-
| Lift and shift | The simplest pattern. Ideal if your data pipelines can afford longer downtime. | Choose the option that works best for your organization: Configure a workflow to [\$export](/healthcare-apis/azure-api-for-fhir/export-data.md) your data on Azure API for FHIR, and then [\$import](/healthcare-apis/fhir/configure-import-data.md) into Azure Health Data Services FHIR Service. The [GitHub repo](https://github.com/Azure/apiforfhir-migration-tool/blob/main/v0/V0_README.md) provides tips on running these commands, and a script to help automate creating the \$import payload. Or, create your own tool to migrate the data using \$export and \$import. |
66+
| Lift and shift | The simplest pattern. Ideal if your data pipelines can afford longer downtime. | Choose the option that works best for your organization: Configure a workflow to [\$export](../azure-api-for-fhir/export-data.md) your data on Azure API for FHIR, and then [\$import](configure-import-data.md) into Azure Health Data Services FHIR Service. The [GitHub repo](https://github.com/Azure/apiforfhir-migration-tool/blob/main/v0/V0_README.md) provides tips on running these commands, and a script to help automate creating the \$import payload. Or, create your own tool to migrate the data using \$export and \$import. |
6867
| Incremental copy | Continuous version of lift and shift, with less downtime. Ideal for large amounts of data that take longer to copy, or if you want to continue running Azure API for FHIR during the migration. | Choose the option that works best for your organization. We created an [OSS migration tool](https://github.com/Azure/apiforfhir-migration-tool/blob/main/v0/V0_README.md) to help with this migration pattern. Or, create your own tool to migrate the data incrementally.
6968

7069
### OSS migration tool considerations
7170

72-
If you decide to use the OSS migration tool, review and understand the migration tool’s [capabilities and limitations](https://github.com/Azure/apiforfhir-migration-tool/incremental-copy-docs/Appendix.md).
71+
If you decide to use the OSS migration tool, review and understand the migration tool’s [capabilities and limitations](https://github.com/Azure/apiforfhir-migration-tool/incremental-copy-docs/appendix.md).
7372
#### Prepare Azure API for FHIR server
7473
Identify data to migrate.
7574
- Take this opportunity to clean up data or FHIR servers that you no longer use.
@@ -79,7 +78,7 @@ Identify data to migrate.
7978
Deploy a new Azure Health Data Services FHIR Service server.
8079
- First, deploy an Azure Health Data Services workspace.
8180

82-
- Then deploy an Azure Health Data Services FHIR Service server ([Deploy a FHIR service within Azure Health Data Services](/healthcare-apis/fhir/fhir-portal-quickstart.md)
81+
- Then deploy an Azure Health Data Services FHIR Service server ([Deploy a FHIR service within Azure Health Data Services](fhir-portal-quickstart.md)
8382

8483
- Configure your new Azure Health Data Services FHIR Service server. If you need to use the same configurations as you have in Azure API for FHIR for your new server, see the recommended list of what to check for in [migration tool documentation](https://microsoft.sharepoint.com/:w:/t/msh/Eb7WohSv_6JNlG1xAI8TyvoBbAPfhxnPzr4wv9py1InEww?e=QeSbo3&nav=eyJoIjoiMTUwODIzNzMifQ)). Configure the settings before you migrate.
8584

@@ -97,7 +96,7 @@ Migrate applications that were pointing to the old FHIR server.
9796

9897
- Reconfigure any remaining settings in the new Azure Health Data Services FHIR Service server after migration.
9998

100-
- If you’d like to double check to make sure that the Azure Health Data Services FHIR Service and Azure API for FHIR servers have the same configurations, you can check both [metadata endpoints](/healthcare-apis/fhir/use-postman#get-capability-statement) to compare and contrast the two servers.
99+
- If you’d like to double check to make sure that the Azure Health Data Services FHIR Service and Azure API for FHIR servers have the same configurations, you can check both [metadata endpoints](use-postman#get-capability-statement) to compare and contrast the two servers.
101100

102101
- Set up any jobs that were previously running in your old Azure API for FHIR server (for example, \$export jobs)
103102

0 commit comments

Comments
 (0)