---
title: Set Up an Activation Config
slug: bhdm/set-up-an-activation-config
createdAt: 2022-09-27T16:07:17.000Z
---

An activation configuration can be configured with limits, license keys, template and/or template variables. These configurations are all entirely optional. Some of these configurations have existing default values while others can be left blank. These configurations are all implemented in the first four steps and can be skipped if no additional customization is needed.&#x20;

Generating the details for an activation configuration occurs only in *Step 5: Save* while retrieving the key details are in *Step 6: Retrieve Activation Code/URL*.

# Before You Begin

- If you are using a node-locked license, make sure you have a license key for deployment.
- If you are using a site-based license, make sure you have the URL and port for the license server.

# Step 1: Configure Limits

You have the option of configuring limits, specifically number of edge devices, lease TTL and expiration date. If no changes are needed, proceed to the next step.&#x20;



![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/CKBAz8LL2if4QQGqWb4E4_image.png "Belden Horizon Data Manager User UI : Activation > Configuration : Activation Config 1/6 Config Limits")

- **Number of Edge devices:** Enter the number of devices that will share the activation code. The activation code (created after saving) can be used for multiple edge device activation.
- **Lease TTL&#x20;**&#x66;or identity certificat&#x65;**:** Enter the number of days the activation code is valid to be used for an Edge device activation. &#x20;
- For the **Expiration Date** field, select the date on when the activation code will expire. Specifically, when the Belden Horizon Data Operations instances that use this license will need a new activation code.&#x20;

# Step 2: Configure Licenses and License Types

You have the option of using either a node-locked or a site license. By default, a node-locked license is selected. A node-locked license associates and attaches an license with a Belden Horizon Data Operations instance. A site license is where Belden Horizon Data Operations retrieves a license from a Belden Horizon Data Operations License Server.&#x20;

If no changes are needed, proceed to the next step.&#x20;



![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/NIAcQw3xIXfPrmTrcY-Tz_image.png "Belden Horizon Data Manager User UI : Activation > Configuration : Activation Config 2/6 Configure License and License Type")

**To select license type**:

1. For the **Select license type** field, select either **Node-Locked** or **Site**

- **Node-locked:** Use this for one license to each edge device.
- **Site-based:** Use this to set the license server IP address.

## Configure a Site-based License

Ensure there's a URL and port for the license server. Use this to set the license server IP address. When using this license type, a site-license must be created via [License Server](https://public-docs.litmus.io/bhdm/license-server-management#Tbg4E)'s *Offline activation*.

## Configure a Node-locked License

Ensure there's a license key for deployment. Use this for one license to each edge device.&#x20;

### Add License Key Manually

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/uRqDsvg6qBidrSGDmatri_image.png" size="80" width="1909" height="187" caption="Belden Horizon Data Manager User UI : Activation > Configuration : Activation Config 2/6 Adding node-locked keys manually" position="center" showCaption="true"}

**To manually add a node-locked license key**:

1\. Click the **Add** icon.
The **License Code** field drops down.

2\. Copy from a `.csv` or `.txt `file and paste the license code in the available **License key** field.

### Upload License Keys

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/qcr2r98SleukG2HEpJ28Z_image.png" size="80" width="1909" height="123" caption="Belden Horizon Data Manager User UI : Activation > Configuration : Activation Config 2/6 Uploading node-locked keys" position="center" showCaption="true"}

**To upload node-locked license keys**:

1\. Click the **Upload** icon.

2\. Click **Upload From File**, navigate to the license `.txt` file, and then click **Open**.

- Each license must use a separate line in the `.txt` file.&#x20;
- A `.csv` file can be used if you are bulk uploading licenses.
- You can also enter each license using a separate line manually without clicking **Upload From File**.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/-zJRmHa7fE7D6IZcJlT-4_image.png" size="80" width="638" height="377" caption="Belden Horizon Data Manager User UI : Activation > Configuration : Activation Config 2/6 Uploading node-locked keys : Licenses dialog box" position="center" showCaption="true"}

The licenses appear in the *Licenses&#xA0;*&#x66;ield on separate lines for each license.

3\. Click **Upload**.
The licenses appear in th&#x65;*&#xA0;Licenses List&#xA0;*&#x61;nd display **No** in th&#x65;**&#xA0;In Use** column.

# Step 3: Add Templates

You have the option of applying templates when activating a Belden Horizon Data Operations instance. If the Belden Horizon Data Operations instance doesn't need a template, proceed to the next step.&#x20;



::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/q14cT68fAyANLrr_wquWA_image.png" size="80" width="1912" height="121" caption="Belden Horizon Data Manager User UI : Activation > Configuration : Activation Config 3/6 Add Templates" position="center" showCaption="true"}

**To add at least one template**:&#x20;

1. From the *Template&#xA0;*&#x73;ection, click the **Add** icon.&#x20;
   The *Template Select&#xA0;*&#x64;ialog box appears.
2. Select one or more templates from the list, and then click **Select**. The selected template appears in the *Templates* list.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/MCgx4QDZv_olf1tFVAkvt_image.png" size="80" width="1368" height="436" caption="Belden Horizon Data Manager: Activation > Configuration : Activation Config 3/6 Template Select" position="center" showCaption="true"}

# Step 4: Add Template Variables

