Unable to import Xenial stemcell when upgrading to tile that requires Xenial

Products

• Operations Manager

Issue/Introduction

Symptoms:
Unable to import Xenial stemcell when upgrading to tile that requires Xenial.

Improrting stemcell into Operations Manager UI gets error.
"The currently staged and deployed products cannot use bosh-stemcell ... xenial"

Environment

Cause

There is a defect in Operations (Ops) Manager 2.1 with support for Xenial stemcell https://docs.pivotal.io/pivotalcf/2-1/pcf-release-notes/opsmanager-rn.html - see release notes known issues:
 

Error When Importing Xenial Stemcell

Ops Manager 2.1.6 and later support Xenial stemcells. However, the Ops Manager UI returns an error when you attempt to import a Xenial stemcell. 

As a workaround, you can upload the stemcell and assign it to a product using the Ops Manager API.

This defect is also present in versions 2.2.0 and 2.2.1 of Ops Manager.

Resolution

This issue is fixed in versions 2.1.15+ and 2.2.2+ of OpsManager. Please arrange to upgrade OpsManager in order to address supportability of Xenial stemcell. 

As a workaround, you can upload stemcell manually via BOSH CLI and assign stemcell to product requiring Xenial stemcell.

Upload BOSH release and get version number (reference https://bosh.io/docs/uploading-stemcells/):

bosh -e vbox upload-stemcell ~/Downloads/bosh-stemcell-97.17-vsphere-esxi-ubuntu-xenial-go_agent.tgz

bosh -e vbox stemcells 
Name                                             Version 
bosh-stemcell-vsphere-esxi-ubuntu-xenial-go_agent 97.17

Use Ops Manager API to change stemcell assignment for product such that it uses Xenial stemcell (reference https://docs.pivotal.io/pivotalcf/2-2/opsman-api/):

uaac curl -k "https://18.214.189.186/api/v0/stemcell_assignments" \                
    -X PATCH \
    -H "Content-Type: application/json" \
    -d '{
        "products": [
          {
            "guid":"example-product-d9377e712d2b2d14ebc2",
            "staged_stemcell_version": "97"
          }
        ]
      }'

Only the major version of the stemcell is required. (for example 97 for uploaded stemcell version 97.17)

Click Apply Changes in Ops Manager to deploy tile with Xenial stemcell.