Installing License Server

Added by Mike Aizatsky, last edited by Ekaterina on Jan 14, 2008  (view change)

Prerequisites

Extract the License Server delivery package (for example, licenseServer-tomcat-130.zip).
To install and configure the server, perform the following steps:

  1. Install JRE/JDK
  2. Run Apache Tomcat
  3. Launch License Server
  4. (Optionally) configure automatic License Server discovery
  5. Setup License Server

If you have Apache Tomcat already installed, copy licenseServer.war from
<delivery package>/apache-tomcat-<version>/webapps/ into the <Tomcat root>/webapps subdirectory and launch
License Server by typing http://<host-name>:<port-number>/licenseServer in the address bar of your browser.
Then proceed to Step 4 or 5.

1. Installing JRE/JDK

If JRE 5 or later is already installed on your system, proceed to step 2, "Running Apache Tomcat."

Otherwise, install Java SE Runtime Environment (JRE) 5 or later, which you can
download from http://java.sun.com/javase/downloads/.

Create an environment variable JAVA_HOME and assign it to the path where JRE is
installed, e.g. c:\Program Files\Java\jre1.6.0_03 or /usr/local/java/jre.

NOTE: To define the JAVA_HOME environment variable in Windows, select
Start > Settings > Control Panel > System > Advanced > Environment Variables.
In User environment variables for..., click Create. In the New System Variable dialog box,
enter JAVA_HOME in the Variable name field, and then enter the path to the JRE installation
in the Variable value field. Click OK.

To define the JAVA_HOME environment variable in UNIX/Linux, execute the env JAVA_HOME=path command.

(Optional) Configuring External Database

------------------
See Using External Database document.

2. Running Apache Tomcat

To run Apache Tomcat, execute <Tomcat root>\bin\startup.bat (Windows) or <Tomcat root>/bin/startup.sh
(UNIX/Linux/MacOS). This should not only launch Tomcat but also deploy the licenseServer.war package.
License Server will start listening through port 8080 with the licenseServer path prefix.

NOTE: Consult Apache Tomcat help for guidelines on changing these parameters.

3. Accessing License Server Control Panel

Open your web browser and type http://<host-name>:8080/licenseServer in the address bar.

4. Configuring Automatic Server Discovery

To configure automatic License Server discovery, add a DNS TXT record
'url=<server_url>' for the name: _jetbrains-license-server.<network-domain-name>.

To verify the record, run 'dig _jetbrains-license-server.<domain_name> TXT' in any Unix environment.
A valid response should look like this:

_jetbrains-license-server.acme.com. 3600 IN TXT "url=http://lsserver:8080/licenseServer"

5. Server Setup

When you open License Server control panel in your web browser for the first time, the Setup Server page opens
where you should complete four mandatory fields:

  • Administrator's E-mail (used as admin ID);
  • Password (min 6 characters);
  • Confirmation (confirm password);
  • SMTP Server (the address of your company's SMTP server).
  • "From" address

Labels

 
(None)