docs-jmx-bridge/troubleshooting-uninstall-metrics.html.md.erb at master · AmberAlston/docs-jmx-bridge · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
---
title: Troubleshooting and Uninstalling JMX Bridge
owner: PCF Metrics
---

<strong><%= modified_date %></strong>

The JMX Bridge tool (formerly Ops Metrics) is a JMX extension for Elastic Runtime. JMX Bridge collects and exposes system data from Cloud Foundry components via a JMX endpoint.
Use this system data to monitor your installation and assist in troubleshooting.

The JMX Bridge tool is composed of three virtual machines:

- The JMX Provider
- A VM that governs compilation
- A nozzle for the [Loggregator Firehose](https://docs.pivotal.io/pivotalcf/1-7/loggregator/architecture.html)

To deploy JMX Bridge, see the [Deploying JMX Bridge](./deploy-metrics.html) topic.

## <a id='upgrade'></a>Resolve Upgrade Error for 1.4 to 1.6 ##

If you see the following error during an upgrade from Ops Metrics 1.4 to 1.6 (now JMX Bridge):

   ![Product Pivotal Ops Metrics could not be upgraded from 1.4 to 1.6. Please contact your Pivotal representative](images/ops-metrics-upgrade-error.png)

1. [Uninstall Ops Metrics 1.4](./troubleshooting-uninstall-metrics.html#uninstall)
1. [Install Ops Metrics 1.6](http://docs.pivotal.io/pivotalcf/1-6/customizing/deploy-metrics.html#import)

## <a id='upgrade'></a>Resolve Upgrade Error for 1.6 to 1.7 ##
If you see the following error during an upgrade from Ops Metrics 1.6 to JMX Bridge 1.7.x:

**This product requires a stemcell that is older than the currently installed product. Download the newest version of this product from Pivotal Network and try again.**

[Upgrade Ops Manager](https://docs.pivotal.io/pivotalcf/1-7/customizing/upgrading-pcf.html) to 1.7.8 or higher. The error above results from a known issue and newer versions of Ops Manager resolve the issue.

## <a id='uninstall'></a>Uninstall JMX Bridge (formerly Ops Metrics) ##

1. Scale the collector resource from Elastic Runtime to `0`.

    <%= image_tag("images/ops-metrics-collector-scale.png") %>

    If you do not scale the collector resource, you get the following error:

    ![Pivotal Elastic Runtime requires p-metrics version ~> 1.2 as a dependency](images/ops-metrics-delete-error.png)

1. Proceed with uninstallation. See the [Deleting a Product](https://docs.pivotal.io/pivotalcf/1-7/customizing/add-delete.html#del-prod) section of the [Adding and Deleting Products](https://docs.pivotal.io/pivotalcf/1-7/customizing/add-delete.html) topic for details.