XLSTAT: Manage your XLSTAT license using the command line

xlc is a command line tool allowing you to manage your XLSTAT license via the command line. It is available for Windows and Mac and is located in the XLSTAT installation directory .

It allows operations such as activating, deactivating or printing your license information. A few operations require to be run with elevated permissions, started as an administrator. If so, it will be specified in the help section of that command.

 

Using the Command Line Tool

On Windows

Press the  Windows+R keys of your keyboard, type in  cmd and Press Enter .

A terminal window should appear. 

If you need to run this as an Admin, open your start menu then type  cmd in the search bar. Once the cmd icon appears in the menu, right-click on it then click Start as an administrator .

Validate the popup and you should now have a terminal with elevated permissions. 

Type xlc help to view the Help Information.

Details about a specific command can be viewed using this format:

xlc help status

If instead of the Help information you encounter an error, the XLSTAT installation directory is not included in the PATH variable. In this case, you need to navigate to the directory using the  cd command:

Type cd C:/Program Files (x86)/Addinsoft/XLSTAT

 

On a Mac

Launch the Terminal application, usually located under Utilities in your Applications  directory. The terminal window should appear.

If you need to run this as an Admin, open a terminal as described in the  Using the command line tool section. Prepend commands that need to be started as an administrator with sudo ./ 

sudo ./xlc <operation> <options...>

You should be prompted to enter your password. Once validated, the command will be run with elevated permissions.

You may need to adapt the path above with your own installation path.

Type  xlc help in the Terminal and press enter to view the Help information.

Details about a specific command can be viewed using this format:

xlc help status

If instead of the Help information you encounter an error, the XLSTAT installation directory is not included in the PATH variable. In this case, you need to navigate to the directory using the  cd command:

Type in cd /Applications/XLSTAT.app/Contents/Library

 

Basic Operations

xlc status

Example:

C:\>xlc status
XLSTAT license details
----------------------
Installation_Type: Account
Client_HostID: xXXxXxxXXxxxXXXXXxxx.xXXXXXxxxxXXXxXXXXXX
License_Status: Registered (expiring license)
License_Id: XxxXXXXX-XxxX-XXXx-xXxx-XXXXxXXXXXXx
License_Domain: COMPANY
User_ID: xXxXXXXX-XXXX-XXXX-xXXx-xXxXXxXXxXxx
Alias_Name: My-Alias-Name
Features: XLSTAT 3DPLOT, PREMIUM
Expiration: 2036-07-26

Account Login

xlc account login

Type in this command to log out:

xlc account logout

 

Activate

Online activation

Type in one of these commands and press Enter:

xlc activate -k YOUR\_LICENSE\_KEY

Or

xlc activate -k YOUR\_LICENSE\_KEY -a "YOUR ALIAS"

Use the -a option to create an alias to be associated with the key.

The alias name text must be surrounded by double quotes ("") if it contains spaces

 

Manual activation

On the offline computer, type in this command and press Enter:

xlc activate -o -k YOUR\_LICENSE\_KEY -a "YOUR ALIAS"

The -o option specifies an offline activation code should be generated. This code will be  displayed in the command line window .

Copy the activation code, open an internet browser, go to https://activation.lumivero.com and paste the code into the Certificate field.

Click on  Generate the unlock file

An activation file should automatically be downloaded.

Transfer the file back to the computer running XLSTAT

Import the activation file to the XLSTAT computer:

xlc import -f PATH\_TO\_ACTIVATION\_FILEPATH_TO_ACTIVATION_FILE

