Release an OTA image to Production

Stay organized with collections Save and categorize content based on your preferences.

When you're done testing your OTA image, you're ready to release the OTA image to Production using the Production channel.

To release an OTA update to Production:

1. Go to the Release tab and configure these fields:

   1. Select the Production channel from the drop-down menu.

   2. Select the OTA image from the drop-down menu or add an OTA image by clicking addAdd OTA Image.

   3. Rollout percentage represents the percentage of devices that will receive the OTA image. For this field, specify an integer from 1 to 100. Enter a value less than 100 if you prefer to release the OTA image in batches.
      
      If you roll out the image in batches, an algorithm selects the devices randomly and does not necessarily deliver the update to the exact percentage of devices you configured in the Rollout percentage field. However, a large pool of devices, such as 1,000 or more, gives the algorithm a higher chance of meeting the configured rollout percentage.

   

2. Click Release to production.

3. A confirmation dialog appears. Click Release to confirm the Production release.

   

4. Check that the Production channel appears in the Released OTA images table.

   

   The table includes the image and channel names, the status of the rollout (either LIVE or INACTIVE), the rollout percentage that you set, and the release date and time.

Stop a release

1. In the Released OTA images table, click the more_vert 'more' menu for the target channel as shown in Figure 4.

   

2. Click Stop release.

3. The ensuing dialog window indicates that the rollout of the release to additional devices will stop immediately and that devices that have already received the release will use the updated firmware. To proceed, click Stop.

4. Confirm that the Rollout status in the main configuration screen has been updated to INACTIVE.

Continue an inactive Release

Once you have stopped a release and it has gone to the INACTIVE state, continue on the same channel in one of these ways:

• Resume the release with the initial set of devices
• Release the image to a new set of devices
• Overwrite the image on the initial set of devices

Resume the release

1. In the Released OTA images table, click the more_vert 'more' menu for the inactive channel and select Resume rollout.

2. A dialog window informs you that the rollout will apply to the initial set of devices and with your originally configured rollout percentage. Click Resume to proceed.

Release the image to a new set of devices

1. In the Configure release section of the configuration screen, select the inactive channel.

   

2. Under Rollout, select the Release to new set of devices radio button.

3. Select the image and enter the rollout percentage and proceed to release the image.

Overwrite the image on the initial set of devices

1. In Figure 5, under Rollout, select the Release to same set of devices as previous release radio button.

2. Select the image from the drop-down list and proceed to release the image. The rollout percentage remains the same as previously configured.

Increase rollout percentage

1. In the Released OTA images table, click the more_vert 'more' menu for the target channel to invoke the options shown in Figure 4.

2. Click Increase rollout percentage.

3. In the ensuing dialog, enter the rollout percentage and click Save. The number cannot be less than the current rollout percentage.

4. Confirm that the Rollout % in the Released OTA images table of the main configuration screen shows the new rollout percentage.