Upgrading Smile CDR
When a new release of Smile CDR is released, the following page outlines the steps required in order to upgrade.
Within the Smile CDR installation directory, there is a directory called lib/ that contains all of the binary code for Smile CDR. It is generally possible to simply replace the contents of this directory with the new contents from a release.
The following example shows an in-place upgrade of Smile CDR:
cd smilecdr
bin/smilecdr stop
Change the following command to use a backup folder that works for your installation:
cp -R lib /path/to/your/backup/folder/lib-backup
With Smile CDR shut down, no new data will be entering the system and entering/changing the database, so this would be the time to perform a full database backup of all your applicable databases.
However, some installations have very large databases and cannot wait for a full backup to take place, so your situation may require taking a different approach. It may be acceptable in this scenario to use the most recent full backup, along with the latest transaction logs, in case you need to restore the database to this point-in-time, just before the Smile CDR upgrade takes place.
The exact instructions for this step will differ, depending on which database you have chosen to use with your installation. Please consult your DBA Team for assistance with ensuring that you have a full database backup to this point in time, which could be used if you decide to rollback this upgrade.
rm lib/*
# The following command assumes you are currently in the root of your smilecdr
# installation, and will extract only the lib directory
tar --strip-components=1 -xvf /path/to/smilecdr-2022.08.PRE.tar.gz smilecdr/lib
Starting with version 2020.11.R01, Smile CDR will automatically upgrade your database during the startup phase, if it detects that you are running a newer version of the software and an upgrade is required.
You can let Smile CDR perform the upgrade for you, or you can choose to upgrade it using our Database Migrator Tool as was needed in previous releases. See the smileutil: Migrate Database page for details on how to run the database migrator tool.
bin/smilecdr start
When upgrading CDR from versions 2019.05 and earlier, if subscriptions are enabled, then you will need to add a new Subscription Matching Module of the same FHIR version as your FHIR Storage module and link the Subscription Matching module to that FHIR Storage module as a dependency.