---
title: License Server
slug: license-server
docTags: 
createdAt: 2022-03-30T22:04:53.000Z
---

Manufacturing Connect uses an embedded license server to provide site-based licenses to edge device.

After receiving a site license key from the [Customer Portal](https://portal.litmus.io/), a respective site license can then be generated and added to the embedded license server. The site license will then be automatically used when  activating an edge device with Manufacturing Connect. See [Create a Configuration and Activate an Edge Device](docId\:JalA8oA1dTK8BdVoENAwA) for more information.

The License Server Management pane includes the following sections.

- **Core License List:&#x20;**&#x53;hows the activated site licenses and their statuses for edge devices
- **Offline Activation:** Enables you to activate a site license key with the license portal, and add the respective site license.
- **License Clients** tab: For Manufacturing Connect version 2.12.0 and later. It allows you to manage the list of Manufacturing Connect Edge instances that are clients to the license server. You can also add license clients directly and connect it through a proxy.

# Access License Server Management UI&#x20;

**To access the license server management UI:**

1. Do one of the following:
   -     Log in to Manufacturing Connect. From the Navigation panel, select **Admin Console**.
   - Log in to Manufacturing Connect Admin Console.
2. From the Navigation panel, select **License Server**.
   The *License Server Management* pane appears.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/ro-Bwhw3LW4U9QAbPUV0i_image.png" size="80" width="1920" height="931" position="center" caption="Manufacturing Connect Admin Console : License Server Management" showCaption="true"}

# License Server

:::hint{type="info"}
**Note**: For Manufacturing Connect version 2.12.0 and later, the user interface is split into two tabs: *License Server* and *License Clients*.&#x20;
:::

You can view and manage the following sections in the *License Server* tab.&#x20;

## Core License List

The Core License list includes the following information.

- **Status**: Shows the status for each site-license feature.
- **License Name**: Shows the name of license features included for your connected edge devices.
- **Expiry Date:** Shows the expiration date for the license feature.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/CT4yZ37tiTWysLhlMICJ1_image.png" size="80" width="1673" height="256" caption="Manufacturing Connect Admin Console : License Server Management : Core License" position="center" showCaption="true"}

| **Action**                             | **Details**                             |
| -------------------------------------- | --------------------------------------- |
| \[1] **Show filter** / **Hide filter** | Search by *License Name*, *Expiry Date* |
| \[2] **Refresh**                       | Update the list.                        |
| \[3] **Action menu**                   | - Remove                                |

## Offline Activation&#x20;

You can add a single site-based license for edge devices from the *Offline Activation* section in the *License Server Management* pane. Once added, edge devices that have been or will be activated with a site license will use the added site-based license.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/BC1uEKhwLKdz9G5uC3zKB_image.png" size="80" width="1676" height="466" caption="Manufacturing Connect Admin Console : License Server Management : Offline Activation Step 1" position="center" showCaption="true"}

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/dHpdVsOURrMBwJSbadPRX_image.png" size="80" width="1672" height="304" caption="Manufacturing Connect Admin Console : License Server Management : Offline Activation Step 2" position="center" showCaption="true"}

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/hojuF4k8JUMDkuTB6v68B_image.png" size="80" width="1667" height="373" caption="Manufacturing Connect Admin Console : License Server Management : Offline Activation Step 3" position="center" showCaption="true"}

### Before You Begin

Make sure you have a site-license key, which you can request from the [Customer Portal](https://support.litmus.io).&#x20;

### Add a Site License Offline

**To add a site-based license offline:**

1. From the *Create Activation Request* section:
   - In the **License Key** field, enter the site-license key.
   - (Optional) From the **License Type** drop down menu, select a license type to add.
   - Click **Generate request**.     &#x20;The activation request appears in the *Activation request* field.
   - Next to th&#x65;*&#xA0;Activation request* field, Click the **Copy activation request** icon. The activation request is copied to your clipboard.
   - Click **Next**.
2. From the *Make license file* section, click the **License Portal** link. The **Licensing Portal** page opens in a new tab.
   - In the **Activation Request** field, paste the activation request, and then click **Make License**. (You may need to verify **I'm not a robot**) The encoded license appears in the *Activation Result* field.
   - Next to the *Activation Resul&#x74;**&#xA0;***&#x66;ield, click the **Copy** **content to clipboard** icon.
   - Return to the *Make license file* section in the *Offline Activation* browser tab, and then click **Next**.
3. From the *Add License***&#xA0;**&#x73;ection, in the **License&#xA0;**&#x66;ield, paste the encoded license, and then click **Add License**.&#x20;
   The license is added.

# License Clients

:::hint{type="info"}
**Note**: For Manufacturing Connect version 2.12.0 and later, the user interface is split into two tabs: *License Server* and *License Clients*.&#x20;
:::

The *License Clients* tab allows you to add clients that haven't been activated to a license server. You have the option to use a proxy.&#x20;

The *License Clients* tab allows you to manage the list of Manufacturing Connect Edge instances that are clients to the license server. You can also add license clients directly without having to first activate through Manufacturing Connect and connect it through a proxy.

**To create an activation request for a device on the license server:**

1. From the *License Clients* tab, click the **Add&#x20;**&#x69;con.&#x20;
   The *Create New Request* dialog box displays.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/ieETVBM68F7AUCHnu-70n_add-activation.png" size="80" width="1402" height="432" position="center" caption="The Add icon for a license server device" showCaption="true" indent="2"}

2. Configure the details for the request.&#x20;
   - **Label**: Enter a label to identify the activated device.
   - **URL**: Review and confirm the license server URL. Update the port value as needed.&#x20;
3. Click **Create**.&#x20;
   The *New Request Created* dialog box displays.&#x20;
4. Click the **Copy&#x20;**&#x69;con for the activation request.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/wTWQveJSHe8XHg_qzztfi_new-request-created-dialog-box.png" size="60" width="511" height="307" position="center" caption="New Request Created dialog box" showCaption="true" indent="2"}

5. Log in to the Manufacturing Connect Edge instance you want to activate and navigate to **System&#x20;**> **License**.&#x20;
6. In th&#x65;*&#x20;License Server Settings* section, click **Set Server**.&#x20;
   The *Set License Server Configuration&#x20;*&#x64;ialog box displays.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/BXyYC4WUk-dUY3gjHp3Hy_set-server-button.png" size="80" width="1377" height="422" position="center" caption="Set Server button" showCaption="true" indent="2"}

7. In the **Configuration&#x20;**&#x66;ield, paste the request you copied earlier and click **Save**.&#x20;

If the activation was successful, a success message displays.&#x20;

To remove an activated device from the list, click the **Action menu** and select **Revoke activation**.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/KnfSWBncoyv26SPlTP12r_image.png" size="80" width="1402" height="470" position="center" caption="Action menu for an activation request for a license server device" showCaption="true"}

