Red Hat SummitChapter 1. Cryostat migration overview
As a cluster administrator in Red Hat OpenShift, you can upgrade from Cryostat 3.0 to Cryostat 4.0. This guide covers the migration process for the Cryostat 4.0 release and any required application configuration updates to maintain consistent behavior.
Before you begin the migration process, complete the following steps:
- Review migration recommendations.
- Review the application configuration changes.
1.1. Migration recommendations
Before migrating, consider backing up any Cryostat data to ensure that customizations can be restored after upgrading.
This data includes:
- Custom event templates
- Custom dashboard layouts
- Active and archived recordings
Custom automated rules
NoteBecause of database management differences between Cryostat versions 3.0 and 4.0, any automated rules that you created in Cryostat 3.0 will not be automatically available after you upgrade. Before you upgrade, ensure that you download any existing rules that you want to continue using. For more information about downloading automated rules, see Creating an automated rule definition.
If there are previous SSL certificates and stored credentials configurations, ensure that these are available during migration.
1.2. Application configuration changes
As part of a new feature in the Red Hat build of Cryostat 4.0 release, you can use the Cryostat Operator to configure the Cryostat agent automatically. For more information about this new automatic configuration feature, see Cryostat agent features: Automatic or manual configuration of the Cryostat agent in the Getting started with Cryostat guide.
Due to a known issue that Red Hat is currently investigating, manual configuration of the Cryostat agent does not work correctly in Cryostat 4.0. Red Hat plans to fix this issue in a future release. If you want your applications to use the Cryostat agent in the 4.0 release, you must allow the Cryostat Operator to configure the Cryostat agent automatically. For more information, see Enabling automatic configuration of the agent by the Cryostat Operator.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}