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.
on 09-12-201808:34 AM - edited on 02-27-202012:15 PM by KylieF
Introducing the Alteryx License Server
The Alteryx License Server is available with Alteryx versions 2018.3 and newer. Also referred to as Local License Server, or LLS, this is an optional method for an organization’s IT department to deploy and manage Alteryx products. This option is an addition to the standard method of using license keys.
The Alteryx License Server is an implementation of our technology partner Flexera Software’s Local License Server, and enables the deployment of a local license server within an organizations’ internal network. This allows for a smoother and more secure deployment of Alteryx products, especially behind proxies and firewalls.
Note: This guide references an optional method of deploying Alteryx products using the Alteryx License Server. To find out more about the standard method of using license keys, visit one of the following:
The Alteryx Local License Servermay be deployed on any device on your company’s network that meets the technical requirements located in the attached FlexNet Embedded 2018 R1 License Server Administration Guide. The Alteryx License Server may also be deployed on any device already running an Alteryx Server.
Once deployed, a pool of Alteryx license keys may be activated on the LLS. Individual Alteryx Designer and Alteryx Server users may then freely connect to the LLS via a URL on the local network. When a client Alteryx Designer or Alteryx Server connects to the License Server, the available pool of licenses will be available for license activation in a list presented to the user.
Once connected to an Alteryx License Server, available licenses may be activated and deactivated from a list.
How does this work with pre-Flexera licensing? The Alteryx License Server uses the Downloads & Licenses portal for licensing, just like the new licensing system. This means that the licenses do not appear in the Alteryx Gallery like pre-11.8 licenses, and your license keys should have dashes (-). These license keys would have arrived in an email like this one.
The license administrator receives an email like this, with all licenses associated to an order.
Do we need special license keys for customers that are already in the new system? No, the same license keys may be used as for the regular system. The license administrator / IT admin will just need to add these licenses to the Alteryx License Server for people to license against.
Can I control what licenses are available for my users to activate? Yes. The simplest way to manage what licenses are available for connected devices to access is to only map licenses to the LLS that you would like users to be able to access. For example, if there are 100 Alteryx Designer licenses, but only one Alteryx Server license, it may be preferable to license the Alteryx Server using the standard license key method rather than map this license to the LLS. In order to create more comprehensive access control to licenses, it is possible to set up Reservation Lists on the Alteryx License Server. To learn more about how to do this, see the section on Managing Reservations in the attached FlexNet Embedded 2018 R1 License Server Administration Guide.
What products are supported with Alteryx License Server?
Alteryx Designer and Alteryx Serverversions 2018.3 and later are supported for licensing against an Alteryx License Server.
What happens if a computer with Alteryx Designer or Alteryx Server loses contact with the Alteryx License Server?
If Alteryx loses its network connection to the License Server, it will remain licensed with its current license keys for 1 week (7 days). After this grace period, the licenses would disappear from the local machine and those license seats would return to the pool on the License Server. If you just haven't been using Alteryx for over a week, then it will try to synch up with the License Server next time Alteryx is started up; this would re-activate any of those license keys behind the scenes.
How do I get my hands on the Alteryx License Server?
If you'd like to try out this free, optional deployment method, reach out to your Account Executive at Alteryx. They would be happy to add this product to your organization's area of the Downloads & Licenses portal for you to download.
Download the latest Alteryx License Server executable (e.g., AlteryxLLS_2018.X.X.XXXXX.exe) from the Downloads & Licenses portal, along with the supplementary FlexNet Embedded 2018 R1 License Server Administration Guide. This supplementary guide, published by Flexera Software, is the primary reference for maintaining the Alteryx License Server.
Verify that your system meets the prerequisites for installation:
Supported Platforms The Alteryx License Server supports Windows Server OS. See FlexNet Embedded 2018 R1 License Server Administration Guide for specific OS details.
Virtual Machine Support See FlexNet Embedded 2018 R1 License Server Administration Guide for a full list of supported virtualization platforms.
Java RuntimeEnvironment A Java 8 Runtime Environment is a necessary component that needs to be set up before installing the Alteryx License Server. Ensure that a JRE is installed and check that the JAVA_HOME (or JRE_HOME) environment variable is set to the path for your default JDK or JRE installation. The JRE may be downloaded from the Oracle Technology Network.
A Java Runtime Environment is a prerequisite for installing the Alteryx License Server.N.B. Sometimes having multiple versions of Java installed will mess up the environmental variables that are used by the License Server. Make sure that only the supported Java SE Runtime Environment 8 is installed.
Microsoft .NET Framework Ensure that the latest Microsoft .NET Framework is installed. For more information about Microsoft .NET Framework, visit Microsoft .NET Framework Runtime.
Run the Alteryx License Server installer as an administrator.
Run the installer as an administrator.
Select where you would like to install the Alteryx License Server. The default location is C:\Program Files\Alteryx\LicenseServer.
Accept the Software & Data License Agreement.
When prompted, enter an admin password. It will be necessary to provide this password when administrating the Alteryx License Server, for example when mapping licenses to the LLS. The username that corresponds to this password is always "admin".
Set a password to carry out authenticated actions on the License Server.
Troubleshooting the admin password:The default password for the Alteryx License Server out-of-the-box is "Admin1234#". If something went wrong during installation, try using the default password to change your password. See the FlexNet Embedded 2018 R1 License Server Administration Guide for information on changing your password.
To start up the Alteryx License Server, click Finish.
Click "Finish" to start the Alteryx License Server.
After clicking Finish, it may take a few minutes to start up the LLS. When successful, you will see a new Windows Service called "AlteryxLicenseServer".
Check your Services to see if the License Server was installed successfully.
You can also verify the service via command line.
Mapping License Keys to the Alteryx License Server
Now that the License Server is up and running, the next step is to map license keys to the server. This will allow you to create a list of the licenses available for users to activate.
Identify your server's network address and port. This is the IP address of the machine, but could also be a DNS record. The default port used by the Alteryx License Server is port 7070.
Use "ipconfig /all" to quickly identify the IPv4 address.
For example, my Windows Server's name is DEN-DEV-LIC-01 and I use the default port of 7070, so the network address of my Alteryx License Server is http://DEN-DEV-LIC-01:7070.
Open a command prompt as an administrator and navigate to the "enterprise" folder. Then, activate one or more license keys using this command:
flexnetlsadmin.bat -server <Network Address : Port> -authorize admin <Password>-activate -id <License Key>-count <How many seats should be available?>-activate -id <License Key>-count <Seats>-activate -id <License Key>-count <Seats>
Use the flexnetlsadmin.bat command to map licenses to the License Server.
You can use a command line to check which licenses have been successfully mapped onto the LLS. This prompt should also be run from the "enterprise" folder.
If you need to remove a license from the pool, simply use the same command except with a count set to 0 seats.
Offline key activation using the Alteryx License Server
If the License Server is not able to communicate with Flexera, it may be that you need to adjust your firewall, open needed ports, or configure your proxy to permit that communication. You can temporarily authorize licenses offline, just as an end user would activate a single license key seat offline independent of the the License Server.
Create a request file: Open a command prompt as an administrator and navigate to the "enterprise" folder. Then, activate one or more license keys using this command (without carriage returns--all a single command).
Licensing Alteryx Designer or Alteryx Server against the LLS
Now that the Alteryx License Server is installed and licenses have been mapped to it, individual devices on the network may connect to it. Here is how an Alteryx Designer user would activate a product using the LLS.
Download the latest Alteryx Designer executable (eg. AlteryxInstallx64_2018.X.X.XXXXX.exe) from the Downloads & Licenses portal. Only versions 2018.3 or newer will be eligible for licensing against an Alteryx License Server.
Select the second radio button and click "Finish".
Open Alteryx as an administrator. The connection to the Alteryx License Server can only be established when running under elevated permissions.
Run as an admin to connect to the LLS.
When Alteryx starts up, you should see one of the following Activation windows.
Left: Normal Activation window. Right: The file authentication window is shown when Alteryx has difficulty contacting the activation service.
Click the link outlined in red above, that reads "To access your License Server click here".
Provide an email address and the network address of your LLS. The email is used only to identify the device for the license administrator in the Downloads & Licenses portal and is never shared.
Make sure to add "/request" to the end of the LLS network address.
Click Connect to establish a connection to the Alteryx License Server. You should now see the licenses which are mapped to the LLS and available to you.
The license key details have been obfuscated in this screenshot.
Use the buttons under the Action column to Activate or Deactivate the licenses you would like to use on this device.
Pick and choose licenses from the list.
Using Command Line to create a deployment script
Many of the manual steps described above have command line analogues that may be used to script up a deployment package or app. The below is taken largely from our help documentation, under Use Command Line Options.
Installing Alteryx Designer. The Alteryx executable may be run from the command line, allows specifying various options:
/s to suppress dialogs
/l for logging
REMOVE for uninstallation
SERIAL_NUM sets the email address associated with the device
TARGETDIR sets the installation directory
ALLUSERS allows for creating shortcuts for all users on the system
CMD_LANGUAGE sets the language to install
Once Alteryx Designer is installed, command line may also be used to connect Designer to the Alteryx License Server. The below can be found under Change license system.
The deployment script can automatically connect to an Alteryx License Server.
It is also possible to script up the license activation step, so the user doesn't need to activate licenses manually. The commands for this are the same as for activating licenses in a regular deployment of Alteryx that does not require an Alteryx License Server. Here are the commands for online activation.
A command line script may use the online activation commands to activate licenses from an Alteryx License Server.
Administering the Alteryx License Server from the Downloads & Licenses portal
The Alteryx License Server may be found in the list of devices associated with your organization in the Downloads & Licenses portal at licenses.alteryx.com.
Locate the Alteryx License Server by navigating to "Administer Machines".
Machines > Administer Machines
The easiest way to find the License Server is by using the filter functionality in the top-right of the screen, above the list of machines.
Filter on "Active" and "Local License Servers".
Click on the name of the Alteryx License Server to view details for the LLS.
The name of the machine corresponds to the physical address of the Ethernet adapter supporting the Alteryx License Server.
Open the LLS details to view license keys and quantity of seats mapped to the LLS.