Adding and Deleting Products

Page last updated:

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

Note: In Ops Manager, 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.

Add and Import Products

To add or import a product to your Pivotal Platform installation:

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

  2. Navigate to the 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 the product list beneath the Import a Product button. If the product that you selected is not the latest version, the most up-to-date version appears in your product list.

  5. Add the product tile to the Ops Manager Installation Dashboard by clicking the green + icon in the bottom-right corner of the product listing.

  6. The product tile appears in the Ops Manager Installation Dashboard. If the product requires configuration, the bar at the bottom of the tile appears orange. If necessary, configure the product.

    Screenshot of the Installation Dashboard.
The page has two sections: 'VMware BOSH Director for vSphere' and 'Redis for Pivotal CF'.

  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 in the Pivotal Platform Tile Developer Guide.

    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, disable the checkbox for the errand in the Errands pane of the Settings tab in the product tile before installing the product.

    Screenshot of the Errands pane of the Settings
tab in the Installation Dashboard. The page is titled 'Redis for Pivotal CF'.

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

  8. Click Review Pending Changes.

  9. Click Apply Changes to start installation and run post-install lifecycle errands for the product.

Using the Pivotal Network API to Upgrade Products

Instead of manually downloading each new version of the products in your Pivotal Platform installation, you can upgrade your products by connecting your Ops Manager Installation Dashboard with Pivotal Network using a API token. Once you have uploaded a product, all subsequent product upgrades appear automatically in the Ops Manager Installation Dashboard.

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

Connect the Ops Manager Installation Dashboard with Pivotal Network

To connect the Ops Manager Installation Dashboard with Pivotal Network:

  1. Log in to Pivotal Network.

  2. Click your username, located in the upper top right side of the page.

  3. From the dropdown, click Edit Profile.

  4. Copy the Legacy API Token.

  5. Navigate to the Ops Manager Installation Dashboard and log in.

  6. Click your username, located in the upper top right side of the page.

  7. From the dropdown, click Settings.

  8. Select External API Access.

  9. In the Set API token field, paste the Legacy API Token you copied from Pivotal Network.

  10. 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 the Ops Manager Installation Dashboard.

To upgrade an existing product to the latest version:

  1. In the product list located on the left side of the Ops Manager Installation Dashboard, locate the product you want to upgrade.

  2. In the bottom-right corner of the product listing, click the green download icon.

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

  4. If necessary, configure the product.

  5. Click Review Pending Changes.

  6. Click Apply Changes.

Apply Changes to the BOSH Director

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

For more information, see Reviewing Pending Product Changes.

Delete Products

To delete a product from your Pivotal Platform installation:

  1. Navigate to the Ops Manager Installation Dashboard.

  2. Click the trashcan icon in the bottom-right corner on a product tile.

  3. In the Delete Product dialog box that appears, click Confirm.

    Note: You cannot delete the BOSH Director tile.

  4. Click Review Pending Changes.

  5. Click Apply Changes.

After you delete a product, the product tile is removed from your Pivotal Platform installation and the Ops Manager Installation Dashboard. However, if you configured your Pivotal Platform installation to use the Pivotal Network API, the product still appears in the list of available product upgrades in the Ops Manager Installation Dashboard.