--- title: Set Up an Activation Configuration slug: edgemanager/lem-user-ui/product-features/activation/configuration/set-up-an-activation-config description: An activation configuration can be configured with limits, license keys, template and/or template variables. docTags: 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 6: Save* while retrieving the key details are in *Step 7: 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 have the URL and port for the license server. See [License Server Management](docId:5U_hNNsaVs--E5HQJEQ0O). # 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. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/4SN1XZ4nJ2jciUlGzPYQ1_image.png" size="80" width="1916" height="335" position="center" caption="Config Limits" showCaption="true"} - **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 Litmus Edge instance. Use this option for assigning one license to each edge device. - A site license is when Litmus Edge obtains a license from a Litmus Edge License Server. Use this option to specify the IP address of the license server. 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. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/KM04NTBSz0MY4wfoolG0K_image.png" size="80" width="1711" height="126" position="center" caption="Configure License and License Type" showCaption="true"} ## 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 SKUs manually or uploading them in a file. ### Add License SKU Manually ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/4QQIlZA580qixxWNIq5mj_image.png" size="80" width="1675" height="382" position="center" caption="Adding node-locked keys manually" showCaption="true"} **To manually add a node-locked license key**: 1. Select the checkbox for **License SKU**. Only one core license SKU can be selected. ### Upload License Keys ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/FFyjHlpWyKV8IEDDTRGs7_image.png" size="80" width="1667" height="384" position="center" caption="Uploading node-locked keys" showCaption="true"} **To upload node-locked license CSV**: 1. Click the **Upload** icon. The *Upload license keys *dialog box appears. 2. Click the **SELECT FILE** button and navigate to select the file from your local computer. - **File Name: **(Optional) Rename the file if needed. - Example of the *CSV file* is available [here](https://dev.em.la2.space/scripts/components/license/license-upload-example.csv). 3. Click **UPLOAD**. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/W7Ly27N07R8vQv6uS5ObW_image.png" size="30" width="293" height="322" position="center" caption="Upload license keys dialog box" showCaption="true"} # Step 3: Add Templates You have the option of applying templates when activating a Litmus Edge instance. Learn more about [Templates](docId\:Me1x3I4rPT_IIgNPCY1GA). If the Litmus Edge instance doesn't need a template, proceed to the next step. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/x2P_b1G24sZ07GZkOT9ht_image.png" size="80" width="1912" height="158" position="center" caption="Add Templates" 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/H3R0dkvHOzin-UiqrOz_D_image.png" size="80" width="1525" height="462" caption="Litmus Edge Manager User UI : Activation > Configuration : Activation Config 3/7 Template Select" position="center" showCaption="true"} # Step 4: Add Template Variables You have the option of applying template variables when activating a Litmus Edge instance. Before using template variables, you need to [Parameterize a Template](docId\:ol2rl-sxp_6Y4ISmGzhXA). If the Litmus Edge instance 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/szmwiO8X6j_Ff-FiaGsJV_image.png" size="80" width="1911" height="162" position="center" caption="Add Template Variables" 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/VjiaO_6PuhnVHdl7zZTU7_image.png" size="60" width="574" height="338" position="center" caption="Add new variable set dialog box" showCaption="true"} **In order to add template variables for 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. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/j2iDs6WteGq_3HZCm3cPL_5zrudc58c-uy1k-4hw-rzimage.png "Add new variables for All Devices") 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/_P1qfcHi3mCThhyYYxppJ_image.png" size="60" width="579" height="342" position="center" caption="Add new variable set dialog box" 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](docId\:jW2n7vOhntfAgknzoyLQc)' *Host Information*. 3. Click **Add**. The Variable set: *per Edge Device*: \ appears in the *Template Variables* list. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/p-HZNKyCC8P0pKcMVOG_G_e0wobrnpssfg5w0ajzflimage.png "Add new variables for per Edge Device") 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/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 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: Provision Options :::hint{type="info"} **Note**: The* Provision Options* feature is available for Litmus Edge Manager 2.12.0 and later. ::: To apply the [AWS Sitewise Edge integration](https://app.archbee.com/docs/SuELLqhxHnnKWA4eA6SOc/kVu1bRiEO0GO-psXWR-aw) during activation, select the *AWS SiteWise Edge Integration *checkbox. This feature enables Litmus Edge to connect with the AWS Sitewise Edge MQTT broker when deploying LE components using the AWS Sitewise console. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/cRpst8qB7ANzfTLd-Gz6Y_image.png) 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 6: 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), 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 Litmus Edge 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="Remote Network Persistent Keepalive Interval" 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. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/J8oHULh4be53wsFOlialR_image.png" size="80" width="1920" height="969" position="center" caption="Save Activation Config" showCaption="true"} # 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 Litmus Edge instance. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/YQY0EFKlqVaY8QDNkLCQr_image.png" size="80" width="1920" height="969" position="center" caption="Retrieve activation code/URL" showCaption="true"} **To retrieve the activation code/URL**: 1. **Copy to clipboard** the *Activation Code*. It will be needed for activating a Litmus Edge instance. 2. **Copy to clipboard** the *Activation URL*. It will be needed for configuring a Litmus Edge instance. # Next Steps Use the copied *Activation Code *and *Activation URL* to [Activate an Edge Device](docId\:G1kWiYDlSR5u8qEJk0djp).