QuickStart Guide
Activate an Edge Device
Step 2: Create an Activation Configuration in Litmus Edge Manager
24min
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 log in to litmus edge manager select a company the projects pane appears click a project (the project tile) from the project pane the dashboard pane for the project appears from the navigation panel, navigate to activation > configuration the activation configuration pane appears click the add (+) icon the activation config list/ new pane appears 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 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 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 to manually add a node locked license key click the add icon the license code field drops down enter or paste the license code in the license key field upload license keys to upload node locked license keys click the upload icon 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 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 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 to add at least one template from the template section, click the add icon the template select dialog box appears select one or more templates from the list, and then click select the selected template appears in the templates list 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 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 it is possible to add a template variable set applied to all devices to add a template variable set applied to all devices from the add new variable set dialog box, click the variable set type toggle so that it displays all devices click add the variable set all devices appears in the template variables list 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 in the variable name field, enter a variable name in the variable value field, enter a variable value add template variables for an individual edge device to add a new template variable for an individual edge device from the add new variable set dialog box , click the variable set type toggle so it displays per edge device 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 click add the variable set per edge device \<hostname> appears in the template variables list 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 in the variable name field, enter a variable name 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 to add at least one template variable using a csv file from the template variables section, click the upload icon the upload variable sets dialog box appears (optional) click the indicated link (titled 'here') to download a sample csv file click select file , navigate to a variable set csv file, and then click open the selected csv file appears in the file name field click upload the variable sets listed in the csv file appear in the variable sets list step 2f configure provision options note the provision options feature is available for litmus edge manager 2 12 0 and later to apply the edge password policies 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 after activation, you can update the policy docid\ cmhgjeolzn qu jlojdbo for individual edge devices step 2g configure advanced settings 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 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 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 to retrieve the activation code/url 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 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 step 3 create an activation request in litmus edge docid 0axuenzrqbuxfriipuylh