Skip to main content

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.

Tip

Depending on the license activation option you choose from the list later on this page, it will require either the end user or license administrator to complete the activation process.

  • End users must activate the license themselves if they activate a free trial, activate their license online, or activate their license offline.

  • License administrators must activate the license on the end users' behalf if they activate using a License Server or activate by command line.

Activate a Free Trial

Activate Free Trial Online

To activate your free trial online...

  1. Open Alteryx Designer.

  2. In the Alteryx Designer Activation window, select Activate under Use a 14-day trial.

  3. In the Alteryx 14-day Trial Activation window, enter your email address. Use lowercase letters when you enter your email address.

  4. 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.

  5. 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...

  1. Open Alteryx Designer.

  2. In the Alteryx Offline Activation window, select Activate.

  3. In the Alteryx Offline Activation window, enter your email address, and select Activate again. Use lowercase letters when entering your email address.

  4. 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...

  1. 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.

  2. In the Alteryx Designer Activation window, enter your email address.

  3. Enter or paste your License keys, one per line.

  4. Select Activate. If your email address has not been previously registered, a registration window displays. Provide your information to continue.

  5. 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

  1. Open Alteryx Designer. If the Alteryx Designer Activation window does not open automatically, select Options > Manage Licenses > Activate New License.

  2. In the Alteryx Offline Activation window, select Create to create a request (.req) file to request product activation.

  3. 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.

  4. Select Create request. Alteryx creates a request file with your email address and .req extension as shown in this example:

    name@company.com.req

  5. 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.

  1. Sign in to the Alteryx Downloads and Licenses portal at licenses.alteryx.com.

  2. On the Home page, select Upload Activation Request.

  3. Select Browse to find and select the request (.req) file.

  4. 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.

  5. 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.

  1. 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.

  2. Select Browse to find and select the activation (.bin) file.

  3. 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...

  1. 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.

  2. Select here within To access your License Server, click here. Alteryx displays Manage Licenses.

  3. In License Server Connectivity, select Connect. Alteryx displays available licenses. If this is the first time you have activated Alteryx, enter your email address.

  4. Select Activate for each product you want to activate.

  5. 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.

  1. Select Options > Manage Licenses.

  2. In the Manage Licenses window, select Activate New License.

  3. In the Alteryx Designer Activation window, enter your email address.

  4. Enter or paste your License keys, one per line.

  5. Select Activate.

  6. 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.

AlteryxInstallx64_11.x.x.xxxxx.exe /s

RInstaller\RInstaller_11.x.x.xxxxx.exe /s

/l

"<path>"

Creates a log file with information about the install.

Include the full path name including drive letter and existing folder name.

/l="C:\temp\install.log"

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.

SERIAL_NUM="serial number"

TARGETDIR

"<path>"

(Optional) Quotes required. Sets the install directory for Alteryx, Data Products, Scheduler, and Core Components.

TARGETDIR=""

Default:Designer/Server Installs: C:\Program FIles\Alteryx

Designer Non-Admin: C:\Users\\AppData\Local\Alteryx

Example:

AlteryxInstallx64_11.x.x.xxxxx.exe /s /l="C:\temp\install.log" TARGETDIR="C:\Program Files\Alteryx"

ALLUSERS

"TRUE"

"FALSE"

(Optional) Quotes required. Allows shortcuts to install for all users on the system.

ALLUSERS="TRUE"

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:

AlteryxInstallx64_11.x.x.xxxxx.exe /s CMD_LANGUAGE=”Français”

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.

D:\Data\DataInstallCmd.exe /s /Install all

/Uninstall

all,

<product>:<dataset name>, <product>:all

Uninstalls the given datasets.

D:\Data\DataInstallCmd.exe /s /Uninstall "CASS:CASS - October 2010"

/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.

DataInstallCmd /s /Install "Portfolio:US Census Data" /Path "C:\Alteryx\Data"

/Log

<log file>

Sets the file name for the install log.

\\network\path\DataInstallCmd /s /RegisterNetwork /Log "C:\temp\logfile\log1.txt"

/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.

DataInstallCmd /s /PrepareNetwork /Replace "CASS:all" /Path "C:\Alteryx\Data" /Log "C:\temp\logfile\log1.txt"

/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.

AlteryxActivateLicenseKeyCmd.exe 111a-12ab-aa12-3abc-12a1-1234-1ab1-123c name@company.com createRequest c:\temp\name@company.com.req

*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 -help

flexnetlsadmin.bat

Run the -flexnetlsadmin.bat -help command from the enterprise folder to view available commands:

C:\Program Files\Alteryx\LicenseServer\enterprise>flexnetlsadmin.bat -help

LicenseServerAdminCmd.exe

Run the LicenseServerAdminCmd.exe -help command from the enterprise folder to view available commands:

C:\Program Files\Alteryx\LicenseServer\enterprise>LicenseServerAdminCmd.exe -help

List 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.

In this section: