--- 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. 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. See [License Server Management](docId\:FK7wm14xfcBInPs7ZbeUf). # Step 1: Configure Limits After navigating to **Activation **> **Configuration **and clicking the **Add activation config** icon, you can start configuring the 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. ![](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 for identity certificate:** Enter the number of days the identity certificate for the activation will be valid from the day you activate the edge device. - **Expiration Date**: Select the expiration date when the activation code can no longer be used. # 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 a license with a BHDO instance. Use this option for assigning one license to each edge device. - A site license is where BHDO retrieves a license from a BHDO License Server. Use this option to set the license server IP address. See [Site and Node-Locked License Overview for Belden Horizon Data Operations](docId\:TMwxRxbDzBiIZhXlpSAdq) to learn more. If no changes are needed, proceed to the next sub-step. ![](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") ## Configure a Site-based License Ensure the site-based license has already been applied in BHDM before activating the device. The site license must be created through *Offline activation* in [License Server Management](docId\:FK7wm14xfcBInPs7ZbeUf). ## Configure a Node-locked License You have the option of adding node-locked license keys manually or uploading them in a file. ### 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. Enter or paste the license code in the **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**. The licenses appear in the *Licenses* field on separate lines for each license. Provide the licenses as specified below. 3. Click the **Upload** button in the dialog box to confirm the operation. The licenses appear in the *Licenses List* and display **No** in the **In Use **column. Please note the following for uploading node-locked license keys: - Each license must use a separate line in the `.txt` file. - 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**. # Step 3: Add Templates You have the option of applying templates when activating a Belden Horizon Data Operations instance. Learn more about [Templates](docId\:wmhk0kr5zdL5wO49y3i9_). If the Belden Horizon Data Operations instance doesn't need a template, proceed to the next step. ::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**: 1. From the *Template *section, click the **Add** icon. The *Template Select *dialog 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 device. To use template variables, you'll need to [Parameterize a Template](docId\:bgaO4d0C_nYrOhbrwgGFI) first. If the Belden Horizon Data Operations device doesn't need any template variables, proceed to the next step. ## 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:** - From the *Template Variables*** **section, click the **Add **icon. The *Add new variable set* dialog box appears. ### Adding Template Variables for All Devices ::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"} It is possible to add a template variable set applied to all devices. **To add a template variable set applied to all devices:** 1. From the *Add new variable set*** **dialog box, click the **Variable set type toggle** so it displays *All Devices*. 2. Click **Add**. The Variable set: *All devices *appears in the* Template Variables* list. 3. Click the **Add** icon next to the variable set. The Variables line items drop down. 4. In the **Variable Name **field, enter a variable name. 5. In the **Variable Value **field, enter a variable value. ### 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"} **To add a new template variable for an individual edge device:** 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](docId\:O1lTYJDEMBswQYIrHlhlF)' *Host Information*. 3. Click **Add**. The Variable set: *per Edge Device*: \ appears in the *Template Variables* list. 4. Click the **Add** icon next to the variable set. The *Variables *line items drop down. 5. In the **Variable Name **field, enter a variable name. 6. In the **Variable Value **field, enter a variable value. ## 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 **icon. The *Upload variable sets* dialog box appears. 2. (Optional) Click the here link to download a sample `.csv` file. 3. Click** Select File**, navigate to a variable set `.csv` file, and then click **Open**. 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: Configure Provision Options :::hint{type="info"} **Note**: The* Provision Options* feature is available for Belden Horizon Data Manager 2.12.0 and later. ::: To apply the [default password policy](docId\:yjGr6ZvudIsEERy8n7ijJ) during activation, select the *Password Policy* checkbox. If there are multiple password policies, the master default password policy that can't be deleted is implemented. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/3D3wsm5y7PhRA1XK-lfR6_image.png" size="80" width="1071" height="102" position="center" caption="Provision Options section" showCaption="true"} After activation, you can update the [default password policy](docId\:DZY-sNUcsho1JfZdq_wbT) for individual edge devices. # Step 6: Configure Advanced Settings :::hint{type="info"} **Note**: The* Advanced Settings* feature is available for Belden Horizon Data Manager 2.12.0 and later. ::: When Belden Horizon Data Manger (BHDM) connects to a Belden Horizon Data Operations (BHDO), it uses Remote Access. Remote Access has a parameter `PersistentKeepalive` that you can reconfigure on how often to send an authenticated empty packet to a Belden Horizon Data Operations for the purpose of maintaining the BHDM-BHDO connection. By default, Remote Access uses 22 seconds. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/1yANrjF0Uh79RC7jZ1AuZ_image.png" size="80" width="1905" height="189" position="center" caption="Advanced Settings section" showCaption="true"} To set advanced settings, from the **Remote Network Persistent Keepalive** field, enter a number of seconds between 1-25. # Step 7: Save When done configuring the Activation Configuration, click** Save**. Once saved, the activation code will then be generated at the *Activation Code* field. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/0hutY6rRef8lIwix4GS5W_image.png "Save Activation Configuration") **To complete an activation configuration creation:** - Click** Save**. Once saved, the activation code will then be generated at the* Activation Code *field. # Step 8: Retrieve Activation Code/URL After saving, the activation code will display underneath the *Activation Code* section. This code and the *Activation URL* will be needed when activating a BHDO instance. ::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** : 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 *and *Activation URL* to [Activate an Edge Device](docId\:dbGZkKNgGCs_BSV4I7HFQ).