Software Updates and Patches
How to get the latest CryoSPARC features and fixes or roll back to a previous version.
Last updated
How to get the latest CryoSPARC features and fixes or roll back to a previous version.
Last updated
When we release a new version of CryoSPARC, the Dashboard will display an update notification.
In CryoSPARC v4.0+, the update notification is displayed at the top of the Dashboard:
In CryoSPARC v3, the update notification is displayed in the footer:
Before you update your instance, wait for all presently running jobs to complete, or kill them from the Resource Manager. We also highly recommend making a backup of your database as described below.
In CryoSPARC v4.0+, you can use the Maintenance Mode feature to pause new jobs during an update:
Unless otherwise noted:
Log in to the workstation or remote node where cryosparc_master is installed.
Use the same non-root UNIX user account that runs the cryoSPARC process and was used to install cryoSPARC.
Run all commands on this page in a terminal running bash
Run this command to check for CryoSPARC updates.
This checks online for available updates and indicates whether an update is available.
You can also use cryosparcm update --list to get a full list of available versions (including old versions in case you would like to downgrade).
Perform the following actions when installing the latest version of CryoSPARC.
To begin automatic master and non-cluster worker updates with the newest available version of CryoSPARC, run
Cluster workers are not updated automatically. See the "Manual Cluster Updates" section below
This commands executes the following:
Downloads the new master (cryosparc_master.tar.gz) and worker (cryosparc_worker.tar.gz) update packages if --skip-download was not specified
Shuts down the running CryoSPARC instance
Extracts and installs the master release
If dependencies have changed, automatically re-installs these
CryoSPARC releases include many compressed files; the extraction step may take several minutes on slower disks.
Once the master update is complete, master starts up and automatically updates registered workers:
Transfers the worker release cryosparc_worker.tar.gz to each worker node via scp
Extracts and installs the worker release
Updates dependencies
If multiple standalone worker nodes are registered that all share the same worker installation, the update is only applied once.
Cluster installations do not update automatically because not all clusters have internet access on worker nodes.
Once the automatic update above is complete, navigate to the CryoSPARC master installation directory via command-line. Look for the latest downloaded worker release, named cryosparc_worker.tar.gz orcryosparc2_worker.tar.gz
Copy this file (via scp) to cluster worker's installation directory. It should be in the same directory as the bin and deps folders. Navigate to the installation directory and run
This updates the worker at the current location with the given release file.
Follow this section to install or update/downgrade to a specific release of CryoSPARC.
Steps are as described above, but with this command instead
Use cryosparcm update --list to see the list of available versions. Substitute the vX.Y.Z in the command above with one of the results.
For instructions on updating an existing CryoSPARC v3.x instance to v4.0, please see: Guide: Updating to CryoSPARC v4
This removes CryoSPARC and installs the latest available version, bypassing all file and dependency checks.
On the master node run
Then on each worker node run
Use the command line flag --skip-download with the cryosparcm update command to perform a full update of CryoSPARC using the update packages already inside the cryosparc_master directory. This command can be run after manually downloading the update packages using cryosparcm update --download-only.
For example:
cryosparcm update --skip-download
Use the command line flag --download-only with the cryosparcm update command to only download the update packages and not perform a full update of CryoSPARC. This can be helpful if your internet connection is slow, and you'd like to limit CryoSPARC's downtime. This option can be used to download any version of CryoSPARC available (use cryosparcm update --list to see the list of available versions).
You can then use cryosparcm update --skip-download to perform a full update using the downloaded update packages.
For example:
cryosparcm update --download-only # downloads the latest update packages
cryosparcm update --version=v4.1.0 --download-only # downloads the update packages corresponding to v4.1.0
CryoSPARC provides two methods of verifying that all components of an installation are correctly working and set up.
The first method is to run cryosparcm test install and cryosparcm test workers via the command line. For more information, see Guide: Installation Testing with cryosparcm test
CryoSPARC system and license installation
Worker/Cluster configuration
GPU and CUDA driver installation
SSD caching
To check for available patches, run
Before applying patches, ensure CryoSPARC is running:
Apply the patch with one of the following strategies (table):
Automatically install all patches:
Finally, restart CryoSPARC:
You can to receive an email when we release a new update or patch.
We also periodically release patch updates for CryoSPARC, to address issues outside of normal updates. To learn more about patches, see:
IMPORTANT. Before you update your instance, we recommend making a
IMPORTANT. Before you update your instance, we recommend making a
Incomplete shutdown of the CryoSPARC instance during updates is a known cause for update failures. Follow the sequence for a of the CryoSPARC instance.
Please see .
If your CryoSPARC instance is running v4.0.0 and later, the oldest version of CryoSPARC you can downgrade to is v3.4.0. For more information, see
Follow this section when a cryoSPARC install or update process fails part-way, or if CryoSPARC cannot start after following the steps.
The second method is to run the Extensive Workflow job.
This automatic workflow executes all steps in the and verifies the following system components:
We periodically releases patches for specific versions of CryoSPARC to fix bugs which do not require a full formal software update. to receive an email when we release a patch.
