Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Excerpt

Abiquo uses Google Maps for the map display, which requires the server to have Internet access. The map view is optional and statistics can be shown instead. In new installations, the map view is the default for Infrastructure view. In upgraded installations, to enable the map view, set the appropriate property in the client-config-custom.json file.

To plot the datacenter locations on the map, Abiquo uses the Google Maps Javascript API v3, and you cannot use a key for an older version.

Add the Google maps API key to the client-config-custom.json file as described below.

Obtaining a Google Maps API Key

You should add a browser key for accessing the Google Maps Javascript API v3. To  To obtain the key, follow the instructions at:

https://cloud.google.com/maps-platform/user-guide/account-changes/

You will need to obtain a browser key that can use the Google Maps Javascript API

To add the API key you copied above to the Abiquo Server do these steps:

  1. Log in to the Abiquo Server as root
  2. Change to the UI directory

    Code Block
    cd /var/www/html/ui/config


  3. Back up the client-config-custom.json file, for example

    Code Block
    cp client-config-custom.json ~/client-config-custom.json.backup


  4. If necessary, edit client-config-custom.json to enable Google Maps   

    Code Block
    "client.google.maps.enabled": true, 


  5. Add the Google Maps key. For example:

    Code Block
    "client.google.maps.key": "asdasdDryNhzxEdtfDnGQBKDAtzFqRhjeTUEh_g"

     

  6. Reload Abiquo in your browser, which will log you out. 
     
  7. Confirm the installation by using "View Source" on the Abiquo login page. You should see the API key.
  8. When you log in to Abiquo, you should see the arrow marking the location of your datacenter.

Troubleshooting

  • Improve Datacenter Location Details: If  If your datacenter is not correctly plotted, try adding more details of the location. For example, if your datacenter is located in Barcelona, Venezuela and you enter Barcelona, the map will show the location as Barcelona in Spain. In this case, you would enter "Barcelona, Venezuela" in the Datacenter location for a correct visualization.
  • Google Maps Usage Limits: You  You can use the Google Maps API v3 for free up to certain usage limits. See  https://developers.google.com/maps/documentation/javascript/usage#usage_limits