Upgrading minor stemcell versions

IBM® Cloud Private Cloud Foundry: This information is applicable to IBM Cloud Private Cloud Foundry only.

You can update minor versions of existing stemcells to the latest patch by configuring the stemcell version extension in IBM Cloud Private Cloud Foundry.

For example, if the current installed stemcell is version 250.9, by configuring the extension, you can upgrade to version 250.25, as only the minor version is changed.

Configure the version of stemcells before you run the launch_deployment.sh script during installation of IBM Cloud Private Cloud Foundry (see Installing IBM Cloud Private Cloud Foundry) or at any time after installation. The configuration is done by adding the included extension cfp-ext-stemcell-version to the main IBM Cloud Private Cloud Foundry deployment. For more information, see Using extensions in IBM Cloud Private Cloud Foundry. The cfp-ext-stemcell-version extension modifies the deployment properties for the User Account and Authentication (UAA) server. A different stemcell can be configured for the Cloud Foundry director, and for the Cloud Foundry deployment.

See Stemcells Opens in a new tab for a list of official stemcells.

Configuring the extension after installation of IBM Cloud Private Cloud Foundry

If you choose to configure the extension after IBM Cloud Private Cloud Foundry is installed, you must set the appropriate states to READY after you enable the extension. If you are upgrading the version of the director stemcell, the states prepare-director and deploy-director must be set to READY. If you are upgrading the version of the Cloud Foundry deployment stemcell, the state prepare-deployment and all states following it must be set to READY.

Configuration values

override_director: Set the parameter to true to override the director stemcell from the pre-packaged stemcell. Set the parameter to false to use the pre-packaged stemcell. If set to false, you do not need to specify any additional parameters that are related to the director.

director_stemcell_version: The version of the stemcell for the director you are specifying. For example, 250.25.

director_url: If you are downloading the stemcell from the internet, this parameter is the URL to the stemcell to be used for the director. The file should have a .tgz extension.

director_filename: If you are using a local copy of a stemcell, this parameter is the file name of the stemcell to be used for the director. Place the stemcell in the DATA_DIRECTORY/extensions/embedded/cfp-ext-stemcell-version directory. The file must have a .tgz extension.

override_cf_deployment: Set the parameter to true to override the Cloud Foundry deployment stemcell from the pre-packaged stemcell. Set the parameter to false to use the pre-packaged stemcell. If set to false, you do not need to specify any additional parameters that are related to the Cloud Foundry deployment.

cf_deployment_stemcell_version: The version of the stemcell for the Cloud Foundry deployment you are specifying. For example, 250.25.

cf_deployment_url: If you are downloading the stemcell from the internet, this parameter is the URL to the stemcell to be used for the Cloud Foundry deployment. The file must have a .tgz extension.

cf_deployment_filename: If you are using a local copy of a stemcell, this parameter is the file name of the stemcell to be used for the Cloud Foundry deployment. Put the stemcell in the DATA_DIRECTORY/extensions/embedded/cfp-ext-stemcell-version directory. The file must have a .tgz extension.

Example configuration

The configuration values must be specified as child values of a uiconfig key. The following example is configured to override the stemcells for both the director and the Cloud Foundry deployment that uses stemcell version 250.25 downloaded from the internet.

uiconfig:
  override_cf_deployment: "true"
  cf_deployment_stemcell_version: 250.25
  cf_deployment_url: https://s3.amazonaws.com/bosh-core-stemcells/250.25/bosh-stemcell-250.25-vsphere-esxi-ubuntu-xenial-go_agent.tgz
  override_director: "true"
  director_stemcell_version: 250.25
  director_url: https://s3.amazonaws.com/bosh-core-stemcells/250.25/bosh-stemcell-250.25-vsphere-esxi-ubuntu-xenial-go_agent.tgz