Heading
Upgrading from the 1.0 Zymbit Driver to Zymbit Driver Package 2.0 is a migration, not a routine update. It moves devices from the heterogeneous, distribution-specific legacy APT repositories to a common new APT repository, renames and splits several packages, and drops Ubuntu 22.04, Debian 11 and 32-bit ARM. Running apt upgrade on a device still using zk-sw-repo will not move it to 2.0.
Before upgrading to Zymbit Driver Package 2.0
- Back up
/var/lib/zymbit. - Keep a copy of
/etc/zk_pkcs11.confand your PKCS#11 tokens. The token directory stays at/var/lib/zymbit/zk_pkcs11/tokens/, so existing tokens carry over. - Plan to rebuild applications built against the old Zymkey API libraries. The new libraries have versioned names.
Warning
Upgrading deployed devices? Driver Package 2.0 has been tested in upgrade scenarios; however, there is always risk when encrypted in-field devices are being upgraded. Test before deployment and proceed at your own risk. Please contact Zymbit support at support@zymbit.com if you need assistance.
The zymbit-repo package is aware of the old driver and will generally behave correctly. However, if the system install has been customized, or the distribution is non-standard, the standard procedure may not upgrade properly. Always test and check to make sure the upgrade is working as intended.