Activate Alteryx Overview
Use the online activation service to activate an Alteryx product, or use offline (file activation) steps to activate from a computer that cannot access the internet. You can view and manage active licenses in Designer.
Activate a Free Trial
Activate Free Trial Online
To activate your free trial online...
Open Alteryx Designer.
In the Alteryx Designer Activation window, select Activate under Use a 14-day trial.
In the Alteryx 14-day Trial Activation window, enter your email address. Use lowercase letters when you enter your email address.
Select Activate. If your email address has not been previously registered, a registration window displays. Provide your information to continue. Alteryx sends a confirmation email to the registered email address.
In the Activation Success window, select Experience Alteryx.
Activate Free Trial Offline
Alteryx displays the offline activation option if it detects that your computer is in an offline status or cannot access the internet. To activate your free trial offline...
Open Alteryx Designer.
In the Alteryx Offline Activation window, select Activate.
In the Alteryx Offline Activation window, enter your email address, and select Activate again. Use lowercase letters when entering your email address.
In the Activation Success window, select Experience Alteryx.
Activate License Online
Use the license key from your license administrator to activate a product license. A separate license key is required for each product. To activate online...
Open Alteryx Designer. If the Alteryx Designer Activation window does not open automatically, select Options > Manage Licenses > Activate New License. For Alteryx Server, if you have no valid licenses, Alteryx displays Install License. Select OK to continue.
In the Alteryx Designer Activation window, enter your email address.
Enter or paste your License keys, one per line.
Select Activate. If your email address has not been previously registered, a registration window displays. Provide your information to continue.
In the Activation Success window, select Experience Alteryx.
If you want to activate with a file, select Activate with File to open the Alteryx Offline Activation window.
Activate License Offline (File Activation)
As an alternative to online activation, you can submit a request for an activation (.bin) file, upload the .bin file to the Alteryx Downloads and Licenses portal, and then use the .bin file to activate license keys on your computer. A separate license key is required for each product.
To activate Alteryx on a computer that is offline, you must have access to the Alteryx Downloads and Licenses portal on another computer so that you can upload the request (.req) file.
If you want to activate with a file, select Activate with File to open the Alteryx Offline Activation window.
Create a Request (.req) File from Offline Computer
Open Alteryx Designer. If the Alteryx Designer Activation window does not open automatically, select Options > Manage Licenses > Activate New License.
In the Alteryx Offline Activation window, select Create to create a request (.req) file to request product activation.
Enter your First name, Last name, and Email address and then enter or paste your License keys. Use lowercase letters when entering your email address.
Select Create request. Alteryx creates a request file with your email address and .req extension as shown in this example:
name@company.com.req
Select Save to save the request (.req) file where it can be accessed from the Alteryx Downloads and Licenses portal or send the file to your license administrator.
Upload Request File to Downloads and Licenses Portal
Warning
Internet access is required for this portion.
Sign in to the Alteryx Downloads and Licenses portal at licenses.alteryx.com.
On the Home page, select Upload Activation Request.
Select Browse to find and select the request (.req) file.
Select to upload the request (.req) file. The Alteryx Downloads and Licenses portal generates an activation file with your email address and .bin extension as shown in this example:
name@company.com.bin
Alteryx saves the activation file as a binary (.bin) file to the computer's default download location. The .bin file contains the activation information.
Select Save to save the activation (.bin) file so that you can access it from the offline computer.
Open Activation (.bin) File on Offline Computer
On the offline computer, browse to the activation file you created in the previous step. This file must be accessible to the offline computer. If you sent the file to the offline computer, you can search for capabilityresponse.bin file to locate it.
In the Alteryx Designer Activation window on the offline computer, select Back. Alternatively, select Options > Manage Licenses > Activate New License to open the Alteryx Offline Activation window.
Select Browse to find and select the activation (.bin) file.
In the Activation Success window, select Experience Alteryx.
The Alteryx Designer tools are now available.
Activate With License Server
To activate with a License Server...
Open Alteryx Designer. If the Alteryx Designer Activation window does not open automatically, select Options > Manage Licenses > Activate New License. Alteryx Server: If you have no valid licenses, Alteryx displays Install License. Select OK to continue.
Select here within To access your License Server, click here. Alteryx displays Manage Licenses.
In License Server Connectivity, select Connect. Alteryx displays available licenses. If this is the first time you have activated Alteryx, enter your email address.
Select Activate for each product you want to activate.
Select Close.
Activate Add-On Product
Use the Alteryx Designer Manage Licenses window to activate a base product (Alteryx Designer or Alteryx Server), as well as additional products such as Alteryx Data Sets, Alteryx Designer Desktop Automation, and additional server CPU cores.
Select Options > Manage Licenses.
In the Manage Licenses window, select Activate New License.
In the Alteryx Designer Activation window, enter your email address.
Enter or paste your License keys, one per line.
Select Activate.
In the Activation Success window, select Experience Alteryx.
Activate by Command Line
Standard License System
The AlteryxActivateLicenseKeyCmd.exe is stored in the bin directory of the Alteryx install. This command performs certain licensing functions described below.
Install Designer
AlteryxInstallx64_.exe [options]
Run the command-line options from the directory where the Alteryx install executable has been saved.
Option | Parameters | Description |
|---|---|---|
/s | Suppresses all dialogs.
| |
/l | "<path>" | Creates a log file with information about the install. Include the full path name including drive letter and existing folder name.
Log files may increase installation time. |
REMOVE | TRUE FALSE | (Optional) If True, only the uninstall of an existing product will be performed. If False or blank, previous versions will be uninstalled before proceeding with the install of the new product. |
SERIAL_NUM | "Serial Number" | (Optional) Quotes required. Sets the serial number on the machine. Should match the serial number of the license to be installed.
|
TARGETDIR | "<path>" | (Optional) Quotes required. Sets the install directory for Alteryx, Data Products, Scheduler, and Core Components.
Default:
Example:
|
ALLUSERS | "TRUE" "FALSE" | (Optional) Quotes required. Allows shortcuts to install for all users on the system.
Default: "FALSE" for Non-Admin installs and "TRUE" for Admin installs. |
CMD_LANGUAGE | "English" "Français" "Deutsch" "Português" "Español" "Japanese" | (Optional) Quotes required. Sets the language of the install. Default: English Example:
|
Install Data
DataInstallCmd.exe [options]
Run the command line DataInstallCmd.exe from the directory where the data install executable has been saved.
Option | Parameters | Description |
|---|---|---|
/Install | all, <product>:<dataset name>, <product>: all | For example, /Install all, is /Install AlteryxMap:all Installs all products available in the co-located DataInstall.ini file or a subset specified by specific product and/or dataset name.
|
/Uninstall | all, <product>:<dataset name>, <product>:all | Uninstalls the given datasets.
|
/Replace | all, <product>: <dataset name>, <product>:all | Replaces older vintages of datasets with new versions specified in the DataInstall.ini file. |
/Path | <install_path> | Requires quotes if the path contains spaces. Sets the path for the installed data.
|
/Log | <log file> | Sets the file name for the install log.
|
/PrepareNetwork | Prepare a Network install; this requires that /Replace or /Install be used to identify the installation files and /Path <install path> be set. It cannot be used in conjunction with /RegisterNetwork. It has no meaning with /Uninstall.
| |
/RegisterNetwork | Register from a Network Location; this requires that a /PrepareNetwork has been done and is being run from the Net location described by the /Path in /PrepareNetwork. It cannot be used with /Install, /Replace, or /Uninstall. /Path has no meaning in this context. |
Valid Products include AlteryxMap, CASS, Calgary, Explorer, Guzzler, Portfolio, StreetWare, Zip9Coder, and CanadaCentroidCoder. The DataInstall uses datasets specified in DataInstall.ini that is located in the same directory as the executable.
List License Keys
AlteryxActivateLicenseKeyCmd.exe
The Alteryx command-line executable AlteryxActivateLicenseKeyCmd.exe is stored in the bin directory (for example, C:\Program Files\Alteryx\bin) of the Alteryx install.
Usage | Syntax/Exampe | Description and Parameters |
|---|---|---|
List license keys on a machine | AlteryxActivateLicenseKeyCmd.exe list | Displays the product name and license key for each active license. |
Activate License Online
AlteryxActivateLicenseKeyCmd.exe
The Alteryx command-line executable AlteryxActivateLicenseKeyCmd.exe is stored in the bin directory (for example, C:\Program Files\Alteryx\bin) of the Alteryx install.
Usage | Syntax/Exampe | Description and Parameters |
|---|---|---|
*Activate a license key on a machine | AlteryxActivateLicenseKeyCmd.exe [license key] [email address] | Activates a license key for a machine. Required: license key, email address |
*Activate multiple license keys on a machine | AlteryxActivateLicenseKeyCmd.exe [license key] [license key 2] [license key n] [email address] | Activates one or more license keys for a machine. Required: license key, email address |
*Internet access is required.
Activate License Offline (File Activation)
AlteryxActivateLicenseKeyCmd.exe
The Alteryx command-line executable AlteryxActivateLicenseKeyCmd.exe is stored in the bin directory (e.g., C:\Program Files\Alteryx\bin) of the Alteryx install.
Usage | Syntax/Example | Description and Parameters |
|---|---|---|
Generate license request file | AlteryxActivateLicenseKeyCmd.exe [license key 1] [license key 2] [license key n] [email address] createRequest [filename]. | The system creates a request file. The request file is used to create an activation (.bin) file. Alteryx creates a request file with the extension .req as shown in the example below: name@company.com.req Required: license key, email address Optional: filename Include the full path name including drive letter and existing folder name.
|
*Create license activation file | AlteryxActivateLicenseKeyCmd.exe [request file directory] processRequests [activation file directory] | The system creates license activation files for a directory of request files. Required: request file directory Optional: activation file directory |
Load license activation file | AlteryxActivateLicenseKeyCmd.exe [filename] | The system loads the license activation file and activates the license. Required: filename |
*Internet access is required.
Deactivate License
AlteryxActivateLicenseKeyCmd.exe
The Alteryx command-line executable AlteryxActivateLicenseKeyCmd.exe is stored in the bin directory (for example, C:\Program Files\Alteryx\bin) of the Alteryx install.
Usage | Syntax/Example | Description and Parameters |
|---|---|---|
*Delete a license key from a machine | AlteryxActivateLicenseKeyCmd.exe [license key] delete | Removes a license key from a machine and frees up the license for use on another machine. |
*Delete all license keys from a machine | AlteryxActivateLicenseKeyCmd.exe delete | Removes all license keys from a machine and frees up licenses for use on another machine. |
*Internet access is required.
Change License System
AlteryxActivateLicenseKeyCmd.exe
You can use the command line to change the license system for a machine from standard to local license server (LLS). If you change the license system, the user of the machine will lose access to any active licenses for that license system. The licenses will be available to the user if you change the system back again.
For more information, see or Manage Licenses in Designer.
The Alteryx command-line executable AlteryxActivateLicenseKeyCmd.exe is stored in the bin directory (for example, C:\Program Files\Alteryx\bin) of the Alteryx install.
Usage | Syntax/Example | Description and Parameters |
|---|---|---|
Change to local license server for a machine | AlteryxActivateLicenseKeyCmd.exe setLicenseServerSystem [URL] [email] | Sets the license system to local license server (LLS). Required: Email. This is the email address or serial number associated with the machine. Optional: URL. Sets the URL for the local license server (LLS). If not defined, the user enters the URL in the Manage Licenses window. "> |
Change to standard license system for a machine | AlteryxActivateLicenseKeyCmd.exe setStandardLicenseSystem | Sets the license system to standard. |
License Server
Use License Server
flexnetls.bat
Run the -flexnetls.bat -help command from the server folder to view available commands:
C:\Program Files\Alteryx\LicenseServer\server>flexnetls.bat -helpflexnetlsadmin.bat
Run the -flexnetlsadmin.bat -help command from the enterprise folder to view available commands:
C:\Program Files\Alteryx\LicenseServer\enterprise>flexnetlsadmin.bat -helpLicenseServerAdminCmd.exe
Run the LicenseServerAdminCmd.exe -help command from the enterprise folder to view available commands:
C:\Program Files\Alteryx\LicenseServer\enterprise>LicenseServerAdminCmd.exe -helpList License Keys Mapped Onto License Server
LicenseServerAdminCmd.exe
The Alteryx command-line executable LicenseServerAdminCmd.exe is stored in the enterprise folder (for example, C:\Program Files\Alteryx\LicenseServer\enterprise) of the Alteryx License Server install.
Usage | Syntax/Example | Description and Parameters |
|---|---|---|
List license keys on a machine | C:\Program Files\Alteryx\LicenseServer\enterprise>LicenseServerAdminCmd.exe -s [server URL] -u admin -p [admin password] -l Example: C:\Program Files\Alteryx\LicenseServer\enterprise>LicenseServerAdminCmd.exe -s http://BF-LT-192:7070 -u admin -p Admin1234# -l | Displays the product name and license key for each active license. |
Manage License Expiration
See Manage Licenses.
Administrator Options
See Administer Machines.
Troubleshoot Activation Issues
Use this information to find solutions for errors that may occur when activating Alteryx.
Error Message | Solution |
|---|---|
A license key could not be activated. | You entered an invalid or expired license key, or there are no more available seats. Use lowercase letters when typing your email address. License keys are case sensitive. Copy and paste the license key in the same form it was provided. Ensure you have a valid license key for the product or products you are trying to activate. Check your system to see which environment you are trying to activate in. For example, a Server OS environment requires a license key that allows for this. Contact your license administrator or sales representative to obtain a new license key. |
Your computer is unable to access the activation service. | The license key cannot be activated online. Contact your license administrator to obtain a new offline activation file. See Activate License Offline. |
The activation file is invalid. | The activation file used to activate a license for an offline computer is unreadable or invalid. Contact your license administrator to obtain a new offline activation file. See Activate License Offline. |
A license key for an add-on product has been activated without an active base product (Alteryx Designer or Alteryx Server). | The license key for an add-on product was activated, but it cannot be used because Alteryx Designer or Alteryx Server must be activated as well. Contact your license administrator to obtain a new license key for Alteryx Designer orAlteryx Server. See Activate Alteryx. |
This machine is out of compliance with your organization's license agreement. | An Alteryx Server license was activated on a machine that has more cores than the number of cores for which it is licensed. To find out how Alteryx defines cores for licensing its products, visit this Alteryx Community article. Contact your license administrator to obtain a new license key for additional server CPU cores. See Manage Licenses. |
It appears that you do not have Administrator or Power User privilege. Licenses installed may only be available to the currently logged-in user. Some other functionality may not be available. | You were logged on as a non-administrative user of the machine when you activated a product. If you want the license to be available to all users of the machine then run the install and license process as Administrator. |
See Manage Partner Data Licenses for information about serial numbers.