geoip-update

Uses the license key configured in a GeoIP connect profile to download and update the specified type of GeoIP database from the MaxMind server.

Command properties

ItemDescription
Command typeDriver query
Required permissionNone
License usageNot counted
Parallel executionNot supported
Distributed executionNot supported

Syntax

geoip-update type={COUNTRY|CITY|ASN} [profile=STR]

Options

type={COUNTRY|CITY|ASN}
Type of GeoIP database to update
  • COUNTRY: Country information database
  • CITY: City information database
  • ASN: Autonomous System Number (ASN) database
profile=STR
GeoIP connect profile identifier. If omitted, runs against all registered GeoIP type connect profiles.

Output fields

FieldTypeDescription
profilestringName of the connect profile used for the update
update_timestringLast modified date of the downloaded database (in yyyy-MM-dd format)
typestringType of database updated

Error codes

Parse errors
Error codeMessageDescription
209800사용 가능한 GeoIP 프로파일이 없습니다.No GeoIP connect profiles are registered or accessible
209801GeoIP 프로파일 이름을 입력하세요.The profile option is required but not specified
209802type 옵션을 지정하세요.The type option is not specified
Runtime errors

N/A

Description

The geoip-update command uses the MaxMind license key configured in a GeoIP connect profile to download the specified type of GeoIP database from the internet. An error occurs if the database is already at the latest version.

When you specify the profile option, the update is performed through the GeoIP service associated with that connect profile. If you omit the profile option, the update is performed against all registered GeoIP connect profiles.

If an HTTP proxy is configured in the connect profile, the download is performed through the proxy.

Examples

  1. Update the country database

    geoip-update type=COUNTRY
    

    Updates the country information database for all registered GeoIP connect profiles.

  2. Update the city database using a specific connect profile

    geoip-update type=CITY profile=geoip_main
    

    Updates the city information database using the geoip_main connect profile.

  3. Update the ASN database

    geoip-update type=ASN
    

    Updates the ASN database for all registered GeoIP connect profiles.