Automatic server discovery
Last modified: 09 December 2024Automatic server discovery makes license activation easier for your users. It prefills the Server address field in the activation dialog so that users don't have to copy and paste the License Vault URL manually.
Set up automatic server discovery
You can use any of the methods described in this section to set up server discovery.
At startup, the IDE checks its settings in a specific priority order, which means that some of these methods can override others. For details, see Priority of the server discovery methods.
Prerequisites
This method only works if your users' machines belong to a single network that uses DHCP.
Usually, DNS TXT records can be added by the system or network administrator.
Adding the DNS TXT record
Add a DNS TXT record with the name _jetbrains-license-server to the DNS zone (domain) that the users' machines belong to. For example, this could be company.com.
If the machines are distributed across several DNS zones, add a separate TXT record to each zone.
For the record's text, provide url=<your-license-vault-url>.
Record example
Let's say your machines belong to the company.com DNS zone, and your License Vault URL is https://company.fls.jetbrains.com.
In this case, you'll need to add the following record to the company.com zone:
_jetbrains-license-server.company.comwith this text:
url=https://company.fls.jetbrains.comVerifying your record
To make sure that your record works, run the following command on a user's machine:
dig _jetbrains-license-server.<your-dns-zone> TXTdig _jetbrains-license-server.<your-dns-zone> TXTnslookup -type=TXT _jetbrains-license-server.<your-dns-zone>If everything is working correctly, the response will look like this:
_jetbrains-license-server.<your-dns-zone>
3600 IN TXT "url=<your-license-vault-url>"For JetBrains products that can be configured using JVM options, you can use the -DJETBRAINS_LICENSE_SERVER option. For its value, provide the License Vault URL.
To check if your product supports JVM options and how to specify them, refer to your product's documentation. For example, here are the instructions for IntelliJ IDEA.
Check your configuration
To make sure that your configuration works correctly, follow these steps on a user machine:
Open a JetBrains IDE and click Help | Register to go to the Licenses dialog.
In the Licenses dialog, select Activate <Your IDE Name> | License server.
Check if your License Vault URL appears in the Server address field:
If you use the environment variable or JVM option to set up server discovery, the License Vault URL will appear in the Server address field immediately at startup.
If you use the DNS TXT record, click Discover Server to pull up your License Vault URL.
note
The Discover Server button checks the DNS record only. It does not use other server discovery methods.
Troubleshooting
If no URL appears in the activation dialog, double-check your settings to make sure your configuration is correct.
If an incorrect URL appears, it might be stored in the IDE cache. Make sure you're using a server discovery method that overrides any cached URLs.
Priority of the server discovery methods
The IDE checks its settings in a specific priority order, which means that some of the server discovery methods can override others.
Caching of the license server URL
When a user activates their IDE via the License server option, the URL is stored in the IDE cache. This cached value can also override some of the server discovery methods.
If you're migrating to a new License Vault instance from a different license server, make sure you use a server discovery method that overrides the cached URL. Otherwise, users may not be directed to the new instance.
Server discovery methods invoked at startup
At startup, the IDE checks for available license server URLs in the following order:
Previously used URL stored in the IDE cache
Once a valid value is discovered, the IDE stops further checks and fills the Server address field with the discovered URL.
DNS search
A DNS search is initiated only if the user clicks the Discover server button. If a DNS record is found, its value overrides any previously discovered URLs, including the cached value from previous activations.
Thanks for your feedback!