You cannot directly upgrade from version 2021.1 to version 2024.1. Instead, you will need to upgrade through several interim versions. Here are some important notes based on my experience:
1. Upgrade to version 2022.1.
- Generate a new controller token. This is because the old controller token is 40 bytes long, while the new controller token is 64 bytes.
2. Next, upgrade to version 2022.3 (or 2023.1).
- This update changes the encryption of passwords from bcrypt to the Windows Crypto API.
3. Finally, upgrade to version 2024.1.
Depending on the size of your gallery, you may encounter issues when upgrading to version 2022.3. For instance, I couldn't upgrade my gallery from 2022.1 to 2022.3 or 2023.1 because it contained over 6,000 workflows. The re-encryption process would have taken over 192 hours. Instead, my Alteryx community downloaded each workflow, evaluated them, refactored many workflows, consolidated or retired several workflows where necessary, and then uploaded the new workflows to a new gallery instance. Although this process was time-consuming, we experienced substantial performance improvements, and the number of workflows decreased to 1,200.
