Release an OTA image to Production

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

Configure source

To release an OTA update to Production:

  1. Select the Release tab.

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

  3. Select either Developer Console or Distributed Compliance Ledger (DCL) as the source for the OTA image:

    Choosing the production release image source.
    Figure 1: Choosing the production release image source

Release an OTA image using the Developer Console

Select an image from OTA Image and add it by clicking Add OTA Image.

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.

Configuring the production release.
Figure 1: Configuring the production release

Release an OTA image using the DCL

Selecting Distributed Compliance Ledger (DCL) uses the DCL as the source for the OTA image for production release.

  1. Click Release to Production.

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

    Confirming the production release.
    Figure 2: Confirm the production release

Check that the Production channel appears in the Live Releases table.

Release to production configuration.
Figure 3: OTA image released to production channel

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. Releases originating from the DCL will be displayed if present, however, they are read-only and not editable.

Stop a release

Stop a Developer Console release

  1. In the Developer Console releases table, click the 'more' menu for the target channel as shown in Figure 4.

    Stop the active release.
    Figure 4: Stop active release
  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.

Stop a DCL Release

Switching the OTA image source from DCL back to the Developer Console will stop any ongoing DCL releases.

Switching the production release image source.
Figure 1: Switching the production release image source

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 Developer Console releases table, click the '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.

    Resuming the inactive release to a new set of devices.
    Figure 5: Rollout radio button options
  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 Developer Console releases table, click the '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 Developer Console releases table of the main configuration screen shows the new rollout percentage.