Using the Ops Manager Interface

Page last updated:

This topic describes key features of the Pivotal Operations Manager interface that is used to manage Pivotal Platform.

Installation Dashboard Page

The Installation Dashboard is the central Ops Manager interface for managing your Pivotal Platform deployment. It displays the BOSH Director configuration for your IaaS and product tiles for your Pivotal Platform deployment.

The following screenshot shows the Installation Dashboard. Each section is labeled with a red letter. Click the image to see it at full size.

Screenshot of the Ops Manager Installation Dashboard. For a description of each labeled section, see the list below

The following list describes each labeled section of the Installation Dashboard:

  • A—Import a Product: Click this button to add a new product to Ops Manager. You can download Pivotal Platform-compatible product files from VMware Tanzu Network.

    • If you have configured a VMware Tanzu Network API token in the Settings section of Ops Manager, a list of the latest versions of already imported products appears automatically.

  • B—Delete All Unused Products: Click this link to delete any unused products.

  • C—Installation Dashboard: Click this link to return to the Installation Dashboard page from other Ops Manager pages.

  • D—Stemcell Library: Click this link to open the Stemcell Library. In the Stemcell Library you can import stemcells, stage stemcells, and review your stemcell version numbers. For more information, see Importing and Managing Stemcells.

  • E—Change Log: Click this link to view and search a log of your previous installations. For more information, see Change Log Page below.

  • F—User Account Menu: Click the arrow next to your username to view the menu. Use this menu to navigate to your Settings page, view My Account to change your email and password, or log out of the Installation Dashboard. For details about account information, see My Account below. For more information about available Ops Manager settings, see Settings Page below.

  • G—Revert: Click the revert button to return to the previous successful installation. Any pending changes you have made to the current installation settings will be lost.

  • H—Review Pending Changes: Click the button to go to the Review Pending Changes page, which organizes pending changes by tile. You are able to enable or disable each tile to selectively deploy individual tiles and their dependencies. For more information, see Reviewing Pending Product Changes.

  • I—Orange Bar: Indicates that additional configuration for the product tile is required before deployment. Click the product tile to complete its configuration.

  • J—Missing Stemcell Link: If an imported product is missing a required stemcell, a Missing Stemcell link appears on the tile. Click this link to open the Stemcell Library. For more information, see Importing and Managing Stemcells.

  • K—API Docs: Click this link to go to the Ops Manager API documentation, which details how you can manage Ops Manager through the API rather than with the user interface. For more information about the Ops Manager API, see Using the Ops Manager API.

Change Log Page

Navigate to the Change Log page by clicking the corresponding link in the dashboard header. This page shows Ops Manager’s deployment history, a record of all of its Apply Changes actions.

The table lists the following top-level attributes for each deployment:

Label Type Description
STATUS Icon Whether the deployment succeeded or failed
DEPLOYMENT ID Text A sequentially-numbered identifier for the deployment
USER Username The user who initiated the deployment

A LOGS button for each deployment opens the deployment’s full Installation Log.

Within each deployment listing, a table details for the individual products deployed in or deleted from each installation.

The details listed for each product are as follows:

Label Type Description
PRODUCT Text The name of the product
ACTION One of the following labels: ADDED, UPDATED, DELETED, NO CHANGES, FAILED The action, if any, that the deployment took with the product
STARTED UTC timestamp When Ops Manager began deploying the product
FINISHED UTC timestamp When Ops Manager stopped deploying or attempting to deploy the product
DURATION Time, in minutes How long Ops Manager took to deploy or attempt to deploy the product

A Total row, below the individual product rows, lists all-product totals for the STARTED, FINISHED, AND DURATION fields.

Using the Change Log Page

Configure the Change Log page by modifying the following fields:

  • Installation Dashboard—Click Installation Dashboard to return to Ops Manager’s Installation Dashboard. Alternatively, click the Back button in your web browser.

  • Show X entries—Click the number displayed in the Show X entries dropdown to choose between 10, 25, 50, and 100 entries.

  • Search—Type in the search box to sort the Change Log page by text or integer matches. As you type, matching entries appear on the screen.

  • Previous / Next—Click Previous, Next, or the number between them to load older or newer entries.

Settings Page

Navigate to the Settings page by clicking on your user name located at the upper right corner of the screen and selecting Settings.

The 'User account menu' page is indicated by a drop down arrow next to the logged in user account. The user account displays at the upper right corner of the Ops Manager screen. As the first option of this menu, you can select 'Settings' to access the Settings Page. Below 'Settings' you can access 'My Account' to view account information or 'Log out' to log out of the existing user account.

The Settings configuration screen displays.

The 'Settings' page is indicated by a header that says 'Settings' in large type at the top of the page. Below the header, on the left-hand side, there is a tabular layout. From top to bottom, the tabs are 'Change Decryption Passphrase,' 'SAML Settings', 'LDAP Settings', 'SSL Certificate', 'Pivotal Network Settings,' 'Proxy Settings', 'Custom Banner', 'Export Installation Settings', 'Syslog', and 'Advanced Options'. The top tab, 'Change Decryption Passphrase' is highlighted in gray to indicate that it is selected. To the right, the body shows fields that correspond to 'Change Decryption Passphrase.'

The following section describes each configuration pane:

Note: Modifying these settings does not require you to return to the Installation Dashboard and click Apply Changes. These settings apply to the Ops Manager VM. The BOSH Director does not apply them to your Pivotal Platform deployment.

Change Decryption Passphrase

Use this pane to reset your decryption passphrase.

SAML Settings

