--- title: Step 2: Create an Activation Configuration in Litmus Edge Manager slug: edgemanager/quickstart-guide/activate-an-edge-device/step-2-create-activation-configuration description: Several parameters can be changed for the activation of Litmus Edge instances in the corresponding Litmus Edge Manager installation. docTags: createdAt: 2023-07-13T15:33:24.133Z --- Several parameters can be changed for the activation of Litmus Edge devices in the corresponding Litmus Edge Manager installation. It is important to review these options and to carefully implement the correct configuration during the activation of Litmus Edge licenses. An example of a basic activation configuration can be found in [Example: Create a Basic Activation Configuration](docId\:frC4RwI5KUpmwxzqy7k6_). Note that this example demonstrates the implementation in a fairly basic configuration, which might not meet your specific needs. # Overview An activation configuration can be configured with limits, license keys, templates 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 sub-steps and can be skipped if no additional customization is needed. Generating the details for an activation configuration occurs only in *Step 2g: Save* while retrieving the key details are in *Step 2h: Retrieve Activation Code/URL*. # Before You Begin - If you are using a node-locked license, make sure you have a license key for deployment. To get a license key, contact your Litmus account executive. - If you are using a site-based license, make sure you’ve already applied the license in Litmus Edge Manager. See [License Server Management](docId:5U_hNNsaVs--E5HQJEQ0O). # Step 2a: Navigate to Activation Configuration Follow these initial steps to access the Activation Configuration options. 1. Log in to Litmus Edge Manager. 2. Select a company. The *Projects* pane appears. 3. Click a project (the project tile) from the Project pane. The *Dashboard* pane for the project appears. 4. From the navigation panel, navigate to **Activation **> **Configuration**. The *Activation Configuration* pane appears. 5. Click the **Add (+)** icon. The *Activation Config List/ NEW* pane appears. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/VGN52zMQqHV-5mWZkJyqL_2023-07-1915-57-19.png "The button for adding a new activation configuration.") # Step 2b: Configure Limits You have the option of configuring limits. Specifically, you can configure the number of edge devices, the lease TTL and the expiration date. If no changes are needed, proceed to the next sub-step. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/4SN1XZ4nJ2jciUlGzPYQ1_image.png "Activation Configuration: Limits configuration options") - **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 activations. - **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 2c: 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 Litmus Edge instance. Use this option for assigning one license to each edge device. - A site license is where Litmus Edge retrieves a license from a Litmus Edge License Server. Use this option to set the license server IP address. See [Site and Node-Locked License Overview for Litmus Edge](docId\:nbX0O6C5ylSh-qVy0sdJc) to learn more. If no changes are needed, proceed to the next sub-step. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/KM04NTBSz0MY4wfoolG0K_image.png "License and license type configuration options") ## Configure a Site-based License Ensure the site-based license has already been applied in Litmus Edge Manager before activating the device. The site license must be created through *Offline activation* in [License Server Management](docId:5U_hNNsaVs--E5HQJEQ0O). ## 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 ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/8SJpgnPCIPBgctC5VgWFu_image.png "Adding node-locked keys manually") **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/6t7eoGQ-voKRVV3RWanHA_image.png" size="80" width="1708" height="156" position="center" caption="Uploading node-locked keys" 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**. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/BE6c3rVo1tviknD7__Aem_image.png" size="80" width="773" height="453" position="center" caption="Licenses dialog box" showCaption="true"} # Step 2d: Add Templates You have the option of applying templates when activating a Litmus Edge device. Learn more about [Templates](docId\:Me1x3I4rPT_IIgNPCY1GA). If the Litmus Edge device doesn't need a template, proceed to the next step. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/x2P_b1G24sZ07GZkOT9ht_image.png "Add Templates") **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. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/H3R0dkvHOzin-UiqrOz_D_image.png "Template Selection") # Step 2e: Add Template Variables You have the option of applying template variables when activating a Litmus Edge device. To use template variables, you'll need to [Parameterize a Template](docId\:ol2rl-sxp_6Y4ISmGzhXA) first. If the Litmus Edge device doesn't need any template variables, proceed to the next step. ## Add Template Variables Manually ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/szmwiO8X6j_Ff-FiaGsJV_image.png "Adding template variables") **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. ### Add Template Variables for All Devices ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/VjiaO_6PuhnVHdl7zZTU7_image.png" size="60" width="574" height="338" position="center" caption="Add new variable set dialog box : All devices" 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 that it displays *All Devices*. 2. Click **Add.** The variable set: *All devices* appears in the *Template Variables* list. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/efcDDflykw4ww43enDPCQ_5zrudc58c-uy1k-4hw-rzimage-2.png "Litmus Edge Manager User UI : Activation > Configuration : Activation Config 4/7 Add new variables for All Devices") 3. Click the **Add** icon next to the variable set. A drop-down menu appears, where each line has a separate **Variable Name - Variable Value **pair. 4. In the **Variable Name **field, enter a variable name. 5. In the **Variable Value **field, enter a variable value. ### Add Template Variables for an Individual Edge Device ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/_P1qfcHi3mCThhyYYxppJ_image.png" size="50" width="579" height="342" position="center" caption="Adding template variables for an individual Edge Device" 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 the host name for an edge device, see *Host Information *in [Configure the Network Settings](docId\:jW2n7vOhntfAgknzoyLQc). 3. Click **Add.** The Variable set: *per Edge Device:* \ appears in the *Template Variables *list. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/cTuOFMlIiEXMjPwhAqKwh_e0wobrnpssfg5w0ajzflimage.png "Add new variables for per Edge Device") 4. Click the **Add** icon next to the variable set. A drop-down menu appears, where each line has a separate **Variable Name - Variable Value **pair. 5. In the **Variable Name **field, enter a variable name. 6. In the **Variable Value **field, enter a variable value. ## Add Template Variables Using .csv File Multiple template variables can be uploaded using a `.csv` file. A sample `.csv` file is available to download from the user interface for customization. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/a43ztvQoMFpG2juZOYL2Z_image.png" size="80" width="1919" height="154" position="center" caption="Upload Template Variables" 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 indicated link (titled 'here') to download a sample `.csv` file. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/BkM0sUd2GW3u3597IDNoM_rnvvtynt8mlttxxczigti2023-07-1409-42-42.png" size="50" width="292" height="316" position="center" caption="The relevant dialog box." showCaption="true"} 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 2f: Configure Provision Options :::hint{type="info"} **Note**: The* Provision Options* feature is available for Litmus Edge Manager 2.12.0 and later. ::: To apply the [default password policy](docId\:nZxdm63Ip1guJ_mQiN140) 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\:CMHGjEOLZn_qu_jlOjdBO) for individual edge devices. # Step 2g: Configure Advanced Settings :::hint{type="info"} **Note**: The *Advanced Settings* feature is available for Litmus Edge Manager 2.11.0 and later. ::: When Litmus Edge Manger (LEM) connects to a Litmus Edge (LE) instance, it uses Remote Access. Remote Access has a parameter `PersistentKeepalive` that you can use to configure how often to send an authenticated empty packet to a Litmus Edge instance for the purpose of maintaining the LEM-LE 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: Remote Network PersistentKeepalive Interval" showCaption="true"} To set advanced settings, from the **Remote Network Persistent Keepalive** field, enter a number of seconds between 1-25 (both inclusive). # Step 2h: 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/CarewECxIvtf3_TNnHHMA_j8ohulh4be53wsfolialrimage.png "Save button") # Step 2i: 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 Litmus Edge instance. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/UQf6LsCUz40rhv_P-50-a_j8ohulh4be53wsfolialrimage.png "Retrieve activation code/URL") **To retrieve the activation code/URL**: 1. **Copy to clipboard** the *Activation Code*. It will be needed for activating a Litmus Edge instance. Then, save (paste) the *Activation Code *in a secure location. 2. **Copy to clipboard** the *Activation URL*. It will be needed for configuring a Litmus Edge instance. Then, save (paste) the *Activation URL *in a secure location. # Next Step Use the copied *Activation Code* and *Activation URL* to [Create an Activation Request in Litmus Edge](docId:0AxUENzrqbUXfriiPUYlh).