This site uses different types of cookies, including analytics and functional cookies (its own and from other sites). To change your cookie settings or find out more, click here. If you continue browsing our website, you accept these cookies.
This article provides an overview of all things Alteryx licensing. This includes our prerequisites for installing and licensing Alteryx, an overview of different ways to activate, links to helpful guides and how to best administrate your keys once activated.
Before downloading Alteryx, be sure your machine meets our technical requirements.
All installers for Alteryx can be found through the licensing portal.
The licensing portal provides users with an active license key access to all products purchased and all versions of that product that are currently supported. For new users we recommend downloading our latest version, which will be under the ‘New Versions’ tab. Should your company have a standardized version of Alteryx or an Alteryx Server, we recommend matching this version. Should they be on an older version, the user can access these installers through selecting the version under ‘Previous Versions’. If you don’t see the version of Alteryx you need, please reach out to the Fulfillment Team and they can assist you directly.
We recommend insuring that our services are white-listed by your IT group to insure the smoothest possible activation and set up process. Provided below are our current white-listing requirements for a successful online activation. On 2018.3 or newer: The white-listing requirements are provided below.
Ports 80 and 443 are open.
White-list the URL: https://whitelist.alteryx.com
Older versions then 2018.3: White-listing requirements for versions older then 2018.3 will be different then all new versions. See your version’s licensing criteria here.
How to Activate Alteryx:
Online Activation: Online activation refers to inputting your license key into Alteryx through either the activation window, that appears upon opening Alteryx for the first time, or through Options > Manage Licenses > Activate New License. This method of activation is best for most users, as it allows a simple activation, easy transfer of licenses between users and devices, provides the ability to activate and deactivate any product keys that are no longer being used, and allows for the easiest administration of the keys for administrators. To activate online, you will need to insure your IT department has completed the white-listing criteria above. This allows for direct communication with our services and the administrator licensing portal. For further information about online activation please see our Online Activation Guide. Offline Activation: Offline Activation allows for those users who have restricted networks and are unable to communicate with our services to still activate Alteryx. This method does require the ability to access http://licenses.alteryx.com through an internet browser. An important note is that this activation type does restrict an administrator’s control over the keys after initial activation. Offline activated machines do not communicate with our licensing platform and the administrator licensing portal. This will result in users being unable to deactivate a key they are no longer using without assistance from the Fulfillment Team, and administrators being unable to easily remove and reassign licenses through the administrator portal. For further information about online activation please see our Offline Activation Guide. Command Line Activation/Silent Activation: Command Line Activation allows a license key to be activated by command line. This activation method is optimal for administrators who would like to push a license to a large number of users. Users’ IT groups can also install and activate Alteryx in batch through a script. Alteryx services must be white-listed to use this activation type. For these commands please see our Command Line Options. Alteryx License Server Activation: The Alteryx License Server, or ALS, is a secondary product Alteryx can provide administrators to better assist them with networking based restrictions and large scale deployments. This product hosts the licenses internally, and thus requires users to redirect their Designer or Server to this licensing service. This can be done by going to Options > Manage Licenses > Activate New License > Selecting ‘To Access Your License Server, Click Here’. Please note the first time connecting to your companies’ ALS, Alteryx will need to be run as Administrator to input the License Server’s URL. For further information about connecting the an ALS please see our Activating Through ALS Guide. To set up an ALS please see our ALS Administrator Guide. Transferring Licenses: License can be transferred between users through the method below. This method only applies to users who have completed an online activation, for offline license transfer, please reach out to our Fulfillment Team. In Alteryx:
Click Options > Manage Licenses.
Select the check box for each license you want to deactivate.
Click Deactivate License.
Click OK to confirm the deactivation.
Once deactivated the key will be open for activation on a different device or by a different user. Should the device no longer be accessible please see our Revoke a License Help Documentation for how to remove a key from a inactive user or no longer accessible device.
The Licensing Portal is a web based portal that allows access to all the product installers and associated licenses. The portal provides two views: End User and Administrator. End User is the default view, which only provides access to the product installers on Home Tab. The License Administrator view has access to downloads, licenses, machines and users. Here is a summary of each tab provided by the portal:
Home: Provides access to all downloads for products that have been purchased as well as the Offline Activation Upload. End Users will only see this tab.
Licenses: Provides a list of all products and license keys associated with your group, and will include expiration dates, total seats and available seats. This allows administrators to identify keys with available seats and current products they have purchased that can be distributed to users.
Machines: Contains a list of all devices associated with your license group. This does include all devices that are currently or have in the past activated a license key associated with this group. This view can be filtered by license key and email address to provide filtered lists containing current active users on a key, or locate a specific user to identify the key they are activated on, if any. Administrators can also revoke keys from inactive users or inaccessible devices from this tab.
Accounts & Users: Accounts provides administrators a view of all the license groups they are associated with. This is beneficial for large companies who have multiple license groups. The Users view allows administrators to update or change a user’s permissions to the portal, including restricting access or providing a user with administrator permissions.
Should you have any other questions or need guidance on how to complete a task in the portal, please see our Administrator Check List, which provides direct links to all guides on all your permissions and abilities.
Provided below is a list of the most common errors a user might run into and their fixes. An important note to keep in mind when running into an activation error is the type of key you have. Keys with dashes are compatible with version 11.8 and newer, keys without dashes are compatible with version 11.7 and older. Unrecognized License Key: This error typically occurs when you try to use the wrong key in the wrong version. Cannot Reach The Licensing Service: The device cannot communicate with our services, this error is common with users who have restrictions networks or proxies in place. The best solution to this would be to have your IT department white-list our services with the criteria under Licensing Requirements. If they are unable to do so please try an Offline Activation. Please note it is best have your IT department assist with adjusting your network settings before doing offline activation as license management will be easier. No Available Seats: The key the user is activating on has no seats left, please have your administrator check the licensing portal to identify any users can be removed from the key. Cannot Connect To License Server: This error is common for users who have accidentally opened the ALS License Manager instead of the default License Manager. The best way to move past this error is outlined in this Knowledge Base Article. Your error not here? Got questions about licensing requirements? Just want to say hi? Reach out to the Fulfillment Team with a screenshot of your error or any questions you might have and they’ll be able to get you back up and running!
The Alteryx License Server, or ALS, is a locally hosted license server meant to help customers with network restrictions activate in an online environment. It is built to exist outside of a company’s network and able to communicate directly with our third party licensing service, Flexera, but also communicate with user devices on secure local networks. Here are some helpful commands for working with it.
A common task that analysts can run into (and a good practice when analyzing data) is to determine if the means of 2 sampled groups are significantly different. When this inquest arises, the Test of Means tool is right for you! To demonstrate how to configure this tool and how to interpret the results, a workflow has been attached. The attached workflow (v. 11.7 ) compares the amount of money that customers spent across different regions in the US. The Dollars_Spent field identifies the amount of money an individual spent and the Region field identifies the region that the individual resides in (NORTH, SOUTH, EAST, WEST).
Hello #AlteryxAddicts, tl;dr tl;dr - Alteryx Partners leveraging the Designer API via .NET should not upgrade to Alteryx Designer 11.8, 2018.1, or 2018.2 because doing so will render API integration inoperable. The issue will be addressed in Alteryx Designer 2018.3 (expected GA end of August 2018) at which time users can safely upgrade. FAQ What Happened? We uncovered a previously unknown issue that renders the Designer API from .NET inoperable for Alteryx Designer 11.8, 2018.1, & 2018.2 (NOTE: API code itself is sound, the issue is 100% attributable to licensing). What is the Designer API? This notice is specifically for APIs accessed via the .NET assemblies such as “Allocate.Net.dll” and “AlteryxAPI.Net.dll”, documentation found on page 1 of: [installdirectory]\Alteryx\APIs\readme.pdf. Why did this happen? In our work to improve the Alteryx Designer Licensing experience, we inadvertently broke the ability to license API in Designer when using the .NET assemblies. This issue was identified and resolved in a timely manner and is expected to be resolved in Alteryx Designer 2018.3. What will this problem look like? - The user will receive a message that the API is not licensed. Who's Impacted? - Anyone leveraging Alteryx API on Designer 11.8, 2018.1, and/or 2018.2. Who's Not Impacted? Anyone leveraging Alteryx Designer API in Alteryx 11.7 and older. Alteryx Designer APIs accessed via C++ or the CLI were not impacted and will continue to work as expected. When will the issue be fixed? Alteryx Designer 2018.3 (expected GA end of August 2018) Next Steps? If you are using 11.8, 2018.1, 2018.2 and the Alteryx API, this issue directly impact you. We recommend downgrading to 11.7 until 2018.3 is released. Otherwise, wait until 2018.3 is released and use API integration with it. NOTE: You can also use Alteryx 11.7 and older without interruption until you choose to upgrade to 2018.3 (or future releases). Questions? Contact firstname.lastname@example.org Alter Everything! -- Alteryx Product Extensibility team
What does this error mean?
As we transitioned to a new licensing system in the 11.8 and 2018.1 releases, we changed how licenses are authenticated. The new licensing system relies on a few additional system requirements, including a number of websites that are used during licensing and require access through your network firewall.
What's causing this?
The new licensing system uses a TLS connection with fno.devops.alteryx.com, which is secured with an Amazon-issued TLS/SSL certificate. Alteryx is packaged with a copy of the Amazon certificate. The problem arises when the network has implemented Deep Packet Inspection on TLS/SSL connections, which is a security measure requiring that a network device be able to intercept the connection and “see” the plaintext conversation. To do this, the device attempts to impersonate fno.devops.alteryx.com but uses its own certificate, which is separately installed as a trusted root certificate on the client computer. However, Alteryx doesn't consult the local computer's trust store when authenticating the license connection. Thus, when Alteryx attempts to construct a TLS session, it sees a certificate mismatch, and the connection fails.
Since this is a network security restriction, you should have no problem activating if you move onto an external network such as a mobile hotspot, home network connection, or coffee shop.
How to confirm the problem
To definitively confirm that they are running into this issue, have them open a browser and go to https://fno.devops.alteryx.com. It will show a blank screen, but up in the corner is certificate information. Click on the lock to view the certificate details.
This window needs to show this exact certification Path. If there are any extra or different entries, that's when this issue occurs.
How to fix it?
IT or your security department need to add a bypass on the SSL packet inspector such that https://fno.devops.alteryx.com is not subject to SSL deep packet inspection. After adding the bypass so this traffic is no longer being interdicted, the issue should be resolved and the customer should try to activate again.
The Dynamic Replace Tool is an under-utilized tool in the Developer Toolset that is very powerful. It allows for dynamic formulas or conditions to be used in your workflow. It was first introduced in Alteryx 6.1 . It’s one of the few tools that is currently multi-threaded which makes is fast.
Ever needed to learn how to use an Iterative macro? This article walks you through the process with a basic mathematical problem highlighting how the data moves through the macro and loops back to continue processing.