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.
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.
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 Pivotal Network.
- If you have configured a Pivotal 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. See the Change Log Page section of this topic for details.
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. See My Account of this topic for details on account information. See the Settings Page section of this topic for details on available Ops Manager settings.
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.
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:
|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:
|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.
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.
Navigate to the Settings page by clicking on your user name located at the upper right corner of the screen and selecting Settings.
The Settings configuration screen displays.
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.
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 the Creating UAA Clients for BOSH Director topic.
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:
- Amazon Web Services. See Configuring BOSH Director on AWS.
- Google Cloud Platform. See Configuring BOSH Director on GCP Manually.
- Microsoft Azure. See Configuring BOSH Director on Azure Manually.
- OpenStack. See Configuring BOSH Director on OpenStack.
- vSphere. See Configuring BOSH Director on vSphere.
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.
Pivotal Network Settings
Enter your Pivotal Network API token and click Add Token to connect your Installation Dashboard to Pivotal Network.
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.
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.
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:
(Optional) Select Yes to send Ops Manager system logs to a remote server.
Enter the IP address or DNS name for the remote server in Address.
Enter the port number that the remote server listens on in Port.
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.
(Optional) Select the Enable TLS checkbox to send encrypted logs to remote server with TLS. After you select the checkbox:
- Enter either the name or SHA1 fingerprint of the remote peer in Permitted Peer.
- Enter the SSL certificate for the remote server in SSL Certificate.
Note: Pivotal strongly recommends that you enable TLS encryption when you are forwarding logs. Logs can contain sensitive information, such as cloud provider credentials.
(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.
(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.
(Optional) Enter configuration details for rsyslog in the Custom rsyslog Configuration field. This field requires the rainerscript syntax.
- 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.
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.
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.