We recently released a new major version of geoipupdate
.
This document describes how you can upgrade from earlier versions.
What’s new
geoipupdate
4.x is a rewrite of the old geoipupdate
and starts from a new modern code base.
It supports the same core functionality and config file format as before.
The biggest change is support for additional platforms, notably Windows.
Notable changes
There are changes you should be aware of if you’re upgrading from older versions.
If you’re coming from geoipupdate
2.x:
- We removed support for the configuration options
Protocol
,SkipPeerVerification
, andSkipHostnameVerification
.geoipupdate
now always uses HTTPS and always verifies certificates. We ignore these options if present. - The configuration file must have the
AccountID
(or the deprecatedUserId
) when downloading a paid database. Previously, when downloading the GeoIP Legacy Country database, you were able to only provide theLicenseKey
. Now you must provide bothAccountID
andLicenseKey
.
Confirm your version
You can do this by running geoipupdate -V
:
# geoipupdate -V geoipupdate 3.1.1
If this says something like geoipupdate 4.0.0
then you’re already running 4.x.
If this says something like command not found
then you may not have geoipupdate
installed.
Please see our documentation for information about installation.
Find your config file
Typically this will be /etc/GeoIP.conf
or /usr/local/etc/GeoIP.conf
.
One way to do this is to run geoipupdate
in verbose mode:
# geoipupdate -v geoipupdate 3.1.1 Opened License file /etc/GeoIP.conf ...
In this case the config file is /etc/GeoIP.conf
.
Install geoipupdate 4.x
Follow the instructions in our documentation for how to do this.
If you previously installed it via our PPA, you should be able to upgrade through apt
.
If you previously installed it via make install
, you should determine where it’s installed so you don’t end up with conflicting versions.
You can run this command to check where it is:
# which geoipupdate /usr/bin/geoipupdate
In this case geoipupdate
is installed to /usr/bin/geoipupdate
so I’d want to install there again.
After you’ve installed it, confirm by running geoipupdate -V
that you’re running 4.x.
Test it
Run geoipupdate
in verbose mode to verify it’s using the config file you expect and completes without error:
$ geoipupdate -v Using config file /etc/GeoIP.conf ...
If it’s using a config file from a different spot than you expect, either move your config to that location or pass the -f
flag when running geoipupdate
to tell it where to find the config.
Check cron
If you configured geoipupdate
to run from cron then it is a good idea to confirm it will continue to work.
In particular you should check the command in your cron configuration will use the config file you expect. You can run the command from your crontab with the verbose flag (-v
) to verify this.