Pivotal Knowledge Base


Upgrading Pivotal Cloud Foundry® to Version 1.4 with the Pivotal HD Tile Deployed Results in an Error


Pivotal Cloud Foundry® (PCF) Version 1.3.x with the Pivotal Hadoop Distribution (HAWQ) Version 1.3.x Tile installed


When trying to upgrade Pivotal Cloud Foundry version 1.3.x to Pivotal Cloud Foundry version 1.4.x, you get an error message "Stemcell version must be 2690.3 or greater". You have the Pivotal Hadoop Distribution (HD) Tile installed.


The root cause is that the current version of the Pivotal HD tile uses an older stemcell which is not compatible with PCF version 1.4 and above. Further details on this incompatibility can be found in this related article.


To resolve this, the Pivotal HD tile needs to be removed from the Ops Manager prior to exporting your configuration.  The following steps can walk you through this process:

  1. In Ops Manager 1.3.x, uninstall the Pivotal HD tile.  Prior to doing this, we recommend deleting any services used by your applications that are using the Pivotal HD tile.  If you do not, there will be orphaned service instances and bindings which will need to be cleaned up with the "cf purge-service-offering" command. Please see the "Impact" section below for how this will affect the data stored in the service.
  2. Export the installation, just like you would normally do.
  3. Import the installation, again just like you would normally do.

When the installation imports, it should no longer have the Pivotal HD tile and you should be able to apply changes without any errors.  

If you are still seeing this error, please see this article which describes how to check if there are other tiles that might have the same problem.

If you have applications that require Pivotal HD, the current recommendation is to run an externally managed Pivotal HD installation.  You can then set up a user provided service with the "cf cups" command and bind that to your applications.


Important: Please be aware that deleting the Pivotal HD tile from Ops Manager will result in the deletion of all services provisioned by that tile and any data associated with those services. Before you delete, make sure that you have backed up or migrated any data that you need to retain.

Additional Information

While the Pivotal HD tile for PCF has not been updated for PCF version 1.4, Pivotal does have plans to update and reintroduce the tile into a later version of PCF. Until then, we suggest using a user-provided service to connect your apps with an external Pivotal HD installation.


Powered by Zendesk