Product License
This section covers how to install the product license in the IQ Server.
For details on features and functionality provided by the Sonatype license, see License and Features. See the following KB article to learn about the user-base license model.
Automatic license installation
During the initial setup, the server may be configured to install a license file automatically. This property is not used for existing installations. An error will occur if the license file cannot be accessed.
Add the following property to the config.yml and update the path to your license file. A relative or absolute path may be used.
licenseFile: ./license.lic
Install using the REST API
While the server is running, a license may be installed or removed using the API.
See Product License REST API for details.
Log in for the first time
The first time you log into the server you are required to install a valid product license. The valid license is provided by the account team as .lic
file.
The default server credentials are the user admin
with the password admin123
Navigate to the server URL (e.g. http://localhost:8070)
Enter using the default admin credentials
Upload your .lic file and select
Install License
Accept the user license agreement
Update your admin password
Updating the license
When you renew a Lifecycle or Firewall license with Sonatype, you'll be sent a new .lic file. To update the license, follow the steps below.
Log in as an Administrator
Select the gear from the toolbar
Select
Product License
Select
Update License
Navigate to and upload the license file
The browser UI should immediately update to show the details of the new license file.
License details on the local system
As a Java application, Java saves the license details locally when a license file has been uploaded.
This has the following implications.
Deleting the .lic file does not un-license the installation
Using
Unlicense
from the browser UI does not remove details about the license from the server
Linux Users
Details about your license file are saved in the following location.
~/.java/.userPrefs/com/sonatype/nexus/professional/prefs.xml
Mac Users
Details about the license are saved in the Library preferences.
~/Library/Preferences/com.sonatype.nexus.plist
You may need to use the following command to delete details of the license file.
defaults delete com.sonatype.nexus
Windows Users
Details about the license file are saved in the registry. Use regedit.exe and check both of these locations.
HKEY_CURRENT_USER\Software\JavaSoft\Prefs\com\sonatype\nexus\professional HKEY_USERS\.DEFAULT\Software\JavaSoft\Prefs\com\sonatype\nexus\professional