Upgrades
There are several required prerequisites for upgrading Medical Information Cloud, each of which is described below.
To upgrade from one version to the next, locate the product and version in the Komodo Install Service and click the Install MIC [version] button. To upgrade from one version to a version that is more than one version ahead of your current version, use the Advanced Upgrade process.
Permissions
The user running the upgrade must be a System Administrator with the following assigned permission sets:
Medical Information Cloud Admin
CM_SystemAdmin
DocGen Admin
Apex codes
Compile all Apex codes before upgrading your environment(s) to ensure no issues exist that could cause the upgrade to fail. For more information, visit Salesforce's Apex Developer Guide.
Unit tests
Run all local (non-namespaced) unit tests. Although failing does not normally cause issues during an upgrade, it occasionally can. In addition, they can sometimes cause issues when deploying your own customizations to production. You are encouraged to follow Salesforce's best practices by running and monitoring unit tests.
Apex jobs
Unschedule all Apex jobs prior to performing the upgrade and reschedule them after. If an upgrade modifies the scheduled class, this can cause failures in running jobs or, depending on the changes happening, deploy errors.
Other considerations
It is recommended that you perform upgrades when users are not in the system. The installation process can be long and happens in steps, thus users may encounter strange behaviors or errors during upgrades while components have mismatched versions.
Advanced upgrade
Use Advanced Upgrade if you are upgrading to a version that is more than one version ahead of your current one. For example, if you are on version 11, use Advanced Upgrade to upgrade to version 13. Steps labeled Intermediate
should only be run once. If restarting a failed upgrade, uncheck any Intermediate
steps that have already ran. Failure to do so will not harm your org but the step will likely fail, requiring you to restart with the step unchecked.
When upgrading an org to version 13 from one that originally had Classic Medical Information Cloud in it, select one of the following steps:
Install Empty Classic Code: Cleans out deprecated references to allow upgrade but leaves behind empty classes and Visualforce pages.
Delete Classic Code: Cleaner, but requires removing all page layout references to the deprecated code first, which can be a much more involved process.