Managing Licenses
SDK Browser manages licenses for each SDK installed on the current PC: in order to use UnigineEditor or debug builds of the engine, it is required to keep SDK Browser launched on the currently used computer.
Having just installed SDK, you should activate your license with one of the following license activation types:
Release builds of the engine do not require connection to SDK Browser. Release builds based on the SIM Per Channel SDK edition may require Channel USB License Dongle.
To activate SDK, click Activate on the SDK panel.
In the window that opens, choose one of the license activation types:
License activation types are available depending on your license. If some license activation type is not available as supposed, contact your company admin for assistance.
If you do not have stable Internet connection, SDK Browser can work in the offline mode. However, in this case, it is required to activate your offline license.
Having activated a license for SDK, you can see the info about it by using the License Info button.
In the window that opens, the information on the current license is available:
- License type
- Account
- Expiration date of runtime and updates
License Manager#
A company admin can manage licenses via the License Manager. To open it, perform these steps:
-
Go to developer.unigine.com and log in with your account.
-
Go to the License Manager of My Company section.
Licenses
Available licenses and information are listed in the Licenses section.
Support | Expiration date and availability of access to the Support section. |
---|---|
Forum access till | Expiration date and availability of access to the Forum section. |
Docs access till | Expiration date and availability of access to the Docs section. |
The License table describes the following license features:
Product | Product name. |
---|---|
Seats | Number of available seats. |
Updates till | Expiration date of SDK updates. |
Runtime till | Expiration date of runtime. |
Allocated Seats#
The seat is a kind of workplace for a developer or an artist involved in project development. It can be taken by any member of the team at a certain moment, then released and taken by another member.
Information on allocated seats is available for each purchased product in the Allocated Seats section. Here you can see the number of free seats and available activation methods which depend on your license.
The info on allocatted seats is listed in the table with these parameters:
Type | License activation type. |
---|---|
Info | Information about user. |
Use to remove the account from the seat thus increasing the number of free seats.
Floating License#
This type of license activation is account-locked.
If you have a stable Internet connection, your licenses are retrieved automatically from your developer.unigine.com account. That means you can switch between PCs.
To activate SDK with this type of activation:
-
Run SDK Browser and sign in with your credentials.
- Go to the SDKs tab of UNIGINE SDK Browser.
- Click Activate on the SDK panel.
-
In the window that opens, choose Floating License and click Activate.
SDK will be activated and locked to the current account.
You can switch from Floating License to Fixed anytime. For that, perform the following steps:
- Click License Info on the SDK panel.
- Click Change to Fixed.
- Activate SDK with the Fixed license activation type.
Fixed License#
This type of license activation is node-locked. That means SDK is locked to the current PC and will not be available on other machines.
Internet connection is not required for work with this type of license. However, it is required for activation: you can activate Fixed license in the two following ways.
Online Activation#
If you can provide a stable internet connection for one-time activation, this type of license activation is your choice. Your licenses are retrieved automatically from your developer.unigine.com account.
To activate SDK with the Fixed license activation type:
- Run SDK Browser and sign in with your credentials.
- Go to the SDKs tab of UNIGINE SDK Browser.
- Click Activate on the SDK panel.
- In the window that opens, choose Fixed License (Online Activation) and click Activate.
SDK will be activated and locked to the current PC.
Offline Activation#
If you do not have a stable internet connection, you can perform offline activation of the Fixed License.
To activate your offline license:
-
Run SDK Browser and click Go Offline.
- Go to the SDKs tab of UNIGINE SDK Browser.
- Click Activate on the SDK panel.
-
In the window that opens choose Fixed License (Offline Activation).
-
Copy the request code to the clipboard or write it down.
The request code is used to generate the activation code. However, activation code generation is available for company administrators only. Therefore, you need to provide this request code to the company administrator so that they can generate the activation code according to Steps 5-10. After receiving the activation code (Step 9), activate the offline license on your PC.The Request code is PC-dependent, so it can be used to generate the activation code for one PC only.
-
Go to developer.unigine.com and log in with your account.
-
Go to the License Manager of My Company section.
- Click Get offline code.
-
Paste or type in the Request code obtained on Step 5 and click Get. The *.key text file with the activation code will be generated.
If the user changes the PC, a new activation code must be generated.
-
Copy the activation code to the clipboard or save it as a *.key text file on the local disk by pressing the corresponding link.
Depending on your web browser settings, the file can be automatically saved in the folder used by the web browser to store downloaded files. Usually, it is the Downloads folder.
-
On the computer, from which the Request code has been obtained, go to SDK Browser and paste the activation code (or click Open Key File, choose the obtained *.key file with the activation code in the file dialog window that opens, and click Open).
- Press Activate.
-
SDK will be locked to the current PC.
USB License Dongle#
A USB license dongle holds licenses under hardware control thus allowing you to run SDK Browser with no need for Internet access in any way.
On Windows:
- Insert the USB license dongle into the USB port.
- Run SDK Browser. Authorization process will be done automatically (the sign-in form will be skipped). Don't eject the dongle while working.
On Linux:
- Check if your operating system contains the udev subsystem.
- Run the SDK_Browser/bin/install_grdnt_udev_rules.sh script (the root user's rights are required).
- Insert the USB license dongle into the USB port.
- Run SDK Browser. Authorization process will be done automatically (the sign-in form will be skipped). Don't eject the dongle while working.
In case of multiple seats, insert a dongle into any single PC in the local network. Other licenses are retrieved automatically in the same way as for online licenses.
In case of multiple dongles used in one local network:
- Insert a dongle into any PC in the local network. This PC is going to be the licensing host.
- Use the command line to run SDK Browser on the licensing host and set its IP and Port in the local network as command-line parameters. For example:
After being started, SDK Browser on the host will wait for connection to Port 4545.
browser.exe -licensing_host 192.168.1.1:4545
- Run SDK Browser on the PC that is going to work under the license as follows: set the argument containing the parameters of the licensing host via Customize Run Options to run the application, or via Customize UnigineEditor Options to edit it.
On the PC that has a dongle inserted (licensing host), SDK Browser shall be running. Other PCs that retrieve the license can do without SDK browser and open the Editor or build directly.
USB License Dongles for SIM Per Channel SDK#
Two types of USB license dongle are used for SIM Per Channel SDK:
- Seat HASP — a license used for development. Is used as an access to the allocated seat.
- Channel HASP — a license used for release builds, i. e. for each instance of the released application.