Note: These steps are for acquiring and installing licenses for Appian 23.1.
This document outlines the procedure to request and install temporary and long-term Appian product license files. Every time the product license is provided by Appian, it will be in the form of two separate files with the same expiry date. Depending on the request, both the license files (k3.lic
and k4.lic
) could be of the temporary or long-term type.
Temporary license files are only valid for 6 days and can be used on any server as long as the operating system matches.
This type of license files should be requested in one of the following scenarios:
Long-term license files are valid for an extended period of time and can only be used on the server that they were requested for.
This type of license files should be requested in one of the following scenarios:
In order to request long-term license files, information about system configuration is needed which can be obtained by running the q executable.
Note: If you already have a valid license (k4.lic) in the directory and want to generate the output containing the system configuration, the k4.lic file needs to be removed from the directory before running the q executable.
To generate the q output, navigate to the following location:
<APPIAN_HOME>/data-server/engine/bin/q/l64/
<APPIAN_HOME>\data-server\engine\bin\q\w64\
Use the following commands to run the executable:
QHOME=.. ./q
set QHOME=..&& .\q.exe
If there is no valid temporary or long-term k4.lic license file already installed, you will get an output containing the system configuration and ’k4.lic
printed on the last line. The output will look similar to this:
1
2
3
4
5
6
KDB+ 3.5 2017.06.19 Copyright (C) 1993-2017 Kx Systems
l64/ 8()core 15129MB *user* myhost.acme.com 192.168.1.1
'K4.lic
Copy the output of the command to a text file and save it for future reference. You will need the copied output in order to request the long-term license files and to renew the license files in future.
Since long-term license files can take 4-5 business days to obtain, you can first create a request for temporary license files to continue the setup. Then, you can create a request for long-term license files using the output copied after running the q executable. You can also request for temporary and long-term license files together.
The License Management Application allows registered users on Forum to request temporary and long-term product license files to install Appian. Perform the following to request the license files:
Note that generating the long-term license files can take up to 4-5 business days.
The steps to install temporary license files and permanent license files are the same. Licenses are hot-deployable, so you need not stop the Appian components to install a license. You can download and extract the license files from the zip shared with you via task and perform the following steps:
k3.lic
file into one of the following directories, depending on your operating system:
<APPIAN_HOME>/server/_bin/k/linux64/
<APPIAN_HOME>\server\_bin\k\win64\
./k
k.exe
k3.lic
displays.Note: This behavior is different compared to the q executable. In that case, the system configuration output is generated if the license is invalid.
\\
then Enter/Return to exit.k4.lic
file into one of the following directories, depending on your operating system:
<APPIAN_HOME>/data-server/engine/bin/q/l64/
<APPIAN_HOME>\data-server\engine\bin\q\w64\
QHOME=.. ./q
set QHOME=..&& .\q.exe
’k4.lic
is displayed.If output with system configuration and ‘k4.lic
is printed after installing the new license file and running the q script, it could be because of one or more of the following:
How to Request and Install Appian Product License Files