geoipupdate (1) - Linux Manuals

geoipupdate: a program for updating the MaxMind GeoIP databases

NAME

geoipupdate - a program for updating the MaxMind GeoIP databases

SYNOPSIS

geoipupdate [-v] [-f licensefile]

DESCRIPTION

geoipupdate automatically updates the GeoIP database for GeoIP subscribers. It connects to the MaxMind GeoIP Update server and checks for an updated database. If it finds an updated database, then it downloads it, uncompresses it, and installs it. If you are running a firewall, it requires that the DNS and HTTP (80) ports be open.

For example

geoipupdate -v

Performs the update in verbose mode.

OPTIONS

-v
Verbose mode, prints out the steps that geoipupdate takes.
-d
Specify a custom directory target to install the GeoIP datafile(s). By default geoipupdate installs to /usr/share/GeoIP
-f
Specifies the configuration file that contains the license key. Defaults to /etc/GeoIP.conf

USAGE

Typically you'll want to write a weekly crontab that will run geoipupdate. Below is a sample crontab that runs geoipupdate on each Wednesday at noon:

# top of crontab

MAILTO=your [at] email.com

0 12 * * 3 BIN_DIR/geoipupdate

# end of crontab

To use with a proxy server, set the http_proxy environment variable. E.g.
export http_proxy="http://proxy-hostname:port"

RETURN CODES

geoipupdate returns 0 on success, 1 on error.

FILES

/etc/GeoIP.conf

Configuration file for GeoIP, should contain license key.

AUTHOR

Written by T.J. Mather

REPORTING BUGS

Report bugs to <support [at] maxmind.com>

COPYRIGHT

Copyright © 2011 MaxMind, Inc.

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO

Visit <http://www.maxmind.com/app/products> to sign up for a GeoIP subscription.

geoiplookup(1), crontab(5)