~~NOTOC~~

<WRAP noprint>

> Administrator Manual #@IC_HTML@# > Installation

====== License service ======

----

The **ELIAS License Service** is a utility program ("EliasLicenseService") and is required to run the full version of #@IC_HTML@#. When running the installation wizard ("infra_CONVERT-Setup.exe" in the regular installation package), the license service is automatically installed locally on the computer. However, it can also be downloaded and installed separately ("EliasLicenseService-Setup.msi").\\ 
 **Siehe** Homepage > Service > Download > Software > [[https://www.elias-gmbh.de/en/service/download#icnew|infra CONVERT]] > infra CONVERT Lizenzservice

<WRAP group>
<WRAP column half>

The functions included in the purchased license scope are unlocked accordingly with the license service in #@IC_HTML@#. Without activation #@IC_HTML@# can only be used in the demo version.\\ 
 **See** At a glance > [[en:infra-convert:info#The range of functions basic and pro|The range of functions basic and pro]]

The license service can be installed locally on the same machine where #@IC_HTML@# is running.\\ 
 **See** User manual> Installation > [[en:infra-convert:user:installation:licsingle|Set up a local license]]

However, the license service can also be installed on any computer (server) in a network. Instances of #@IC_HTML@# (clients, users) accessible via the network can then share a license. The clients compete for the seats (concurrent user license model).\\ 
 **See** User manual> Installation > [[en:infra-convert:user:installation:licfloat|Set up a server license]]

As a general rule, the license service must be continuously available during the use of #@IC_HTML@#.

</WRAP>
<WRAP column half>
<WRAP centeralign>

{{ :en:infra-convert:dev:lizenzservice_lokal_server.png?nolink&0x500 | }}

</WRAP>
</WRAP>
</WRAP>

\\ 

<WRAP noprint>
<WRAP group>
<WRAP column 48%>
//**__Inhalt__**//

 • [[en:infra-convert:dev:license_service#System requirements]]\\ 
 • [[en:infra-convert:dev:license_service#License client - operate license service without infra CONVERT]]\\ 
 • [[en:infra-convert:dev:license_service#Enable port for the license service]]

\\ 

</WRAP>
</WRAP>
</WRAP>

==== System requirements ====

<WRAP group>
<WRAP indent>
<WRAP column 5%>
{{ :en:infra-convert:user:installation:icon_betriebssystem.png?nolink&35 }}
</WRAP>
<WRAP column 25%>
**Operating system**\\ //at least//
</WRAP>
<WRAP column 60%>
Windows 7 Service Pack 1 (SP 1),\\ Microsoft Windows Server 2008 R2 (SP 1)
</WRAP>
</WRAP>
</WRAP>

\\ 

<WRAP group>
<WRAP indent>
<WRAP column 5%>
{{ :en:infra-convert:user:installation:icon_ms_net_framework.png?nolink&35 }}
</WRAP>
<WRAP column 25%>
**Microsoft Framework**\\ //at least//
</WRAP>
<WRAP column 60%>
.NET Framework 4.5.2
</WRAP>
</WRAP>
</WRAP>

\\ 

<WRAP group>
<WRAP indent>
<WRAP column 5%>
{{ :en:infra-convert:user:installation:icon_webanbindung.png?nolink&35 }}
</WRAP>
<WRAP column 25%>
**Web connection**\\ //Internet access//
</WRAP>
<WRAP column 60%>
Not required
</WRAP>
</WRAP>
</WRAP>

\\ 

===== License client - operate license service without infra CONVERT =====

The license client is a console application that allows you to operate the license service without #@IC_HTML@#. You can find the program in the installation directory of #@IC_HTML@#.

<WRAP group>
<WRAP indent>
<WRAP column 65%>
<code>C:\Program Files\ELIAS GmbH\infra-CONVERT-Core\LicenseClient.exe</code>
</WRAP>
</WRAP>
</WRAP>

The actions described below can be executed by passing start parameters with the following syntax. The parameters in square brackets are optional; if no parameter is specified, information is output for help.

<WRAP group>
<WRAP indent>
<WRAP column 65%>
<code>LicenseClient.exe [server=<servername>] [<command> OR <filename>]</code>
</WRAP>
</WRAP>
</WRAP>

\\ 

<WRAP group>
<WRAP column half>

|< 100% 5% 25% 75% >|
^ Address license server ^^^
^ <servername> || Set UNC network address of the license service (host and optionally the port as URL). Without this parameter the license service will be searched locally ("localhost"). |
^ Read out information ^^^
^  1  ^ Status | Query the status from the license service and output it as a string.\\ \\ **NoLicenseFound** No license found\\ **Invalid** License invalid\\ **InvalidActivationKey** Invalid registry key\\ **Expired** License expired\\ **ValidUntil** License valid until a certain date\\ **Valid** License is valid\\ **AllLicenseInUse** All license places are occupied\\ **ServerNotFound** The license server could not be found (= Status message of the license client) |
^  2  ^ RegKey | Query the registration key and output it as a string. |
^  3  ^ Details | Query the license information and output it in JSON format. |
^ Load license file ^^^
^  4  ^ <filename> | Load a license file from the specified file path. |

</WRAP>
<WRAP column half>
<WRAP centeralign>

{{ :en:infra-convert:dev:lizenzclient.png?nolink&0x500 | }}

</WRAP>

**Example**

Retrieve the registration key of the license service installed on the license server "example-server":

<code>LicenseClient.exe server=example-server RegKey</code>

</WRAP>
</WRAP>

\\ 

==== Enable port for the license service ====

For the connection to the license service, an HTTPS connection to the specified host is established on port 6781. Make sure that this connection is not blocked by a firewall or redirected by a proxy server.

The following example describes how to release the port on the license server for the license service installed there. The description shows the standard case for the Windows 10 operating system with "Windows Defender Firewall".

|< 100% 5% 15% 40% 40%>|
^  Step  ^^  Action  ^  Result  ^
^  1  ^ "Open "Windows Defender Firewall with Advanced Security | **1)** Click on **Settings** in the **Start menu** and then under **Update and Security**. > Open **Windows Security** on **Windows Defender Securtiy Center**. | **1)** "Windows Defender Security Center" is open. |
^ ::: ^ ::: | **2)** Under **Firewall & Network Protection**, click **Advanced Settings** at the bottom. | **2)** The Windows Defender Firewall with Advanced Security application opens. |
^  2  ^ Add new incoming rule | **1)** Click **Incoming Rules** in the directory tree on the left. | **1)** In the middle pane, a list of already defined incoming rules is displayed. |
^  :::  ^ ::: | **2)** Click **Action** > **New Rule...** in the menu bar. | **2)** The "New incoming rule wizard" opens. The required steps are displayed on the left. You are first in the input mask for the "Rule type" step. |
^  :::  ^ ::: | **3)** First select **User defined** as the rule type and click **Next**. | **3)** Die Eingabemaske für den Schritt "Programm" wird angezeigt. |
^  :::  ^ ::: | **4)** Select **This program path**, click **Browse** and select the license service executable file "Common.EliasLicenseService.exe", which is installed by default in "C:\Program Files (x86)\ELIAS GmbH\EliasLicenseService". Then click **Next**. | **4)** The input mask for the "Protocols and ports" step is displayed. |
^  :::  ^ ::: | **5)** Select the protocol type "TCP" from the list and then select the entry **Determined ports** under "Local port". Below this, enter "6781" in the field that is now unlocked. Then click on **Next**.  | **5)** The input mask for the "Range" step is displayed. |
^  :::  ^ ::: | **6)** In the input masks of the steps "Area", "Action" and "Profile" you can change the default settings if required. Click **Next** through these steps until you reach the "Name" step. | **6)** The input mask for the "Name" step is displayed. |
^  :::  ^ ::: | **7)** Specify any name for the rule, e.g. "ELIAS GmbH Lizenzservice" and click **Prepare**. | **7)** The new rule is created, it is displayed in the list of incoming rules. |

<WRAP noprint>

----

<WRAP group>
<WRAP col2>

<WRAP rightalign>
**Go to previous page**\\ 
Introduction > [[en:infra-convert:dev:intro_v2|Overview (Program version 2)]]
</WRAP>

**Got to next page**\\ 
Configuration and Import > [[en:infra-convert:dev:parameter|Startup parameter file]]

</WRAP>
</WRAP>

</WRAP>