View source for License Server Quick Start

__TOC__
Follow the steps below to install and use a floating license of an Eigenvector Research product. These licenses use the [[Evri_license_server| EVRI License Server (click for more information]].

===Downloading Files===

1) Download these three items: 
:a) The [http://software.eigenvector.com/toolbox/license_server/EVRILicenseServer.zip license server application] (license server ZIP)
:b) A copy of the software product (e.g. PLS_Toolbox, Solo, Solo+MIA) - these are available from [http://download.eigenvector.com/?tab=1 your account's Downloads tab]. (application installer)
:c) The license files available from [http://download.eigenvector.com/?tab=3 your account's "Other Files" tab] (license files ZIP).

===On the computer which will run the license server===

2) Extract the license server ZIP (downloaded in 1a) onto the server computer (all computers, clients and server must be connected by a network)

3) Copy the ''evriserverlicense.lic'' from the license files ZIP (downloaded in step 1c) into the same folder as the ''EVRILicenseServer.jar'' file (the main folder created when the license server was unzipped).

4) Double-click the ''EVRILicenseServer.jar'' file to start up the server

* ''For other configuration and start-up options, see [[Evri_license_server#Server_Configuration | Server Configuration]]

===On each client computer===

5) Run the application installer downloaded in step 1b (when asked for a license code, choose "Cancel", this will cause the installer to abort. The last step of installation will be done later)

6) Edit the ''evrilm.xml'' file (located in the license files ZIP downloaded in step 1c). Edit ONLY the segment of the file specifying the server address:
<serveraddress>''ip_address''</serveraddress>
:replacing ''ip_address'' with the IP address or name of the computer running the license server

7) Install the ''evrilm.xml'', ''evrilicense.lic'', and ''evrinetwork.lic'' files from the license files ZIP onto the client:
:* '''For Matlab-based products''' (e.g. PLS_Toolbox) copy the files into the "utilities" folder of the product installed in step 4 (usually the Toolbox/{product_name} folder inside the Matlab folder)
:* '''For stand-alone products''' (e.g. Solo, Solo+MIA, Solo_Predictor), copy the files into the main folder of the product (usually located in C://Program Files/EVRI/{product_name} on PCs or similar on other platforms)

8) Finish installation of the product:
:* '''For Matlab-based products'''
::a) Start up Matlab (if not already running)
::b) Change the working directory to be the main product folder
::c) Type the command: ''evriinstall silent'' in the Matlab command window
::d) Verify installation by typing:  ''pls test'' which should return an expiration date (in the future by about 10 minutes)
:* '''For stand-alone products''' 
::Start up the application. The license files should be read and automatically configured to run with the server.

==Troubleshooting==

===Check the license server===
On the license server, start up a web browser (Opera, Internet Explorer, Firefox, etc.) and go to the URL:
 http://127.0.0.1:2212/
you should receive the response: "-2".

'''IF NOT''': the server is not running correctly or ''evriserverlicense.lic'' is not valid. Please review the [[Evri_license_server#Server_Configuration | Server Configuration instructions]] and, if the problem is not resolved, send the contents of the server message window to [mailto:helpdesk@eigenvector.com Eigenvector's help desk]


===Check the network connection===
On one of the client computers, start up a web browser (Opera, Internet Explorer, Firefox, etc.) and go to the URL:
 http://___IP___:2212/
replacing "___IP___" with the IP address of the server computer (same one used in step 6).
You should receive the response: "-2".

'''IF NOT''': the server is not reachable from the client computer, check network connection and firewall status. The license server requires the server computer to allow connections on the license server port (default port is 2212)


===Check the license files===
If the client application (PLS_Toolbox, Solo, etc.) is responding with an "invalid license" message, verify that the evrilicense.lic file is the one provided by Eigenvector for this license. Delete any evrilicense.lic files you have and re-copy the license files provided.

'''If you still have problems''': [mailto:helpdesk@eigenvector.com contact help desk] to verify that the license file you have is appropriate for the application you are running. Please make sure you provide your evrilicense.lic file.