To change your Identity Provider (IdP) to SAML, configure the following fields:

  • Current Decryption Passphrase: Enter your decryption passphrase.
  • SAML IDP Metadata: Enter the full URL or XML SAML IdP metadata.
  • BOSH IDP Metadata: (Optional) Enter the full URL or XML BOSH IdP metadata. If left blank, the default is the same metadata as the field above.
  • SAML Admin Group: Enter the name of the SAML group that contains all of the Ops Manager administrators. This field is case-sensitive.
  • Groups Attribute: Enter the groups attribute tag name with which you configured the SAML server. This field is case-sensitive.
  • Provision an admin client in the Bosh UAA: Enable if you want to provision an admin client in the BOSH UAA. For more information, see Provision Admin Client in Creating UAA Clients for BOSH Director.

LDAP Settings

Use this pane to change your IdP to LDAP.

For more information about changing your IdP to SAML or LDAP, view the following instructions for your IaaS configuration:

The 'Settings' page shows the 'SSL Certificate' pane highlighted on the left-hand tabular layout to indicate selection. The body shows a header titled 'SSL Certificate' with an option to 'Revert to self-signed certificate' followed by help text and two required fields: 'Certificate' and 'Private key'. The 'Add Certificate' button is at the bottom of the body.

SSL Certificate

Configure Ops Manager to use a custom SSL certificate for all Ops Manager traffic both through the UI and API.

If you leave the fields blank, Ops Manager uses an auto-generated self-signed certificate rather than your own custom certificate and private key. If you wish to replace a custom certificate with a self-signed certificate, select Revert to self-signed certificate.

The 'Settings' page shows the 'Pivotal Network Settings' pane highlighted on the left-hand tabular layout to indicate selection. The body shows a header titled 'Pivotal Network Settings' with help text beneath and one field: 'Set API Token'. A button labeled 'Add Token' is at the bottom of the body.

VMware Tanzu Network Settings

Enter your VMware Tanzu Network API token and click Add Token to connect your Installation Dashboard to VMware Tanzu Network.

Proxy Settings

If you are using a proxy to connect to Ops Manager, update your Proxy Settings by providing a HTTP proxy, HTTPS proxy, or No proxy.

Below, the Settings page shows the 'Custom Banner' pane highlighted in the tabulated menu to indicate selection. In the body, from top to bottom, you find the 'Custom Banner' header with optional text fields 'UI Bannner' and 'SSH Banner' beneath. A 'Save' button is at the bottom of the body.

Custom Banner

Create a custom text banner to communicate important messages to operators. For UI Banner, enter the text you want to be shown on each page of the Ops Manager UI. For SSH Banner, enter the text that appears when an operator shells into Operations Manager.

Export Installation Settings

Exports the current installation with all of its assets. When you export an installation, the exported file contains references to the base VM images, necessary packages, and configuration settings.

Syslog

Viewable by administrators only. Configure a custom Syslog server for Ops Manager. When you select Yes and fill the following fields, Ops Manager produces and sends all syslog entries from the Ops Manager VM to the configured syslog endpoint. Ops Manager also sends BOSH Director access events to the syslog endpoint.

Note: Ops Manager syslog entries are sent in RFC 3164 format.

To configure a custom syslog endpoint for Ops Manager logs:

  1. Select Syslog.

  2. (Optional) Select Yes to send Ops Manager system logs to a remote server.

  3. Enter the IP address or DNS name for the remote server in Address.

  4. Enter the port number that the remote server listens on in Port.

  5. Select TCP or UDP from the Transport Protocol dropdown. This selection determines which transport protocol is used to send the logs to the remote server.

  6. (Optional) Select the Enable TLS checkbox to send encrypted logs to remote server with TLS. After you select the checkbox:

    1. Enter either the name or SHA1 fingerprint of the remote peer in Permitted Peer.
    2. Enter the SSL certificate for the remote server in SSL Certificate.

      Note: VMware strongly recommends that you enable TLS encryption when you are forwarding logs. Logs can contain sensitive information, such as cloud provider credentials.

  7. (Optional) Enter an integer in Queue Size. This value specifies the number of log messages held in the buffer. The default value is 100,000.

  8. (Optional) Select the checkbox to Forward Debug Logs to an external source. This option is deselected by default. If you select it, you may generate a large amount of log data.

  9. (Optional) Enter configuration details for rsyslog in the Custom rsyslog Configuration field. This field requires the rainerscript syntax.

  10. Click Save.

Advanced Options

  • Download Activity Data: Downloads a directory containing the config file for the installation, the deployment history, and version information.
  • Download Root CA Cert: Use this to download the root CA certificate of your deployment as an alternative to curling the Ops Manager API.
  • View Diagnostic Report: Displays various types of information about the configuration of your deployment.
  • Delete This Installation: Deletes your Ops Manager installation permanently.

My Account Page

To change your email and password, navigate to the My Account page by clicking on your user name located at the upper right corner of the screen and selecting My Account.

This example 'Account Settings' page shows two subheadings titled 'Profile' and 'Third Party Access'. Under 'Profile' is an email 'admin@test.org' and an obscured password using asterisks. The email and password have two corresponding links to the right: 'Change Email' and 'Change Password'. Under 'Third Party Access' is a paragraph that says 'You have not yet authorized any third party applications.'

Support Page

Click Support in the footer of any page in Ops Manager to access the Support page.

The Support page allows you to download a ZIP file that includes Ops Manager logs, deployed manifests and configurations, and BOSH deployment diagnostics.

The contents of the ZIP file help Pivotal Support more quickly address any issues in your deployment.