This topic describes how you can add and delete additional products, such as VMware RabbitMQ for Tanzu Application Service, from VMware Tanzu Operations Manager.

In Tanzu Operations 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 might 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 Tanzu Operations Manager installation:

  1. Download products from VMware Tanzu Network. If you cannot download products from VMware Tanzu Network due to restricted network connectivity, see Installing Tanzu Operations Manager in Air-Gapped Environments.

  2. Go to the Tanzu Operations Manager Installation Dashboard and log in.

  3. Click Import a Product.

  4. Select the .pivotal file that you downloaded from VMware Tanzu Network or received from your software distributor, and 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 Tanzu Operations Manager Installation Dashboard by clicking the green + icon in the bottom-right corner of the product listing.

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

    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 Tanzu Operations Manager makes the product available for use. For more information about post-install errands, see Using BOSH errands with your tile in the Tanzu Operations Manager Tile Developer Guide.

    By default, Tanzu Operations 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, select the Off option from the drop-down menu for the errand in the Errands pane of the Settings tab in the product tile before installing the product.

    Errands pane

    The Broker Registrar drop-down menu is an example of an errand available for a product. When you select the On option, 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 Save.

  9. Click Review Pending Changes.

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

Using the VMware Tanzu Network API to upgrade products

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

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

Connect the Tanzu Operations Manager Installation Dashboard with VMware Tanzu Network

To connect the Tanzu Operations Manager Installation Dashboard with VMware Tanzu Network:

  1. Log in to VMware Tanzu Network.

  2. Click your username.

  3. From the drop-down menu, click Edit Profile.

  4. Copy the Legacy API Token.

  5. Go to the Tanzu Operations Manager Installation Dashboard and log in.

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

  7. From the drop-down menu, click Settings, then External API Access.

  8. In the Set API token text box, paste the Legacy API Token you copied from VMware Tanzu Network.

  9. Click Save.

Update existing products

After you save the VMware Tanzu Network API token to the Tanzu Operations Manager Installation Dashboard, the latest versions of your existing products appear in the Tanzu Operations Manager Installation Dashboard.

To upgrade an existing product to the latest version:

  1. In the product list of the Tanzu Operations Manager Installation Dashboard, locate the product you want to upgrade.

  2. 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 BOSH Director

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

For more information, see Reviewing Pending Product Changes.

Delete products

To delete a product from your Tanzu Operations Manager installation:

From the Installation Dashboard:

  1. Click the trash icon on a product tile to remove that product.
  2. In the Delete Product pane that appears, click Confirm.

    You cannot delete the BOSH Director product.

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

check-circle-line exclamation-circle-line close-line
Scroll to top icon