Agents Administration - Thresholds
 

Zone Map

This page appears when the Add geographic location or the Change/Remove geographic location link in the CONFIGURE ZONE page is clicked, and provides a map interface to indicate the exact location of the zone being configured.

Note:

If you are using an SSL-enabled eG manager and are using Internet Explorer 8.0 to browse the eG user interface, then any attempt to access zone maps will be followed by a Security Warning message box. Click on the Yes button in the message box to view this page.

Typically, zones can be used to represent the status of the IT infrastructure in a specific geographic location. eG Enterprise allows you to drill down to visually figure out the exact geographic area where a zone operates, and instantly evaluate the performance of the different zones spread across the different locations worldwide. To perform such an analysis, you first need to indicate the geographic location of the configured zones using this built-in map interface.

For instance, assume that you are currently configuring a zone named east_coast that typically consists of the segments/services/components that are operating in the East Coast of the United States of America. Follow the steps below to mark the location of the zone using this page:

  • This page provides a few arrow buttons using which you can scroll right, left, up, or down; similarly, you can zoom in and out of the map with the help of the +' and '-' buttons available therein. Now, to mark the geographic location of the east_coast zone in our example, let us first zoom into the North American continent in the world map. For that, move a little to the left of the map by clicking on the left arrow button. Then, to zoom into the country of USA in North America and view all its states as well, keep clicking on the '+' button, until USA and its states are visible in the map.
  • Next, place your mouse pointer on any state in the east coast of USA, say New York, and then click on that state.
  • Upon clicking, the symbol indicated will then appear in the marked location. To save the marking, click on the Update button. To delete it, click on the Remove button. To simply close the map interface, just click on the X button at the right, top corner.
  • The geographic map display for zones is achieved through an integration of the eG Enterprise management console with the Google maps service. If this integration is not enabled, then an error message appears upon clicking on the Add geographic location link in the CONFIGURE ZONE page. To enable the integration, follow the steps given below:

    • First, you need to sign up to acquire a Google Maps API key. For that, first, go to the URL: http://code.google.com/apis/maps/signup.html.
    • Read the terms of usage in the page that appears, and then scroll down until you come to the bottom of the page.
    • Accept the terms by selecting the I have read and agree with the terms and conditions check box.
    • Then, in the My web site URL text box, specify the IP address or domain within which the integration, once enabled, will need to work. If you want both the administrative and monitor interfaces of eG Enterprise to integrate with the Google Map API, provide the URL to connect to the eG manager in the My web site URL text box. For example, if the eG manager executes on 192.168.10.12:7077, then, your URL specification in the above case will be: http://192.168.10.12:7077/. On the other hand, if you want Google maps to be available only to the admin console, then your specification would be: http://192.168.10.12:7077/final/admin. Similarly, if you want the Google maps to be available only while monitoring the target infrastructure, then the URL would be: http://192.168.10.12:7077/final/monitor.
    • Finally, to generate the API key, click on the Generate API Key button in the page. You will then be requested to sign in using the credentials of your Google account.
    • Note:

      A Google acccount is a key pre-requisite for signing up for a Google Map API key.

    • Upon successfully signing in, a page appears displaying the Google Map API key. Make a note of the key, and then close the browser.
    • Next, edit the eg_ui.ini file in the {EG_INSTALL_DIR}\manager\config directory on the eG manager host.
    • Copy the API key that you noted down previously to the Google_map_key parameter in the [ZONE_MAP] section of the file. By default, this parameter is set to 'none', indicating that eG integration with Google maps is not enabled by default.
    • Finally, save the file.

    Note:

    By default, once the eG integration with the Google map API is enabled, the zone map interface will become available to all users of eG Enterprise. If you want to hide the map interface, then you can follow the steps given below:

    • Edit the eg_ui.ini file in the {EG_INSTALL_DIR}\manager\config directory.
    • By default, the mapEnabled parameter in the [ZONE_MAP] section of the eg_ui.ini file is set to yes. To disable/hide maps, set this flag to no; doing so ensures that the Add geographic location link no longer appears in the CONFIGURE ZONE page.
    • Finally, save the eg_ui.ini file.