--- title: Set Up an Activation Configuration slug: set-up-an-activation-configuration docTags: createdAt: 2022-09-27T16:07:17.000Z --- An activation configuration can be configured with limits, license keys, templates and 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](docId\:JaNY4AoXq0a3a22W6O3MT) while retrieving the key details are in [Step 7: Retrieve Activation Code/URL](docId\:JaNY4AoXq0a3a22W6O3MT). :::hint{type="info"} **Note**: For Manufacturing Connect version 2.17.0 and later, respective activation URLs for Edge devices are automatically updated based on the new domain name. For earlier versions, activation URLs will have to be manually updated. ::: # 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 account executive. - Are using a site-based license, make sure you’ve already applied the license in Manufacturing Connect. See [License Server](docId\:L6IFlimi9MgYG4MXoEUyt). - Plan to enable a PubSub Connector in [Step 4: Configure Provision Options](docId\:JaNY4AoXq0a3a22W6O3MT), ensure that GCP credentials are already configured. See Cloud Credentials in [Cloud Settings](docId:5qmRCk-SoDaAvKPtB58KN). # Step 1: Configure Limits After navigating to **Edge Management **> **Activation Configs **and clicking the **Add (+)** 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/G2NcrKJev-hZzWs82mjje_image.png" size="80" width="1697" height="361" caption="Manufacturing Connect User UI : Activation > Configuration : Activation Config 1/7 Config Limits" position="flex-start" darkWidth="1697" darkHeight="361" 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 activation code is valid to be used for an Edge device activation. - **Expiration Date: **Select the date on when the activation code will expire. Specifically, when the Manufacturing Connect Edge instances that use this license will need a new activation code. # Step 2: Add Templates You have the option of applying templates when activating a Manufacturing Connect Edge device. Learn more about [Templates](docId\:SZWx7grBr36GqnHHhoPrD). If the Manufacturing Connect Edge device doesn't need a template, proceed to the next step. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/yF6bPzZo9nQz1saMHCHXk_image.png" size="80" width="1694" height="149" caption="Manufacturing Connect User UI : Activation Configs : Activation Config 2/7 Add Templates" position="flex-start" darkWidth="1694" darkHeight="149" 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="Manufacturing Connect User UI : Activation > Configuration : Activation Config 2/7 Template Select" position="flex-start" darkWidth="1525" darkHeight="462" showCaption="true" indent="2"} # Step 3: Add Template Variables You have the option of applying template variables when activating a Manufacturing Connect Edge device. To use template variables, you'll need to [Parameterize a Template](docId:6tBz1C52eesM9ft9s1JU0) first. If the Manufacturing Connect Edge device doesn't need any template variables, proceed to the next step. ## Add Template Variables Manually ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/fRHkwHAkuh6uxoZ2cJddS_image.png" size="80" width="1706" height="157" caption="Manufacturing Connect User UI : Activation > Configuration : Activation Config 3/7 Template Variable : Add Template Variables" position="flex-start" darkWidth="1706" darkHeight="157" 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. ### 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" caption="Manufacturing Connect User UI : Activation > Configuration : Activation Config 3/7 Add new variable set dialog box : All devices" position="flex-start" darkWidth="574" darkHeight="338" 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**. 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/_P1qfcHi3mCThhyYYxppJ_image.png" size="60" width="579" height="342" caption="Manufacturing Connect User UI : Activation > Configuration : Activation Config 3/7 Add new variable set dialog box : Per Edge Devices" position="flex-start" darkWidth="579" darkHeight="342" 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\:HC0nDx7I-slwQdyFl_qYt)' *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. ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/gOLI3tb00C3y5wOYz5YTj_image.png "Manufacturing Connect User UI : Activation Configs : Activation Config 3/7 Template Variable : Upload Template Variables") **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 4: Configure Provision Options The Manufacturing Connect Edge device can be customized to automatically integrate a PubSub Connector or connect to a Simulator device. See *Google Cloud Pub/Sub Connector* section of [Connector Provider Reference Table](docId\:rUFnTE_9NkhJYI-haP4hK) and [Generator](docId\:yRNLMXUMixr5YeVHcVJHj) for details. For Manufacturing Connect version 2.12.0 and later, you can apply the [default password policy](docId\:Tfje5cVg12WxmHuk5kM_z) 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. :::hint{type="info"} **Note:** Before you select PubSub Connector, ensure that you have configured GCP credentials in Manufacturing Connect. Navigate to **Admin Console** > **Settings** > **Cloud Settings** > **Cloud Credentials** and add valid GCP credentials (service account key, project ID, private key ID, and client email). See Cloud Credentials in [Cloud Settings](docId:5qmRCk-SoDaAvKPtB58KN). ::: ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/EIkx-pauoOkZ-9p_0-2xb_image.png" size="80" width="1089" height="262" position="flex-start" caption="Provision Options section" darkWidth="1089" darkHeight="262" showCaption="true"} After activation, you can update the [default password policy](docId\:n7wSoz720xz3cGZUR3tnQ) for individual edge devices. # Step 5: Configure Advanced Settings :::hint{type="info"} **Note**: The* Advanced Settings* feature is available for Manufacturing Connect 2.11.0 and later. ::: When Manufacturing Connect (MC) connects to a Manufacturing Connect Edge (MCe), 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 Manufacturing Connect Edge for the purpose of maintaining the MC-MCe connection. By default, Remote Access uses 22 seconds. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/HcojceRE0J0VCWnuAXrjY_image.png" size="80" width="1915" height="135" caption="Manufacturing Connect User UI : Activation > Configuration : Activation Config 5/7 Advanced Settings: Remote Network Persistent Keepalive Interval" position="flex-start" darkWidth="1915" darkHeight="135" showCaption="true"} To set advanced settings, from the **Remote Network Persistent Keepalive** field, enter a number of seconds between 1-25. # Step 6: Save Once all the configuration for an Activation Configuration is complete, a save is needed to generate the activation code. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/ApRUnseySMCUsIWG55rHu_image.png" size="80" width="1920" height="937" caption="Manufacturing Connect User UI : Activation Configs : Activation Config 6/7 Save" position="flex-start" darkWidth="1920" darkHeight="937" showCaption="true"} **To complete an activation configuration creation:** 1. Click** Save**. Once saved, the activation code will then be generated at the* Activation Code *field. # Step 7: 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 Manufacturing Connect Edge instance. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/2s_KD01ii2_omWF4FGnTf_image.png" size="80" width="1691" height="121" caption="Manufacturing Connect User UI : Activation Configs : Activation Config 7/7 Retrieve activation code/URL" position="flex-start" darkWidth="1691" darkHeight="121" showCaption="true"} **To retrieve the activation code/URL** : 1. **Copy to clipboard** the *Activation Code*. It will be needed for activating a Manufacturing Connect Edge instance. 2. **Copy to clipboard** the *Activation URL*. It will be needed for configuring a Manufacturing Connect Edge instance. # Next Steps Use the copied *Activation Code *and *Activation URL* to [Activate an Edge Device](docId\:JalA8oA1dTK8BdVoENAwA).