Version-to-Version Server Upgrade Guide
Importante
Please see the Server Upgrade Checklist to help plan and execute a successful Server upgrade, including the Pre-Upgrade Checks workflow to identify issues that cause upgrades to fail.
How Does This Document Help?
This document highlights tasks and changes you need to be aware of when upgrading through versions of Alteryx Server. Issues are cumulative, so read through each section as you upgrade through multiple versions. This doesn't replace Release Notes (see links in each section).
Release Schedule
Semi-annual releases add features but can also change Server management requiring you or your users to change behavior.
Maintenance releases/patches within each quarter address issues found in the initial release. For example, the first maintenance release for 2022.3 would be 2022.3.2.
Legend
PIT-STOP | Significant change that requires upgrading to this version before upgrading to a later version. |
MongoDB Upgrade | The Mongo database version is upgraded. An Alteryx Server upgrade can only include ONE MongoDB version upgrade between your current version and target upgrade version. |
CRITICAL | Critical Issue: Admins must address or be aware of when moving to or past this version. |
Criteria for entries in this list | This list condenses each version's Release Notes to highlight where:
|
Version-to-Version Guide
2024
Version | Actions to take when upgrading to—or past—this version. |
---|---|
2024.1 / What's New / Release Notes | |
2024.1 | Administrative Feature: Ability to Transfer Asset Ownership via UI and API Admins can transfer ownership of workflows and schedules between users via Server UI or using Server API V3 endpoints. Impact:
Nota
|
2024.1 | New Feature: New Database Option Added (SQL DB) User-Managed SQL Server database can be used instead of MongoDB. Currently, the only officially supported version of SQL is MSSQL Server 2019 and 2022. Impact: |
2024.1 CRITICAL | Python Upgrade: Embedded Python upgrades from 3.8.16 to 3.10.13 Impact: The following error message appears if an incompatible version of a Connector is used in Designer: " Version 3.8 was not found in our alteryx distribution. Please select another version. Internal Error - Deadlock detected." Task:
|
2024.1 CRITICAL | MongoDB Datetime Field Change (Service Timestamps Moved to UTC Format in Server Databases) Impact: We moved all datetime fields to UTC to improve handling of time zone and daylight savings time changes. For more information, go to Server 2024.1 Release Notes.
Task: Review how datetime fields are handled in applications that access MongoDB or the API. They might need to be adjusted to expect the datetime in UTC. |
2024.1 | DCM Dev/Prod Server Management: Prod Server can redirect Dev DCM to Prod Connections Impact: DCM Connections and DCM Connection Handling added to Admin menu. For more information, visit the following help pages: Task: Add DCM redirections to Prod Server to allow workflows migrated from Dev to access Prod data sources with no changes in the workflow. |
2024.1 | DCM Administration: User Permission Granularity Impact: New DCM permissions added. For more information, go to the User Roles and Permissions help page. |
2024.1 | DCM Administration: DCM Generic External Vault added Impact: You can configure a generic vault that can retrieve secrets from any vault with a programmatic interface using basic authentication. |
2024.1 | Administration Change: DCM Concurrent Sharing Impact: You can share the same DCM Connection for Collaboration and, separately, for Execution. Previously you could only choose 1 sharing option. For more information, go to Data Connection Manager: Server UI. |
2024.1 | Insights End of Life Impact: Insights no longer available in Alteryx Server. Go to our FAQ page for more information. |
2023
Version | Actions to take when upgrading to—or past—this version. |
---|---|
2023.1 / What's New / Release Notes | |
2023.1 CRITICAL | Minimum Designer Version Impact: Designer 2022.3 Patch 3 or later is required to connect with Server. See Server 2023.1 Release Notes. |
2023.1 | Administrative Change: Option to allow users to run workflows using Shared Server Database Connections Impact: Allow Access to Workflows Without Shared Credentials option added to allow a workflow using a Shared Server Database Connection to be run by anyone the workflow has been shared via a Collection. The other users do not require the Gallery Connection to be explicitly shared with them. Task: Server UI > Admin > Settings > Assets > select the Allow Access to Workflows Without Shared Credentials checkbox. |
2023.1 | Password Management: AWS Secrets Manager password vault support added Impact: AWS Secrets Manager |
2023.1 | API Additions: For Active Directory (AD) Authentication Servers, an AD Group can be added to a Custom Group Impact: Endpoints added:
|
2023.1 | Administrative Change: Azure Active Directory Group Support with SAML Authentication Impact: Admins can now sync users and group access to Server using Azure Active Directory (Azure AD) and the SCIM protocol. |
2023.1 | DCM Feature: Option to disable DCM synchronization between Designer and Server Impact: This feature is useful on a Prod Server to ensure users don't inadvertently synchronize and use a Prod credential in their local Designer. Task: Alteryx System Settings > DCM > select the Block DCM Connections Synchronization between Server and Designer checkbox. For more information, go to DCM - Server. |
2023.1 | Administrative Change: Workers can connect to User-Managed MongoDB with unique credentials. Impact: This allows for auditing per Worker. |
2023.1 | Database Connections: End of life for 32-Bit Database Connections Impact: End support 32-bit database connections FAQ. 32-bit connections will no longer function. |
2023.1 R Installer CRITICAL | R Upgrade: Embedded R version upgrades from 4.1.3 to 4.2.3 in RInstaller_2023.1.1.200.exe+ Impact: R version will be 4.1.3 or 4.2.3 as follows:
Task:
How To Use the R Tool with Packages Compatible with R Version 4.2.3 |
2023.1 | Analytic App Defects (corrected 2023.1_Patch_2) Impact:
|
2023.1 CRITICAL | Connect Product: Connect is not compatible with the initial 2023.1 release Impact: Release notes will indicate which patch is compatible with 2022.3. |
2023.2 / What's New / Release Notes | |
2023.2 MongoDB 6.0.5 | MongoDB Upgrade: Embedded MongoDB upgrades from version 4.2.15 to 6.0.5 Impact: Embedded MongoDB upgrades to 6.0.5 Task: If using embedded MongoDB, upgrading to this version or later will upgrade MongoDB to version 6.0.5. Note free drive space requirements of 1x-2x your current MongoDB size. |
2023.2 CRITICAL | MongoDB Upgrade Dialog: The dialog to initiate the embedded MongoDB upgrade is minimized Impact: When upgrading to 2023.2, after selecting Finish on the upgrade the Embedded MongoDB migration dialog opens but is immediately minimized, giving the impression that upgrade is complete [TGAL-9041]. For more information, go to Error in Service logs when upgrading to Server version 23.2: Invalid feature compatibility version value, expected '5.0' or '5.3' or '6.0'. Task: Ensure that you make this dialog visible and click to initiate the MongoDB upgrade. The Service will not start until the MongoDB is upgraded. |
2023.2 | MongoDB Change: __ServiceDataBlob field removed from AlteryxGallery Collections Impact: The __ServiceDataBlob field has been removed from AlteryxGallery collections; fields now appear as standard MongoDB fields. Task: If you have admin workflows that used the ServiceDataParser macro to unpack data from this blob, they will need to be refactored. |
2023.2 | DCM Administration Change: DCM Connections can now be shared for collaboration Impact: When sharing a DCM Connection in Server UI, the option "Share for Collaboration" allows the DCM Connection to be used by other users in their Designer. For more information, go to Data Connection Manager: Server UI > Share in Designer. Task: This change allows for easier collaboration of shared workflows and creation of new workflows using a colleague's DCM Connection. |
2023.2 | Python Upgrade: Embedded Python upgrades from 3.8.5 to 3.8.16 Impact: Users should retest Python in workflows. Engine still uses Python Version 3 so there should be little impact on scripts. Task: For more information, go to Alteryx Embedded Python. |
2022
Version | Actions to take when upgrading to—or past—this version. |
---|---|
2022.1 / What's New / Release Notes | |
2022.1 CRITICAL | Server Requirements Change: Recommended Logical Core and Memory requirements have changed Impact: AMP is enabled by default in 2022.1 and memory and logical core requirements have changed to support this. Additionally, AMP can now run Simultaneous Workflows (1 per 8 logical cores). Note the change from "physical" to "logical cores" in the table below. Task: Unless AMP is disabled, review that Worker nodes meet the new guidelines. See also: AMP Engine Best Practices. To disable AMP on the server, see "What if I want to preserve my current engine system settings?" in AMP Engine Best Practices. Best practice when using AMP: Allow the Server to manage simultaneous workflows and memory, check:
|
2022.1 CRITICAL | Settings Change: AMP Engine and "Allow Server to manage workflows running simultaneously" default ON [TCPE-309] Impact: This will reset your existing Workflows Allowed to Run Simultaneously setting based on the new AMP recommendations above. If you choose to disable AMP, you will need to restore your Simultaneous workflows setting to ensure performance is not impacted (the calculation for non-AMP Simultaneous workflows is physical_cores / 2). Task: See the "AMP Engine Enabled by Default" section of release notes for more details. To disable AMP: Alteryx System Settings > Engine > General > Engine > Original Engine Only |
2022.1 CRITICAL | API Change: OAuth1 API deprecated Impact: APIs now use OAuth2 exclusively. Select the question mark in the upper-right of the Server UI page for API documentation. See the 2021.4 section that introduces OAuth2 for critical links and directions. OAuth1 Authentication in scripts must be updated to OAuth2. Consider upgrading to 2021.4 first, where both authentication types are available, so scripts can be transitioned with no downtime. |
2022.1 Patch 5 | Administrative Change: Option to allow users to run workflows using Shared Server Database Connections Impact: Allow Access to Workflows Without Shared Credentials option added to allow a workflow using a Shared Server Database Connection to be run by anyone the workflow has been shared via a Collection. The other users do not require the Gallery Connection to be explicitly shared with them. Task: Go to Server UI > Admin > Settings > Assets, and check Allow Access to Workflows Without Shared Credentials. |
2022.1 PIT-STOP for Built-in auth | Built-in Authentication Changes: Built-in Authentication Password Encryption has changed [TGAL-6431] Impact: Built-in Authentication Password Encryption has changed. If you use Built-in authentication you will need to upgrade to this version before upgrading to later versions and follows steps below. Additional options have been added to customize Login Attempts. Task: Ask users to access the Server UI and reset their password when prompted (they can re-enter their same password). Upgrade users to Designer 2022.1 if they need to connect Designer to Server. Users who don't perform the steps above will receive the error "Email or Password were incorrect. Please try again." in Designer when connecting to the Server. Failure to do this and moving to a later version will require using the Reset Password option for each user. |
2022.1 CRITICAL | R Upgrade: Embedded R upgrades from 4.0.5 to 4.1.3 Task: Reinstall external R libraries and direct users to retest R in workflows. For more information, go to How To Use the R Tool with Packages Compatible with R Version 4.1.3. |
2022.1 | Designer deployment to VDI: Virtual Desktop Infrastructure (VDI) Support added for Designer deployment Impact: Designer can be deployed to persistent and non-persistent VDIs, see virtual desktop infrastructure support. |
2022.1 | Download Tool SSL security increased: SSL vulnerabilities addressed [JIRA PSEC-8] Impact: SSL vulnerabilities regarding handshake renegotiation (CVE-2009-3555) were addressed. However, this is leading some customers' Download Tool to stop working with error "Error transferring data: SSL connect error". Task: Contact the site you are accessing and ask them to upgrade their servers to support RFC 5746. If this is not possible, contact Customer Support and refer to Jira card PSEC-8 for additional workarounds. 2022.3 provides Peer Validation Allow List configuration option. |
2022.1.42590 Patch 3 | Defect TGAL-6990: Upgrade fails with Gallery Data Connections containing a blank password (corrected 21.4.2_Patch6, 22.1.1_Patch4) Impact: Upgrade fails when Gallery Data Connections containing a blank password exist, see Community article and [TGAL-6990] Task:
|
2022.2-FIPS / What's New / Release Notes | |
2022.2-FIPS | This is a FIPS-only release designed for new customers who work within FIPS environments. FIPS stands for Federal Information Processing Standards. The general-release Server and Designer products will skip a quarterly release and the next version will be 2022.3. Alteryx will continue to release maintenance updates to previous versions while awaiting the 2022.3 quarterly version. If upgrading from an earlier version, skip this version and upgrade to 2022.3+. |
2022.3 / What's New / Release Notes / Server Community Blog / Overview Community Blog | |
2022.3 CRITICAL | Upgrade Requirement for 2022.1 Defect TCPE-1100: If Upgrading from 2022.1 to this or later version, a patch is required. Impact: If currently on 22.1, you must be on 22.1.1.9.42691_Patch_9 or higher before upgrading to or through 22.3 to avoid the defect TCPE-1100. This defect affects the workflow revision numbers, setting them all to "1". Task: Apply the latest 22.1 patch before proceeding with the upgrade if you are not already on Patch_9 or later. |
2022.3 CRITICAL | MongoDB Re-encryption: Database collections must be re-encrypted with AES256 and SHA256 hashing standard prior to upgrade Impact: The Crypto Migration Prep Tool should be run prior to upgrade to 2022.3+ to re-encrypt workflows in the background while the Server continues to function. After running the Prep Tool, the first time the Service starts after upgrading a few more collections, as well as the RuntimeSettings.xml, will also be CryptoMigrated. Task: Your Server should be on 2021.2 or later before starting this process. If you are on a prior version, upgrade to a version between 2021.2 and 2022.1 prior to attempting to upgrade to 2022.3+. Run the Crypto Migration Prep Tool prior to upgrading Server and review the Migrator log for error lines containing Following upgrade, you can delete the old, unencrypted collections. Contact Support for information on cleaning up the temporary files created and reducing the size of the Mongo database (CSEs see here). If you need to rollback the upgrade, you will need to restore the backup of the RuntimeSettings.xml made during upgrade, C:\ProgramData\Alteryx\. |
2022.3 CRITICAL | Designer Version Requirement: Designer 2022.3 required Impact: The encryption methods used by 2022.3 Server require Designer 2022.3. Task: Users must upgrade Designer to save workflows to the Server. |
2022.3 CRITICAL | Configuration Change: SAML ACS endpoint must be all lowercase Impact: The ACS endpoint is now lowercase (/saml2/acs) but was mixed-case (/Saml2/Acs). This prevents Service start. [TCPE-940 is asking that both old and new casing be accepted without error]. Task: Change the ACS endpoint in the IDP to all lowercase. |
2022.3 Patch 2 | Administrative Change: Option to allow users to run workflows using Shared Server Database Connections Impact: Allow Access to Workflows Without Shared Credentials option added to allow a workflow using a Shared Server Database Connection to be run by anyone the workflow has been shared via a Collection. The other users do not require the Gallery Connection to be explicitly shared with them. Task: Go to Server UI > Admin > Settings > Assets. Then select the Allow Access to Workflows Without Shared Credentials checkbox. |
2022.3 | Administration Change: Load Balancer Impact: Alteryx System Settings > Server UI > Canonical Address options have been added to ensure email messages from the Server will use the URL your users use to access the Server UI. Task: If you use a Load Balancer, set these values to the URL your users typically use to access the Server UI or API. |
2022.3 | Server Usage Report has been deprecated Impact: The Server Usage Report is no longer supported by Alteryx. Previous versions might continue to function. |
2022.3 | Password Management: HashiCorp and CyberArk password vault support added |
2022.3 | Download Tool access to less secure handshake renegotiation: Settings file allows site-specific control Impact: Use the Peer Validation Allow List if receiving "SSL connect error" from Download Tool. Download Tool updated to OpenSSL 3.0.7. |
2022.3 | Internal Change: Controller Token length Impact: Server 2021.4 introduced a longer, more secure Controller Token, however, upgrades from 2021.3 retained their shorter Token. If the Token was not Regenerated to the longer length at some point it will be automatically regenerated in the 2022.3 upgrade. This will occur on all nodes in the same manner so they will create the same longer token and be able to communicate with the Controller following upgrade. Task: Use the new Controller Token to add new nodes to your Server architecture in the future. |
2022.3 | Defect TGAL-7199: All versions of workflow labeled "1" (corrected 2022.3.1_Patch2) Impact: When viewing the list of versions of a workflow, all versions display "1" instead of a sequential version number. This is a UI issue and the correct version is being used to run Jobs. |
2021
Version | Actions to take when upgrading to—or past—this version. |
---|---|
2021.1 | |
2021.1 CRITICAL | Administration change: Server Shared Database Connections must now be shared with Users attempting to run or schedule a workflow using the connection. Previously, a workflow using a Shared Database Connection could be shared with a Collection and all users in the Collection would be able to run it. Impact: Workflows and Schedules that were working before might now receive Unable to Translate Alias errors. 2022.1 Patch 5 and 2022.3 Patch 2 provide the option to restore this functionality. Task: For workflows receiving an error after the upgrade, determine the shared Server Database Connection used by the workflow and share it with the User attempting to run or schedule the workflow. |
2021.1 | New Features
|
2021.1 | System change: Configuration file locations have changed. Impact:
|
2021.1 | Security enhancement: Enforce that OAuth parameters are sent as headers rather than query parameters. |
2021.1 | Defect TGAL-2872: Curators can see Jobs run by other users on shared workflows but receive Access Denied error when trying to access the results (corrected 2021.4). Impact: If a UserA shares a workflow with a Curator via a Collection or by being in the same Studio, the Curator will see the Jobs UserA has run manually or through a Schedule. When the Curator selects the Job to view the Results they receive |
2021.2 | |
2021.2 PIT-STOP | First version that is compatible with the 2022.3+ Crypto Migration Impact: Versions 2021.2 - 2022.1 are compatible with the MongoDB crypto migration performed in the upgrade to the 2022.3+. Task: If upgrading from an earlier version to 2022.3+ you will need to upgrade to 2021.2 - 2022.1, test, then upgrade to 2022.3. |
2021.2 | MongoDB change: Duplicate emails will cause failure to upgrade in this and later versions. Impact: Use the Pre-Upgrade Checks workflow to identify duplicate emails before upgrading to this or later versions. |
2021.2 | New Features
|
2021.2 | Feature removed: Option to Share Workflows removed from the Workflow page. Impact: This removes the options to share workflows via social media and email from this page. |
2021.2 | Defect TCPE-120: Designer Select Tool Defect. The field "XXX" was renamed conflicting with an existing field name (corrected 2022.1). Impact: An error message appears on the Select tool in cases where the incoming data field names changed case since the tool was configured. |
2021.2 | Upgrade change: Service will not start if the MongoDB Schema migration failed. Impact: This ensures issues preventing the schema migration are addressed before the Service starts. The Pre-Upgrade Checks workflow is the best way to ensure the schema migration will be successful. |
2021.2 | Defect TCPE-531: .hyper files read strings into Alteryx as V_WString Impact: .hyper files read strings into Alteryx as V_WString (1,073,741,823) while prior versions read in as V_WString (255). Task: Use an Auto Field or Select Tool after reading .hyper data to reset the column type. |
2021.3 | |
2021.3 | Performance Improvement - Schedule Forecast performance significantly improved |
2021.3 | Defect: Running alteryxservice setserversecret results in an errorSet server secret failed: Error in CryptImportKey(3): Bad Data (-2xxx) Impact: No defect was created. To correct this, edit the Runtime Settings and remove the content of the server secret section and save. |
2021.3 | Database Connections - End of Support for 32-Bit Database Connections Impact: See End support 32-bit database connections FAQ. Final end-of-life for 32-bit is 2023.1. Task: Users should move to 64-bit connections, see 21.3 and 32 bit connections. |
2021.3.4 | Defect TGAL-6268: API endpoints Impact:
Task: See a discussion of the changes you'll need to make and an example workflow that performs workflow migrations that have been updated based on this defect: Migrating-Workflows. |
2021.3.6 MongoDB 4.2 | MongoDB Upgrade: Embedded MongoDB upgrades from version 4.0 to 4.2 Impact: The .6 maintenance release of 2021.3 upgrades the MongoDB version, please see details in the 2021.4 section below. |
2021.3.6 | Defect TGAL-6566: Service fails to start after upgrading to 2021.3.6 with Mongo error: Index with name: fd5e7f7ad987788251ca676578977ec1 already exists with a different name: generic server error" code: <mongodb:85> in LastStartupError.txt (corrected 2021.3.7). Impact: This affects upgrades to 2021.3.6 only. Task: Contact Support and refer CSE to internal article Unable to upgrade Server with User managed database on version 4.2+. Note to TAMs: the steps in the article are easy and can be done proactively before upgrading (see Jennifer Powell). |
2021.4 / What's New / Release Notes | |
2021.4 MongoDB 4.2 | MongoDB Upgrade: Embedded MongoDB upgrades from version 4.0.10 to 4.2.15 Impact: While the initial upgrade was to 4.0.10, subsequent patches upgraded to 4.2.15 [CSE Internal (TGAL-6772)]. Task: If using embedded MongoDB, upgrading to this version or later will upgrade MongoDB to version 4.2. Note free drive space requirements of 1x-2x your current Mongo database size. Nota If your first Server installation was prior to 2018.1 and your MongoDB folder does not contain files with the .WT extension, you need to backup and restore your Mongo database, then set your Server to use the restored data folder prior to this upgrade. See MongoDB Migrate from MMAPv1 to WiredTiger Storage. [CSE Internal - TGAL-6590 and Teams] (corrected 2021.3.7). |
2021.4 CRITICAL | Internal Change: Controller Token length extended Impact: The shorter Controller Token will continue to work following your upgrade, however you will not be able to perform a Server Host Recovery using the shorter token because it will not be accepted by the "AlteryxService.exe setserversecret" step. The best practice is to proactively reset your controller token to the new extended length to ensure you'll be able to perform a Server Host Recovery in the future. Task: Critically Important
|
2021.4 | New Feature: Data Connection Manager (DCM) Impact: A User can store passwords for Credentials, Data Sources, and Connectors in the DCM. These can be used by a User in workflows locally or on the Server, and shared on the Server so other Users or Groups can run the User's workflows on the Server. This moves control of credentials from the Server Administrator to the User publishing the workflow. |
2021.4 | New Feature: API V3 added with many new Administration endpoints, OAuth2, and new API endpoints Impact: Task: If your Server uses a Base Address other than localhost, copy the domain into the Web API Address in Alteryx System Settings > Gallery > General. The If you have a Load Balancer you must implement Sticky Sessions to use OAuth2. Failure to do so will lead to intermittent 401-Unauthorized errors when the load balancer sends an API call to a different machine than generated the Bearer Token. [CSEs - Jira TGAL-6353, TCPE-402; Aha SERV-605] |
2021.4 | Server UI Change: Private Studio and Home pages merged Impact: |
2021.4 | Server UI Change: If users have been moved between Private Studios, they will now see all workflows they've created Impact: Prior to this version, if users were moved between Private Studios (Subscriptions) they would only see workflows from their current Private Studio. With the change to viewing workflows in "My Workspace", users will now see all workflows they have ever created. However, while displayed, users will not be able to delete or open workflows other than those in their current Subscription (as assigned in the Admin > Subscriptions page). This is a step in the direction of removing Private Studios from the Server product in favor of sharing workflows via Collections. In a future release, users will be able to open and delete all of their workflows, regardless of the Private Studio they were created in. Task: No action needed. |
2021.4 | Administration Change: "Jobs Shared With Me" tab was removed from Private Studio (which is now called My Workspace) Impact: If Users shared Scheduled Workflow Job Results by being in the same Private Studio with the Studio setting Shared Schedules Enabled, they will no longer see the Jobs Shared With Me tab in their Private Studio to view the Job Results from these Schedules. Task: To provide access to shared Schedules:
|
2021.4 | Improved: Telemetry enhanced to track usage at the workflow level Impact:
|
2021.4 | Defect TGAL-6408:Default Worker Tag assigned to a Private Studio is not being saved (corrected 2022.3) Impact: The Private Studio Assigned Worker setting is not saved. Task: Set the Job Tag when publishing the workflow (the User must have Assign Jobs set to true). |
2021.4 | Defect TGAL-6502/TCPE-292: If you have user-managed MongoDB Atlas, schema migration fails with 250+ Users/Subscriptions (corrected 2021.4.2_Patch2) Impact: Corrected in version noted above. |
2021.4 | Defect TCPE-473: Collection names appear with %20 or %26 instead of space of ampersand (corrected 2023.1) Impact: In past versions Collection names were saved URLEncoded, where a space would be replaced with %20 (as well as other character substitutions). 2021.4+ are displaying the Collection names exactly as they appear in the database. Task: You can determine if this will be an issue by reviewing the AlteryxGallery.collections collection for names with %20's. If they exist you can edit the Collections in Server UI to correct. If there are too many to edit easily, contact Customer Support for assistance. |
2021.4 | Excel XLSX File Handling Change: Excel XLSX files can no longer be read from if they are open in Excel [TDCB-3592] Impact: This change was made to ensure data integrity |
2021.4.2 | Defect TDES-4123: Related to use of feature locking down users' Designer access to a single, specific Server UI URL (corrected 2021.4.2_Patch2) Impact: If the feature below is used in local Designer installations to (1) specify a default Server UI URL and (2) prevent the user from connecting to Server UI's of their choice, the user will lose the default Server UI from the File > Open Workflow menu and thus no longer be able to open workflows from the Server UI. Affected feature: Control Designer Access to Server Specific setting that causes the issue: <Designer> <ManageGalleriesEnabled>False</ManageGalleriesEnabled> <DefaultGalleryUrl>http://my-server.com/gallery</DefaultGalleryUrl> </Designer> Task: Change the XML file |
2021.4.2 | Defect TGAL-6443: Impact: If a workflow is originally published from Designer, subsequent updates using the |
2021.4.2 | Security Notice: AMP Engine (corrected 2021.4.2_Patch1) Impact: Alteryx has received a report of a vulnerability in AMP processing. Alteryx is investigating the possible impact. (TELC-2814) Task: We recommend that you disable AMP on Designer and Server. |
2021.4.2.47792 Patch 5 | Defect TGAL-6990: Upgrade fails with Gallery Data Connections containing a blank password (corrected 21.4.2 Patch6, 22.1.1 Patch4) Impact: Upgrade fails when Gallery Data Connections containing a blank password exist, see Community [TGAL-6990]. Task:
|
2021.4.2.47792 Patch 5 | Defect TGAL-7256: DCM connections don't work after Server Host Recovery (open) Impact: If the Mongo database is restored to a new machine (a Server Host Recovery), the DCM connections will not work (errors vary for each tool using DCM). Task: Workaround - best option:
|
2020
Version | Actions to take when upgrading to—or past—this version. |
---|---|
2020.1 | |
2020.1 | MongoDB issue: NULL user names, emails, or subscriptions will cause upgrade failures in this and future versions. Task: Use the Pre-Upgrade Checks workflow to identify NULL values before upgrading to this or later versions. |
2020.1 | Administration change: Artisans are given the ability to create Collections by default. Impact: This adds capabilities Artisans might not have had before. Task: To remove this functionality for a user, edit their User record and set Create Collections to No. |
2020.1 | Administration change: Users with Viewer Role lose ability to run workflows in Collections shared with them (TGAL-2666). Impact: Users who want to run workflows shared with them in a Collection need to have their Role set to Member. Expected error message: This Workflow is published in a private Studio. An Analytics Gallery Membership is required to run Workflows published in private Studios. Contact the Artisan who shared the Workflow to request a Membership. For more information on Memberships, please contact sales@alteryx.com. Task: Set the user's Role to Member. |
2020.1 | Defect TGAL-2745: If using AD authentication: Schedules, Collections, and individual Users may not display (corrected 2020.3.9). Impact: If using Active Directory authentication, if an AD User is deleted:
Task: To determine if you have any Server Users who have deleted AD User accounts prior to upgrading, run the AD Health Check workflow. If you experience this issue, contact Customer Support to resolve [CSEs Gallery Errors when using Windows Authentication]. |
2020.2 | |
2020.2 | New Features
|
2020.3 | |
2020.3 | New Features
|
2020.3 | Defect TSM-317: Output Tool SQL Server error (corrected 2021.2) Impact: See Output Tool SQL Server: An unknown error occurred in II_PushRecord. |
2020.3 | Defect TGAL-2832: If using AD Groups, AD "Display Name" is now used and it can be different or blank (corrected 2021.4) Impact: If using AD authentication, AD Group names changed from the "Network Name" to the "Display Name" field. This can cause the AD Group names to appear differently in Server UI or be completely blank. Task: Go to Active Directory Groups Not Showing when Adding Groups. |
2020.3 CRITICAL | Defect TGAL-2671: Active Directory authentication leading to slow Admin access of list of Users (corrected 2020.4) Impact: If you use Active Directory authentication, move to version 2020.4+. |
2020.4 | |
2020.4 CRITICAL | Python upgrade: Embedded Python upgrades from 3.6.8 to 3.8.5 (Conda) Impact: Users should retest Python in workflows. Engine still uses Python Version 3 so there should be little impact on scripts. Task: All Connector Tools using Python must be re-installed from YXI's. |
2020.4 | New Features
|
2020.4 | Administration change: A Collection can no longer be shared with a Private Studio, share Collections with Users instead. Impact: This feature had allowed a backdoor for Servers using Active Directory authentication to allow access to Collections by users in different AD Forests. The steps for the backdoor had been:
Going forward, the AD User in a different domain can't have the Collection shared with them since the Collection can only be shared to users in the same AD Forest. |
2020.4 | Defect TGAL-6039: If using AD authentication, unable to Change Collection Owner (corrected 2022.1) Impact: If using Active Directory authentication, if the AD User is deleted for a Server User who owns a Collection, the Collection Change Owner page appears blank. Task: Edit the User in Server UI and set their Role to No Access to correct this problem. |
2020.4 | Defect TDALI-1078: PowerPoint Output from Render Tool is Corrupt (corrected 2022.3) Impact: The PPT / PPTX file presents an error when opened: |
2019
Version | Actions to take when upgrading to—or past—this version. |
---|---|
2019.3 | |
2019.3 MongoDB 4.0 | MongoDB Upgrade: Embedded MongoDB upgrades from version 3.4 to 4.0.10 Task: If using embedded Mongo, upgrade to 2019.3-2021.3 before upgrading to 2021.4+ to ensure embedded Mongo upgrades to version 4.0. Note free drive space requirements of 1x-3x your current Mongo database size. |
2019.3 CRITICAL | Python upgrade: Embedded Python upgrades from 3.6.0 to 3.6.8 (Conda) Impact: Users should retest Python in workflows. Engine still uses Python Version 3 so there should be little impact on scripts. Task: All Connector Tools must be re-installed from YXI's. |
2018
Version | Actions to take when upgrading to—or past—this version. |
---|---|
2018.1 | |
2018.1 MongoDB 3.4 | MongoDB upgrade: Embedded MongoDB upgrades from version 3.0.4 to 3.4. Task: If using embedded Mongo, upgrade to 2019.3-2021.3 before upgrading to 2021.4+ to ensure embedded Mongo upgrades to version 4.0. Note free drive space requirements of 1x-3x your current Mongo database size. |