UBA - How to update MaxMind database

Available Languages

Updated:September 30, 2026
Document ID:SPLK050491

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Applicability

UBA 5.x

Description

The MaxMind app database is included during every UBA new release. However this MaxMind database could become outdated and return incorrect results for device geolocation. You can update the MaxMind database manually without having to wait for a new UBA release by updating a file in the local configuration folder and update this file periodically to keep a recent version.
 

Resolution

Perform the following steps to download the latest version of the database and run that version in UBA:

1. Go to https://dev.maxmind.com/geoip/geoip2/geolite2/#Databases

2. Download GeoLite2-City.mmdb.gz and unzip and copy GeoLite2-City.mmdb to the Management Node (node1) as follows:

/etc/caspida/local/conf/etl/geo-db/maxmind

3. Sync cluster:

/opt/caspida/bin/Caspida sync-cluster /etc/caspida/local/conf/etl/geo-db/

4. Restart caspida:

/opt/caspida/bin/Caspida stop-all
/opt/caspida/bin/Caspida start-all

IMPORTANT: For future UBA upgrades, the downloaded local version of the GeoLite2 Free database takes precedence over the pre-packaged version that ships with UBA. To use the pre-packaged version of the database from the upgrade, remove the downloaded local version file before the upgrade or continue updating the local file with the most recent version from MaxMind site.
To learn more about IP address geolocation settings in UBA, see Set internal IP range and associated office locations  in the Install and Upgrade UBA manual.

Revision History

Revision Publish Date Comments
1.0
30-Sep-2026
Initial Release

Was this Document Helpful?

FeedbackFeedback

Contact Cisco

Related Articles