Connecting DataBrowser to a Pivotal GemFire System

In DataBrowser, you must connect to a Locator or directly to a JMX Manager in a Pivotal GemFire distributed system to perform DataBrowser queries.

After you start DataBrowser, you connect to a GemFire distributed system to run queries. To connect to GemFire, perform the following steps.

Note: If you started DataBrowser through the gfsh prompt, gfsh automatically connects you to a JMX Manager node if one is up and running. To connect to a different JMX Manager node or Locator, select the Disconnect on the toolbar.

To connect DataBrowser (if you are not already connected to a GemFire Distributed System), click on the toolbar item labeled Connect to GemFire... or select File, Connect to GemFire... from the menu bar.

The Connect to GemFire Distributed System login screen appears:

The host and port fields refer to that of the RMI enabled JMX Manager or Locator in the GemFire distributed system to which you want to connect.

These host port combinations are saved by the DataBrowser to allow you to easily select a previous JMX Manager or Locator from the drop down lists in this dialog. You can set the number of entries in this list in the Connection Preferences dialog.

Note: RMI does not allow reserved characters in the host name, including '%', '$', and '-'. For a complete list of reserved characters consult RFC 952. If your host names contain non-compliant characters, we recommend using the IP address instead.

The Username and Password fields correspond to a username and password that is listed in the password file on the JMX Manager. The name of this password file is specified in the jmx-manager-password-file GemFire property. See Setting Up JMX Authentication for GemFire Management and Monitoring for more information. Once connected to the JMX Manager, the DataBrowser can fetch information on which GemFire regions are present in the distributed system, as well as the members on which they are located.

To perform queries, the DataBrowser must then be able to connect as a client to a GemFire cache server. You configure these security settings in the DataBrowser Preferences of the tool.