Example:  "C:\Users\My User\Desktop\XLSTAT_Activation.bin"
(Enclosing the path in quotes(") if it contains spaces.)

After clicking Enter, a message should inform you of the result of the operation.

 

Deactivate

Online Deactivation

xlc deactivate


 

Manual Deactivation

On the offline computer, type in this command and click Enter

xlc deactivate -o

The -o option specifies an offline activation code should be generated. This code will be  displayed in the command line window .

Copy that code to the computer that is connected to internet, open an internet browser, browse to https://activation.lumivero.com , then paste the code in the  Certificate field. Click on Deactivate .

A message on the website will inform you of the result of the operation.

 

 

Command Summary

Please Note  that the help provided in the command line tool's help  operation is the source of truth and the most up-to-date  and should be trusted over the information provided below.

Operation	Options and details
xlc status [-s Status_Selector]	Displays the license status of XLSTAT or a single detail if a selector is given using option -s (--select). E.g.: C:\>xlc status -s XLSTAT_Solution FORECAST
xlc activate [-o [-f PATH]] -k Activation_Key [-a Activation_Alias]	If option -o (--offline) is given, this will generate an activation code for offline activation instead of trying an online activation. The mandatory option -k (--key) should contain a valid license key. Option -a (--alias) allows to specify an alias for this computer. If it is not given, one will be generated automatically. The activate operation is not available for the Network edition of XLSTAT. Activating for a Campus license will require administrator rights. In the context of an offline activation, the option -f (--file) allows to save the activation code into a file rather than it being printed in the console.
xlc import -f Activation_File_Path	Corresponds to the final step of the manual activation. -f (--file) Location of the offline activation file to be imported in order to activate XLSTAT with.
xlc deactivate [-o]	-o (--offline) Allows to specify that an offline deactivation code should be generated. To be used on our deactivation website.
xlc refresh [-a New_Alias] [-k License_Key]	Refresh the license by contacting XLSTAT licensing services.
xlc settings [get [Setting_Name]] [set Setting_Name Setting_Value]	Allows to manage the XLSTAT license environnement settings. Please use this operation with care.
xlc help [Operation]	Displays the tool's help document. No option.

 

xlc account commands

Operation	Options and details
xlc account info	Prints details regarding the current account session.
xlc account login	Establishes a new account session by prompting for login.
xlc account logout	Closes the current account session.
xlc account refresh	Refreshes the current account session without user interaction.
xlc account licenses	Retrieves the list of licenses that are assigned to the currently signed-in account.
xlc account newtrial	Requests the creation of a new license trial for current signed-in user on this machine.

 

xlc network commands

Operation	Options and details
xlc network connect Server_Hostname [-p Server_Port][-global]	Connects the licensing of XLSTAT to the license server designated by the given Server_Hostname. The port can be changed via option -p (--port) if the server listens on a non-default port. You can end the command with -global if you want the connection to be effective for all users of the computer. E.g. C:\>xlc network connect myServer -p 7070 -global will establish the connect to the server named "myServer" on the port 7070 and for all users of the computer. Note that if you don't use the -global option, the connection will be done for the current user using the command.
xlc network disconnect	Disconnects from the license server that has been configured.
xlc network borrow [-d Day_Duration]	Borrows a network license seat for offline use of XLSTAT. The seat will be available on this computer for a duration given by option -d (--duration). It defaults to 7 days. It will expire at the end of this delay. The duration specified can go from 1 day to 365 days. The duration won't exceed the expiration date of the server's license. It can be returned by using the 'return' operation of this application.
xlc network return	Returns a previously borrowed seat to the license server so it is available again before the expiration of the reservation.
xlc network list	Lists the licenses that are available on the network license server the licensing system is connected to. Their license id may be used to specify which license to be retrieved by the client.
xlc network license select License_ID	Sets the license to be retrieved to be the one specified by the provided License_ID. Available license ids may be retrieved via the 'network list' command of this tool.
xlc network license reset	Resets the license id selector to requesting the default license.

 

Troubleshooting, Accessing Command Line Help

If you come acrosse unexpected behaviour/responses to the commands, please referto the help inform ation of the operation you are using on the XLC tool itself. It is the source of truth and contains  the most up-to-date information.

Type in this command to view the Help Information

xlc help

 

Need help?

If you encounter any activation issue, don't hesitate to reach out to our support team here.