Adding and Deleting Products

Page last updated:

Warning: Pivotal Cloud Foundry (PCF) v2.3 is no longer supported because it has reached the End of General Support (EOGS) phase as defined by the Support Lifecycle Policy. To stay up to date with the latest software and security updates, upgrade to a supported version.

Page last updated:

Refer to this topic for help adding and deleting additional products from your Pivotal Cloud Foundry (PCF) installation, such as Pivotal RabbitMQ® for PCF.

Note: In Ops Manager 2.3, all product tiles use floating stemcells by default. This increases the security of your deployment by enabling tiles to automatically use the latest patched version of a stemcell, but it may significantly increase the amount of time required by a tile upgrade. Review the Floating Stemcells topic for more information.

Adding and Importing Products

  1. Download PCF-compatible products at Pivotal Network. If you cannot download products from Pivotal Network due to restricted network connectivity, see Installing PCF in Airgapped Environments.

  2. Navigate to your Ops Manager Installation Dashboard and log in.

  3. Click Import a Product.

    Import prod

  4. Select the .pivotal file that you downloaded from Pivotal Network or received from your software distributor, then click Open. If the product is successfully added, it appears in the your product list. If the product you selected is not the latest version, the most up-to-date version will appear on your product list.

    Successfully added

  5. Add the product tile to the Installation Dashboard by clicking the green plus sign icon.

    Plus sign

  6. The product tile appears in the Installation Dashboard. If the product requires configuration, the tile appears orange. If necessary, configure the product.

    New orange tile

  7. (Optional) In the product configuration view, select the Errands pane to configure post-install errands or review the default settings. Post-install errands are scripts that automatically run after a product installs, before Ops Manager makes the product available for use. For more information about post-install errands, see the Errands topic.

    Note: By default, Ops Manager reruns errands even if they are not necessary due to settings left from a previous install. Leaving errands checked at all times can cause updates and other processes to take longer. To prevent an errand from running, deselect the checkbox for the errand in the Settings tab on the product tile before installing the product.

    Example errand

    The Broker Registrar checkbox is an example of an errand available for a product. When you select this checkbox, this errand registers service brokers with the Cloud Controller and also updates any broker URL and credential values that have changed since the previous registration.

  8. Click Review Pending Changes, then Apply Changes to start installation and run post-install lifecycle errands for the product.

Using Pivotal Network API to Upgrade Products

Ops Manager provides a way to upgrade products by connecting your Installation Dashboard with Pivotal Network using a API token. Once you have uploaded a product, all subsequent product upgrades appear automatically in your Installation Dashboard.

Note: Using the Pivotal Network API is only available if you have access to the Internet since communication between Ops Manager and the Pivotal Network is necessary to import your products. If you are on an isolated network, do not save your API token.

  1. Navigate to Pivotal Network and log in.
  2. Click your user name, located in the upper top right side of the page.
  3. Select Edit Profile.
  4. In the Edit Profile tab, copy your API Token. Edit profile
  5. Navigate to your Ops Manager Installation Dashboard and log in.
  6. Click your user name, located in the upper top right side of the page.
  7. Select Settings.
  8. In the External API Access tab, paste your API Token. External api
  9. Click Save.

Update Existing Products

Once you save the Pivotal Network API Token to the Ops Manager Installation Dashboard, the latest versions of your existing products will appear in your Installation Dashboard. Upgrade your product to the latest version by following these instructions.

  1. Locate and download the product version you want to upgrade to by clicking on the green download icon. Existing upgrade

  2. When the download is complete, refresh the page to use the product.

  3. If necessary, configure the product.

  4. Click Review Pending Changes, then Apply Changes.

Applying Changes to BOSH Director

You can use the Ops Manager API or the Review Pending Changes page to apply pending changes only to BOSH Director when you stage multiple products in a new installation or as part of an upgrade.

Deleting a Product

  1. From the Installation Dashboard, click the trash icon on a product tile to remove that product. In the Delete Product dialog box that appears, click Confirm.

    Note: You cannot delete the BOSH Director product.
  2. Click Review Pending Changes, then Apply Changes.

    After you delete a product, the product tile is removed from the installation and the Installation Dashboard. However, the product appears in the Available Products view.