Adding and Deleting Products

Page last updated:

This topic describes adding and deleting additional products from your Pivotal Platform installation, such as Pivotal RabbitMQ® for Pivotal Platform.

Note: In Pivotal Operations Manager v2.7, 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. For more information, see Floating Stemcells.

Adding and Importing Products

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

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

  3. Click Import a Product.

  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 your product list. If the product that you selected is not the latest version, the most up-to-date version will appear on your product list.

    Screenshot of the Import a Product dialog

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

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

    Screenshot of the Installation Dashboard

  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 Errands.

    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.

    Screenshot of the Errands pane

    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.
  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. Screenshot of the External API Access tab
  9. Click Save.

Update Existing Products

After you save the Pivotal Network API Token to the Ops Manager Installation Dashboard, the latest versions of your existing products appear in your Installation Dashboard.

To upgrade your product to the latest version, do the following:

  1. Locate and download the product version you want to upgrade to by clicking on the green download icon.
  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: 1. Click the trash icon on a product tile to remove that product. 1. 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.