Onboarding IR devices
Use Edge Device Manager (EDM) to add network devices to IoT OD. Enter the device serial number and select the device group that is associated with the correct configuration template. You can then make any device-specific settings and add the device. The following example describes how to create a device group and apply an eCVD (Cisco Validated Design) template to an IR 1101 device. Figure 7-13 illustrates the IR device onboarding process.
Figure 7-13 IR device onboarding process
Step 1. Set up a new organization in Cisco IoT OD, or log in to an existing admin account.
Step 2. Select the Edge Device Manager service in the left banner.
Step 3. Pre-stage your network configuration by creating a device group and configuration template.
Device groups allow you to apply the same configuration template to groups of similar network devices. Any network device you add to the group will receive the group template. Any changes to that template will apply to all devices in the group.
a. Click Configuration.
b. In the Groups tab, click Add Group.
c. Enter the group settings:
• Group Name: Enter a meaningful name.
• Select Device Type: Select the device model, such as the IR1101 series. Each device type has a different set of features that can be configured.
d. Select a new base template. Select the eCVD-IR1101-Basic template.
Note
This configuration can be used as-is or customized later.
e. Group Description (Optional). Describe the devices and configuration.
f. Verify the settings and click Create. Your new group appears in the list.
Step 4. Configure the group’s WAN uplink settings.
This is only required if your deployment uses a private or custom Access Point Name that is not automatically recognized by the modem. There may be cases where a public APN is not in the modem’s default list and would need to be added as part of the steps described next. If the APN name is required, you must also use Ethernet for the initial onboarding. After you add the device to IoT OD, Ethernet can be disconnected.
a. Click the group name and then select Edit Group.
b. Click the Configuration tab and select Form View (no Form View for IG 20 devices).
c. Click WAN, enter the following settings, and click Save:
• Ethernet: Select Enabled.
• Ethernet port WAN priority: Select First.
• Cellular 1: Enabled.
• Primary Cellular Access Point Name: Enter the private/custom APN name.
• First Cellular interface WAN priority: Select Second.
Step 5. Add a device to IoT OD and map it to an existing pre-staged device group.
a. From the left pane, click Inventory.
b. Click Add Devices.
c. Select Manual Add and complete the following fields in the Add Device page:
• Product ID (PID): Select the product ID (model number) from the drop-down list.
• Serial Number: Enter a serial number.
• Name: (Optional) Enter a device name.
• Latitude / Longitude: (Optional) Enter the location of the device to display it on the dashboard map.
d. Select the device group you just created. The configuration template for that group will be applied to the network device.
e. Click Next.
f. In the Configuration window, complete the settings and variables included in the template. The following settings are required to create a remote session with the subtended device.
WAN: Enable the following for your WAN back-haul settings:
• Cellular: Click Enabled. If you’re using a public APN, leave the Primary Cellular Access Point Name blank (the name is automatically entered). For custom or private APNs, the APN name configured for the device group should appear.
• Ethernet: This should be Enabled for private or custom APNs, or if your device uses a wired network connection. For private or custom APNs, Ethernet is used to onboard the device. After the device is added, Ethernet can be disconnected and the private/custom cellular network will be used instead.
g. Click Next after all settings are complete.
h. Correct any errors before proceeding, if necessary.
i. In the Review window, check that your settings are correct and click Save.
Step 6. Connect the device to power and add it to your network.
When the device is powered on and connected to the network using either Ethernet or cellular, it will connect to IoT OD and be configured for use with IoT OD. The selected template configuration will also be applied. The device will go through the following states: Unheard > Configuring > Up (Green). This can take 5–7 minutes.