Skip to content
This repository has been archived by the owner on Nov 17, 2023. It is now read-only.

NUM‐CODEX DSF Upgrade From 0.4.0 to 0.5.0

Jump to bottom
Hauke Hund edited this page Aug 26, 2021 · 20 revisions

TLDR: Backup your organization DSF identifier, certificates and private-keys, delete 0.4.0 and install 0.5.0 using NUM‐CODEX DSF 0.5.0 Deployment.

This guide is not suitable for HiGHmed organizations. If you are a member of HiGHmed, see HiGHmed Upgrade.

Upgrading from 0.4.0

Upgrading the DSF from 0.4.0 to 0.5.0 is essentially equivalent to a fresh installation. The following section lists files and parameters from the 0.4.0 installation you need to backup and then reuse in the 0.5.0 install. The requirements for virtual machines, docker, the network-setup between DSF FHIR server and DSF BPE server, firewalls (open ports) and the DMZ setup as well as client and server certificates from the DFN PKI have not changed.

Preparation

Certificates and Keys

  • Backup your DSF FHIR server server-certificate and the corresponding private-key from the DFN-PKI. You do not need to port any CA files since they are provided in the config .tar.gz file.
  • Backup your organizations client-certificate and the corresponding private-key from the DFN-PKI used in both the DSF FHIR and DSF BPE servers. If you do not have the original certificate.pem and private_key.pem files, but only the generated p12 file. You can extract the client-certificate and private-key from the p12 file. To extract the private-key not encrypted: 
    openssl pkcs12 -in client_certificate.p12 -out client_certificate_private_key.pem -nodes -nocerts
    To extract the client-certificate: 
    openssl pkcs12 -in client_certificate.p12 -out client_certificate.pem -nokeys -clcerts
    Caution! The commands above add lines in the beginning of the files that need to be removed, make sure both pem files start with -----BEGIN...

Organization-Identifier

  • Write down your DSF organizations identifier value (aka the shortest FQDN that resolves the main homepage of your organization) as well as the name of your organization from the FHIR bundle at /opt/fhir/app/conf/bundle.xml.

Remove 0.4.0

  1. Shutdown and remove the docker containers:

    • On your DSF BPE server execute from /opt/bpe 
      docker-compose down
    • On your DSF FHIR server execute from /opt/fhir 
      docker-compose down

  2. Delete or move the old docker-compose directory structures:

    • On your DSF BPE server execute 
      sudo mv /opt/bpe /opt/bpe_0.4.0
    • On your DSF FHIR server execute 
      sudo mv /opt/fhir/opt/fhir_0.4.0

Install 0.5.0

Follow the NUM‐CODEX DSF 0.5.0 Deployment guide.

Clone this wiki locally