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.
Welcome to Part 4 of the License Series. While we hope you never have to visit this page, we know that each unique environment can cause issue with installing any software and want you to be able to quickly resolve the license issue. Below are some common errors we see with users attempting to activate a license.
Welcome to Part 2 of the License Series and how to install your Alteryx License. If you have not read Part 1 of the series, we recommend starting from the beginning especially if you are new to Alteryx.
11.8 and newer License FAQ - Licensing-FAQ-Alteryx-11-8
11.7 and older licensing information below
We have two different ways to activate your license. A license key or a license file. A license key will be able to be used if the company has the setup as seen in Part 1 and has internet access. If the user does not meet the requirement, or does not have internet access, the user will have to use a license file. Both of these will be sent to you in an email.
Your license key or file is your access to Alteryx.
Licensing Issues or questions please email: firstname.lastname@example.org
PLEASE KEEP YOUR LICENSE KEY EMAIL OR FILE. We ask that you keep this email due to equipment changes that may occur. This will make it easy and quick for you to get back up and running if for whatever reason you are no longer using Alteryx on your current machine.
Important: The license will be associated to a user's email. Only unique emails can be used with the license key. The user cannot use their email address more than once on the same key. Nor can a license be utilized with one email address on two machines simultaneously. Each machine and email needs to be licensed per your contract. If a user wants Alteryx deployed on more than one machine, the user would need two keys or use two seats with different emails on the same key.
Understanding Seats on your license:
License keys are created with a minimum of one seat and a maximum of 300. License Owners may distribute the key to as many named end users as there are seats. For instance, if my license key contains 10 seats, the License Owner will distribute the license to 10 named end users to activate with their email address. Active named users will appear on the Gallery. See the ‘License Management’ section found in Licensing Series Part 3 for more information on how to manage users on the gallery and the responsibilities of a License Owner.
Here is what your license key email information consists of:
Number of seats
Expiration date of license
Alteryx Designer Install Screen:
Server Activation Screen. This will be different from Designer as many of the activations will be offline:
Example of License File:
If you are using license files, you would receive an email from one of our Fulfillment team associates with the file attached. Save this file to the machine that has Alteryx deployed. Once saved, double click on the file and Alteryx will open with the License Manager window showing what is on the license file.
When activating a license, you may receive the below window when you have the Alteryx Scheduler or Server installed making you aware that Admin rights are necessary to run these versions. If you have the Scheduler or Server please select the License Designer and Scheduler option:
In some cases, your license may need to be manually authenticated. The reason for this may be that the machine Alteryx is on has a proxy setting that does not allow Alteryx to get to its licensing server or that your machine is offline. The error below is asking to try and use the manual authentication process:
If you receive this suggestion, please select OK and send an email to email@example.com with the Serial Number, System ID, and Request Code asking for the Unlock Code for Manual Authentication:
Installing a license key the AlteryxActivateLicenseKeyCmd executable can be found within the bin directory of the Alteryx install. The following command installs and authenticates a license key and produces an error on failure. Usage: AlteryxActivateLicenseKeyCmd.exe [LicenseKey] [User email address]
Installing a License File the SrcLicenseManager executable can be found within the bin\bin32 directory of the Alteryx install. The following command installs and authenticates a license file silently and does not produce any errors or warnings on failure.
Alteryx Command Line Install Guide
Now that you know how to install your license. Let's move onto Managing your License!
License Series Part 1 - Welcome to Alteryx
License Series Part 3 - Managing Your License
License Series Part 4 - License Errors
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.