Server 2023.1 Release Notes
Release Note Product Versions | |||
---|---|---|---|
Version | Date | Release | End of Support |
2023.1.1.123 | May 17, 2023 | Major | May 17, 2025 |
Upgrade Considerations
- Please note that due to the cryptography migration in 2022.3, only Server versions 2021.2 and newer are supported to upgrade to 2023.1. If you have a version older than 2021.2, upgrade to 2021.2 or a newer release before upgrading to 2023.1.
- As of version 2023.1, Designer versions older than 2022.3 Patch 3 will NOT be able to publish workflows from Designer to Server. For older versions of Designer you will need to upload those workflows to Server 2023.1 using the Administrator UI or API. To maintain compatibility with Server, download the latest version of Designer. The latest version of Designer that is backwards compatible with Server 2023.1 is Designer 2022.3 Patch 3.
Important: Alteryx Connect Customers
If you are an Alteryx Connect customer, do not upgrade to Alteryx Server version 2023.1—this will break Connect and will require a full uninstall and downgrade of Server. Server version 2023.1 requires an update before it's compatible with Connect. We are working to have this available in the coming weeks.
If you are not a Connect customer, you are safe to upgrade to Server version 2023.1.
Migration Prep Tool
To use the latest and best cryptography throughout Server to protect data at rest and data in flight, you now have a way to get your crypto migrated to the most modern algorithms without taking a lot of downtime and interrupting your business.
As part of the move to more modern, FIPS-capable cryptography, we prepared a Migration Prep Tool to mitigate the maintenance window downtime required to get all your workflows migrated to the new crypto standard.
The Migration Prep Tool for Server is a separate command line utility that allows pre-migration of a database of workflows and apps to migrate faster to the new AES256 standard.
This tool is optional and only needs to be run once before upgrading any prior Server version to Server 2022.2.x (FIPS build), 2022.3.x (FIPS or general availability builds) or beyond. However, we recommend you run the Migration Prep tool in some cases.
For more information about this tool, visit the Migration Prep Tool help page.
Upcoming Changes to the Timestamp Format
In a coming release, all timestamps in the Server databases will be converted to the UTC format. There will be no change in functionality in the front-end Server user interface and all times will be displayed as expected per the Server configuration settings. If you are taking timestamps directly from the Server database, these timestamps will be migrated to UTC format for standardization across the product and to alleviate daylight savings time issues.
Upcoming Deprecation of OS Support
As part of the deprecation of Windows Server 2012 on October 10, 2023, Alteryx Server will no longer be supporting this operating system as of the 2023.2 release later this year.
If you operate Alteryx Server on Windows Server 2012, we encourage you to upgrade to a supported version of the OS prior to upgrading to Alteryx Server 2023.2. The reason is that MongoDB upgrades in the 2023.2 release will render Alteryx Server unusable if installed on a system running the Windows Server 2012 operating system. Alteryx Server versions 2023.1 and prior will continue to operate on Windows Server 2012. For more information on this topic, please go to FAQ: Alteryx Server and MongoDB 4.2 Community article.
The Alteryx Server version 2023.1 offers separate GA and FIPS 140-2 capable products. Please note that these standards are developed by the US National Institute of Standards and Technology (NIST) for use by US government agencies and contractors. For more information about FIPS, go to the NIST FIPS FAQ page.
The general (non-FIPS) release version of Alteryx Server is not capable of FIPS operation. A separate release (and installer) is available under separate license terms, for our FIPS 140-2 customers. Contact your Alteryx Sales Representative for more details.
Feature Differences
Server-FIPS 2023.1 has a few features that are not available or limited in function when compared to the non-FIPS Server releases. See Alteryx Server and Server-FIPS Feature Differences for reference.
New Features
Azure Active Directory Group Support with SAML Authentication
Admins can now sync users and group access to Server using Azure Active Directory (Azure AD) and the SCIM protocol. This allows admins to manage user and group permissions and Server access from their identity provider as single source of truth. Users and groups are automatically synced from Azure AD to Server, making it faster to onboard or offboard Server users and groups.
This functionality is available if you are using SAML as your authentication method. Any identity provider that supports SCIM can use this functionality, but official support is limited to Azure AD, which is the only provider we tested. To read more about the Azure AD group with SAML authentication and SCIM support, go to Configure Alteryx Server Authentication and Alteryx Server Settings.
New API Endpoints
Added new API endpoints to add and delete an Active Directory (AD) group via the admin API.
- To add an AD group to a custom Server group, use the following admin API endpoint: POST/v3/usergroups/{id}/activedirectorygroups.
- To delete an AD group from a custom Server group, use the following admin API endpoint: DELETE/v3/usergroups/{userGroupId}/activedirectorygroups/{adGroupSid}.
For more information about these endpoints, visit the User Group Endpoints help page or access the Swagger documentation by selecting the question mark icon in the upper right corner of Server interface.
Updates to API Endpoint for Uploading New Workflow Versions
We introduced the /v3/workflows/{workflowId}/versions API to allow admins and users to upload new versions of existing workflows. Additionally, we updated the Admin Upload Workflow so .yxzp workflows uploaded this way can now be versioned as changes are made in Designer or uploaded via the new API. For more information, go to Workflow Endpoints and Workflows: Admin Interface, or access the Swagger documentation by selecting the question mark icon in the upper right corner of Server interface.
Please note that any versions created using the old (v3) version API will continue to be unusable. For example, if you had a workflow and created a second version using the previously released version of /v3/workflows/{workflowid}/versions API, and then you created a third version using the NEW /v3/workflows/{workflowid}/versions API, only the original version and the third version will be usable.
Language and Region Updates
With 2023.1, we extended the language support to the entire Alteryx Server interface available in Chinese, French, Italian, Japanese, German, Spanish, and Portuguese. Additionally, Server Help documentation is available in the supported languages. For our global users, this improves your experience by making it easier for you to access and understand Alteryx Server in your native or preferred language. For information on how to select your preferred language and region, visit the My Profile help page.
Server UI Redesign
Redesigned the Server admin and user interfaces for the pages listed below. The functionality of these pages remains the same. We made these changes within the Alteryx Server interface:
- Login screen: This release we have given the login page a new look.
- Admin and Home screen: Starting with this release, Curators will now see the Home (user) and Admin tabs on the top bar of the application. This change streamlines administrative tasks and improves the user experience by reducing the number of clicks required to access these important administrative features.
- Analytic apps: When you run an analytic app, the option to name the job, set the priority, and assign a worker now appears in a pop-up window after you select the Run button.
- For non-chained analytic apps, the Re-Run option is only available for the last job run for workflows and analytic apps. Please note that if you refresh your browser, the Re-Run option will no longer be available.
- For chained apps, you can navigate back and forth between tabs within each analytic app and edit the information on those tabs. However, you CAN'T navigate back to a previous app if there are multiple chained apps because that app has already been run.
- Notifications: Redesigned the Notifications experience for admins and users. To access them, select the bell from the menu bar in the upper right corner. It also includes an unread notifications counter. The Notifications dropdown summarizes the latest notifications, including their details, and allows you to quickly view them or redirect to the asset that was updated. For more information, go to Notifications.
- Global Search: The global search bar has moved to the top right corner of the application window to provide a more intuitive and user-friendly interface. You can search Workflows, Insights, Districts, Pages, and we’ve added the ability to search for Collections. You can search individual or multiple asset types at a time by selecting the asset type in the filter box. You can navigate through the search results using the pagination at the bottom of the page. For more information, go to Search for Assets.
Additionally, we replaced Lucene search with a custom search provider. This improves search accuracy, expands search capabilities, and provides more thorough search results across the entire Server, while delivering equal or better performance. With this change, the AlteryxGallery_Lucene database and schema are now obsolete. See AlteryxGallery_Lucene MongoDB Schema for specific changes. - Links: To find the Community and help page links, as well as API documentation for users with API access, select the question mark icon at the top right corner of the navigation bar.
These UI changes should improve your user experience with Alteryx and make it easier and more intuitive for you to stay on top of important updates and changes.
Block DCM Connections from Syncing from Server to Designer
As an admin, you can now block the DCM connections synchronization from Server to Designer and from Designer to Server for the entire environment. This feature is useful to ensure that DCM connections in production environments connected to production data sets are not used to create new workflows in Designer. With this feature, you can restrict access to DCM connections for data sets in production environments, while allowing users to sync DCM connections between Server and Designer in development or test environments. To disable sync, go to System Settings > DCM and select the checkbox Block DCM Connections Synchronization between Server and Designer. To allow the synchronization, leave the checkbox unselected. For more information, go to DCM - Server.
Allow Access to Workflows Without Shared Credentials
Added a new feature under Admin > Settings > Configuration > Assets. To allow users to run workflows they have access to, without access to shared credentials, enable the Allow Access to Workflows Without Shared Credentials setting.
When enabled, users can create Designer workflows using Server connections and data sets shared with them. Similarly, analysts (non-admins) can run workflows using those connections. However, users cannot use those connections for other purposes or data sets. Visit the Alteryx Server Settings help page for more information.
Unique Connection Strings for Workers
Added the ability for each worker to define how it connects to the database. Remote worker nodes can optionally set a connection string independently from the controller. This allows a worker to set their own options or credentials.
Worker nodes can now connect directly to MongoDB using an override connection string defined within runtimesettings.xml. This string differs from the controller connection string and other worker connection strings. It allows the worker to use a configurable connection when communicating directly with MongoDB so that workers can use unique credentials that admins can audit. Currently all connections are either sent through the controller or use the same connection the controller has.
For more information, visit the MongoDB Advanced Connection Strings help page.
Update of the Server UI Page in Alteryx System Settings
We updated Alteryx System Settings to put emphasize the Default Run Mode setting. You can now find this setting at the top of the Server UI > General page instead of at the bottom. We also updated the help information for this setting to clarify what this setting does and why it is important. For more information, go to Server UI.
jQuery Removed
We’ve completely removed jQuery v1.9 from Alteryx Server interface.
Fixed and Known Issues
Fixed Major Release Version 2023.1.1.123 |
|||
---|---|---|---|
ID | Description | Version | Issue Status |
TGAL-6264 GCSE-339 |
Users are not shown in the Add User dropdown of Data Connections when the username consists of Japanese characters only. | 2023.1.1.123 | Fixed |
TGAL-6357 GCSE-412 |
Open Workflow From the Server UI window immediately exits. | 2023.1.1.123 | Fixed |
TGAL-6749 | When you update the Account Lockout Time under Admin > Settings > Configuration > Security, the Account Lockout Time value is reset to default after reloading this page. | 2023.1.1.123 | Fixed |
TGAL-6751 | Admin login page using SAML doesn't display the SAML login screen. | 2023.1.1.123 | Fixed |
TGAL-6754 | When you replace a workflow with another workflow, the version tracking doesn’t work if both workflows were uploaded via the API or from the Admin Server UI. | 2023.1.1.123 | Fixed |
TGAL-6756 | When a user with Curator (admin) rights attempts to use the Replace Workflow button to replace a Designer-uploaded workflow with an API or Admin UI-uploaded workflow, the user gets an error. | 2023.1.1.123 | Fixed |
TGAL-6761 GCSE-803 |
The PUT /v3/schedules/{id} endpoint fails when updating a custom schedule using Last in the Days parameter. | 2023.1.1.123 | Fixed |
TGAL-6769 |
The connection is only shared with direct members of the User group on Alteryx Server, not with members of the AD group that is part of this User group on Alteryx Server. | 2023.1.1.123 | Fixed |
TGAL-6794 | When you save a new version of a workflow that already has a schedule, the new version runs only once and then the schedule switches back to the previous version of the workflow. | 2023.1.1.123 | Fixed |
TGAL-6807 | If the pre-migration process is interrupted, the created files are not deleted after the premigration is completed successfully. | 2023.1.1.123 | Fixed |
TGAL-6825 | The Migration Prep Tool accepts multiple inputs on the initial prompt for input, reading them in sequence. Thus “yy” can approve multiple commands without the user’s knowledge. | 2023.1.1.123 | Fixed |
TGAL-6836 | When a workflow is added via the v3 API endpoint and is public, the DateMadePublic attribute is not being populated. | 2023.1.1.123 | Fixed |
TGAL-6909 | Corrected an issue where the installer wasn't recognizing the version of MongoDB properly during an upgrade if a patch had been applied to update MongoDB from 4.2.15 to 4.2.22. This caused the installer to incorrectly report an error indicating the user was attempting to upgrade from an unsupported version of MongoDB. | 2023.1.1.123 | Fixed |
TGAL-6916 | When editing a schedule via the PUT to /v3/schedules/id endpoint, it fails with the error "This workflow requires credentials". | 2023.1.1.123 | Fixed |
TGAL-6934 TMEE-880 |
Server Admin interface: When you try to delete a workflow as an admin, the snackbar message "Workflow deleted" appears, but the same workflow reappears in the list. If you try to delete it again, you will see a red error banner stating that it failed to delete. | 2023.1.1.123 | Fixed |
TGAL-6965 GCSE-954 |
The POST admin/v1/workflows/ endpoint breaks the ability to run a workflow if this workflow has a different name than the originally uploaded workflow. | 2023.1.1.123 | Fixed |
TGAL-7009 | When using the POST /v3/workflows endpoint, the sourceAppId argument behaves improperly - it doesn't work as an overwrite. Each time it's called, even if the sourceAppId doesn't change, it creates a new workflow and returns a new unique id. | 2023.1.1.123 | Fixed |
TGAL-7017 | Anonymous users (not logged in) are unable to run public workflows even when the “Unregistered Users Can Run Workflow on the Homepage” setting has been enabled. | 2023.1.1.123 | Fixed |
TGAL-7036 | Addressed a potential race condition when retrieving a key. | 2023.1.1.123 | Fixed |
TGAL-7060 TPRI-912 |
For the workflows which are changed to public, the date is not displayed in the table in the column Made Public under Admin > Workflows. | 2023.1.1.123 | Fixed |
TGAL-7078 GCSE-1069 |
The Limited Availability 2022.3 Server workflows fail to re-upload after encryption. | 2023.1.1.123 | Fixed |
TGAL-7080 | Unable to delete user via API. | 2023.1.1.123 | Fixed |
TGAL-7291 GCSE-1121 |
Users cannot add a new data connection for Microsoft SQL Server with Windows Authentication via Server admin interface. | 2023.1.1.123 | Fixed |
TGAL-7350 | Workflow revisions display as version 0 in the Server UI. | 2023.1.1.123 | Fixed |
TGAL-7411 | Admin credentials: Unable to create credentials in FIPS environment. | 2023.1.1.123 | Fixed |
TGAL-7425 | Unable to create DCM Credential, DCM Vaults, and DCM Data Source in FIPS environment. | 2023.1.1.123 | Fixed |
TGAL-7785 | Designer can’t connect directly to a remote controller to create or manage schedules (Desktop Automation/Scheduler). | 2023.1.1.123 | Fixed |
TPRI-713 GCSE-637 |
Output messages on Analytics Apps run in Server are not being displayed correctly. | 2023.1.1.123 | Fixed |
TPRI-772 GCSE-726 |
When you edit a weekly schedule in 2022.1, it selects all days instead of the days you had previously selected. Also, the "No ending date" checkbox is not prepopulated. | 2023.1.1.123 | Fixed |
TPRI-816 TGAL-6801 |
Sidebar: My Workspace tab item is not getting highlighted when selected, while being actually active. | 2023.1.1.123 | Fixed |
TPRI-849 GBETA-330 |
Server UI/UX Improvements: Menu items are not translated to Japanese. | 2023.1.1.123 | Fixed |
TPRI-859 GBETA-342 |
Server UI/UX Improvements: "Asset Management" message is not translated. | 2023.1.1.123 | Fixed |
TPRI-860 GBETA-343 |
Server UI/UX Improvements: Excerpt text in Districts > Create District has an editing issue. When you add a character to the middle of the text, the cursor automatically goes back to the end of the text. | 2023.1.1.123 | Fixed |
TPRI-933 | In versions 2021.4+, only the workflow owner and curators can access Workflow Settings. In the previous releases, all users with access to the workflow could access Workflow Settings. | 2023.1.1.123 | Fixed |
TPRI-935 | Unable to add Users to a Subscription on a Server configured for Windows Authentication. | 2023.1.1.123 | Fixed |
TPRI-1071 | When you attempt to run a version of a workflow other than the latest (most current version), the workflow is not being run correctly. Server is not sending the correct version to be run. | 2023.1.1.123 | Fixed |
TPRI-1487 | When owners of a workflow or app manually run a workflow in Server immediately after changing the published version to a version that differs from the latest (or newest) version of that workflow, Server will run the published version on the first manual run as opposed to the latest version. Subsequent manual runs will execute the latest version as expected. | 2023.1.1.123 | Fixed |
Known Major Release Version 2023.1.1.123 |
|||
---|---|---|---|
ID | Description | Version | Issue Status |
TCPE-373 GCSE-589 |
Regression issue: PCXML previews are not rendering URLs in Server 2022.3+. | 2023.1.1.123 | Known |
TCPE-672 GCSE-1329 |
Server UI Error on Japanese, Chinese, French, and Italian Operating Systems: An HTTP 500 error displays when you open the Server UI (for example, HTTP500 Internal Server Error: Cannot show this web page.) To work around this issue, change the language setting on the non-English operating system to English and install Alteryx Server. Change the language back to your preferred language after installation. | 2023.1.1.123 | Known |
TDT-1842 TSPA-986 |
App re-run functionality is failing for Map tool. | 2023.1.1.123 | Known |
TGAL-6394 GS-610 |
Daylight Saving Time (DST) alters future interval scheduling of jobs/workflows. They are being pushed to the top of the hour when scheduled during the DST window of 2AM - 2:59AM. For more information about the DST change, visit Schedules: Time Zone Support. | 2023.1.1.123 | Known |
TGAL-6467 GCSE-464 |
Daylight Saving Time (DST) is causing schedules to run at incorrect time in Server - schedules are shifted an hour forward or backward during the Daylight Saving Time. For more information about the DST change, visit Schedules: Time Zone Support. | 2023.1.1.123 | Known |
TGAL-6745 GCSE-723 |
Server API V3: Setting “application/xml” or “text/xml” in the Accept header of the API request returns an error or does not return the results in the XML format. | 2023.1.1.123 | Known |
TGAL-6852 | Insights are not rendering on multi-node environments. When you open an insight and run a workflow in Designer and then want to publish it in Server UI, the URL link shows that the insight is not rendering and an error message is displayed. | 2023.1.1.123 | Known |
TGAL-6964 | When you re-run a Chained App on Server with the Re-Run button, the first app in the chain is shown instead of the last app in the chain. Before the fix to the Re-Run button, the last app in the chain was displayed and changes could only be made to the final app. | 2023.1.1.123 | Known |
TGAL-7052 TGAL-7018 |
When you add or delete insights, the results counter is displaying incorrect count in the table. | 2023.1.1.123 | Known |
TGAL-7677 | Global search fails if the workflow / insight / districts / collection name contains special characters. | 2023.1.1.123 | Known |
TGAL-7825 | Insights might not render in multi-node environments and display the message "Error rendering insight. If this problem persists, please contact your Systems Administrator." To work around this issue, please ensure the Insights worker is enabled on your controller. | 2023.1.1.123 | Known |
TGAL-7846 | When Administrators upload workflows using the "+New" button in the Admin UI, workflows are not being validated as they were in previous versions of Server. | 2023.1.1.123 | Known |
TPRI-1298 | The View in Browser functionality is breaking from Designer after saving the workflow to Server due to a problem with token-based authentication. | 2023.1.1.123 | Known |
TPRI-1320 | Admin Jobs page is empty with no tabs. When a job is kicked off in Server, the job doesn't automatically appear on the Admin Jobs page in real time. In order for the job to appear, you must manually refresh the page to see the new job added to the queue. | 2023.1.1.123 | Known |
TPRI-1409 TGAL-7449 |
The table height on the Admin Subscriptions page doesn't adjust automatically. | 2023.1.1.123 | Known |
TPRI-1481 | Link and Image Properties options under Admin > Pages and Admin > Districts are not localized. | 2023.1.1.123 | Known |
TPRI-1492 | App re-run button displays on job runs other than the latest job run. | 2023.1.1.123 | Known |
TPRI-1575 GCSE-1302 |
System messages do not appear when first logging in to Server. | 2023.1.1.123 | Known |
TPRI-1695 TCPE-692 |
Regression issue: PCXML previews are not rendering URLs in Server 2022.3+. | 2023.1.1.123 | Known |
Security Updates
Fixed Major Release Version 2021.3.1.1.123 |
|||
---|---|---|---|
ID | Description | Version | Issue Status |
TGAL-2207 | To be disclosed.* | 2023.1 | Fixed |
*In accordance with security best practices and to prevent potential manipulation by bad actors, Alteryx does not disclose the details of any open vulnerability until all supported versions are updated with a fix. More information will be made available once the vulnerability has been fixed for all supported versions known to be affected.