You have the option of applying template variables when activating a Belden Horizon Data Operations instance. If the Belden Horizon Data Operations instance doesn't need any template variables, proceed to the next step.&#x20;

## Adding Template Variables Manually

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/g7-sWgE2ljjZZl1DaKSUi_image.png" size="80" width="1748" height="102" caption="Belden Horizon Data Manager User UI : Activation > Configuration : Activation Config 4/6 Template Variable : Add Template Variables" position="center" showCaption="true"}

**To add at least one template variable manually:**

1. From the *Template Variables* section, click the **Add&#xA0;**&#x69;con. The *Add new variable set* dialog box appears.

### Adding Template Variables for All Devices&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/Vk2tJngYuNf_pS-qF7g2G_image.png" size="80" width="562" height="327" caption="Belden Horizon Data Manager User UI : Activation > Configuration : Activation Config 4/6 Add new variable set dialog box : All devices" position="center" showCaption="true"}

1\. From the *Add new variable set* dialog box, click the **Variable set type toggle** so it displays *All Devices*.

2\. Click **Add**.&#x20;
The Variable set: *All devices&#x20;*&#x61;ppears in th&#x65;*&#x20;Template Variables* list.&#x9;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/6Iz8EUDRMgyjO0NaND1E__image.png" size="80" width="1187" height="168" caption="Belden Horizon Data Manager User UI : Activation > Configuration : Activation Config 4/6 Add new variables for All Devices" position="center" showCaption="true"}



3\. Click the **Add** icon next to the variable set. The Variables line items drop down.

4\. In the **Variable Name&#xA0;**&#x66;ield, enter a variable name.

5\. in the **Variable Value&#xA0;**&#x66;ield, enter a variable value.&#x20;

### Adding Template Variables for Individual Edge Device

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/Tm7u7SNkHJja9dGV71qTW_image.png" size="80" width="562" height="326" caption="Belden Horizon Data Manager User UI : Activation > Configuration : Activation Config 4/6 Add new variable set dialog box : Per Edge Devices" position="center" showCaption="true"}

1\. From the *Add new variable set* dialog box, click the **Variable set type** toggle so it displays *Per Edge Device*.

2\. In the **Host Name** field, enter the host name for an edge device. To find host name for an edge device, see Configure the Network Settings' *Host Information*.

3\. Click **Add**.
The Variable set: *per Edge Device*:  \<hostname> appears in the *Template Variables* list.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/NaO1bil83TXYg7MX2iL8J_image.png" size="80" width="1191" height="187" caption="BBelden Horizon Data Manager User UI : Activation > Configuration : Activation Config 4/6 Add new variables for per Edge Device" position="center" showCaption="true"}

4\. Click the **Add** icon next to the variable set. The *Variables&#x20;*&#x6C;ine items drop down.

5\. In the **Variable Name&#xA0;**&#x66;ield, enter a variable name.

6\. in the **Variable Value&#xA0;**&#x66;ield, enter a variable value.&#x20;

## Adding Template Variables Using .csv File

Multiple template variables can be uploaded using a `.csv` file. A sample `.csv` file is available to download for customization.



::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/GUyswf9W6xt1B6bLoToli_image.png" size="80" width="1681" height="143" caption="BBelden Horizon Data Manager User UI : Activation > Configuration : Activation Config 4/6 Template Variable : Upload Template Variables" position="center" showCaption="true"}

**To add at least one template variable using a .csv file :**

1. From the *Template Variables* section, click the **Upload&#x20;**&#x69;con.&#x20;
   The *Upload variable sets* dialog box appears.&#x20;
2. (Optional) Click the here link to download a sample `.csv` file.
3. Clic&#x6B;**&#x20;Select File**, navigate to a variable set `.csv` file, and then click **Open**.   &#x20;The selected `.csv` file appears in the *File Name* field.
4. Click **Upload**. The variable sets listed in the `.csv` file appear in the *Variable Sets* list.


# Step 5: Save

Once all the configuration for a Activation Configuration is complete, a save is needed to generate the activation code.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/0hutY6rRef8lIwix4GS5W_image.png" size="80" width="1695" height="678" caption="Belden Horizon Data Manager User UI : Activation > Configuration : Activation Config 5/6 Save" position="center" showCaption="true"}

**To complete an activation configuration creation:**

1. Clic&#x6B;**&#x20;Save**. Once saved, the activation code will then be generated at th&#x65;*&#x20;Activation Code&#x20;*&#x66;ield.&#x20;

# Step 6: Retrieve Activation Code/URL

After a *Save* is successfully complete, the Activation Code will display underneath the *Activation Cod*e section. This code and the *Activation URL* will be needed when activating a Belden Horizon Data Operations instance.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/YjpUzh8bAtdJQyzwgBRDv_image.png" size="80" width="1920" height="937" caption="Belden Horizon Data Manager User UI : Activation > Configuration : Activation Config 6/6 Retrieve activation code/URL" position="center" showCaption="true"}

**To retrieve the activation code/URL** :&#x20;

1. **Copy to clipboard** the *Activation Code*. It will be needed for activating a Belden Horizon Data Operations instance.
2. **Copy to clipboard** the *Activation URL*. It will be needed for configuring a Belden Horizon Data Operations instance.

# Next Steps

Use the copied *Activation Code&#x20;*&#x61;nd *Activation URL* to Activate an Edge Device.

