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.
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.
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
Alteryx licenses do not need to be saved to any particular folder in order to be authenticated. Once you double click on the license file in the email you have received from Product Fulfillment, the packaged licenses will be automatically extracted to their proper location by the License Manager.