Back to main site | Back to man page index

GEOIPUPDATE(1)                                 General Commands Manual                                 GEOIPUPDATE(1)



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

              [email protected]

              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 <[email protected]>

COPYRIGHT
       Copyright © 2011 MaxMind, Inc.