geo-update: DNS Database Update Utility (pre-Urchin 7)

geo-update: DNS Database Update Utility (pre-Urchin 7)

Overview

The geo-update utility is used to check for the updates to Urchin's internal DNS database and to download the updates if they are available. It allows you to download the updates from Google download servers as well as from a local directory (new for Urchin 6).

Usage

The geo-update utility can be invoked by the Urchin scheduler (urchind) on monthly basis or manually through command line. When invoked via scheduler, it always updates from the google download server. When invoked on command line, it provides an additional option of updating DNS database from some local path. This task is set to check for new updates once per month and can be configured by the user to occur at a certain time using the admin interface.

If a task has been created for geo-update, then it appears on Task History screen with name "geo-update".

The default behavior is to check for updates, download the new databases and overwrite the existing ones. The default behaviors can be overridden by running geo-update from the command line with the appropriate options. The usage is as follows:

geo-update [-Hhv] [-D | -F] [-i file]

where

  -F            Forces download of geo databases
  -f            Pathname of geo.zip file on local filesystem [optional]
  -H            Specifies to log run output to history file
  -h            Prints help information and exits
  -T <task id>  Specifies the task history record to update
                Specifying -T forces use of -H
  -V            Prints geo-database version number and exits
  -v            Prints version number and exits

Using the -F option will force the download of new databases even if the databases are already up to date. This feature is useful if you imported incorrect custom domain information or otherwise damaged your domain database and wish to start over with a fresh copy.

Logging output to a history file with the -H option will make the run information available when viewing the Task History screen in the Configuration->Scheduler area of the Urchin administration interface.

Use of option -T allows you to enforce an update of a particular task from the CLI specified by <Task_ID>. The Task_ID value can be found in the Urchin 6 database using the following query:

mysql> select * from ugeo_tasks\G

Examples

To force a download of the latest domains database:

geo-update -F

To update task manually from CLI (when task ID is already retrieved from DB):

geo-update -T <Task_ID> -H

The geo-update utility needs an internet connection to be able to check for and download new updates. The utility uses port 80 to communicate with the webserver providing the updates. It is possible that you will have problems when going through firewalls and proxy servers when doing updates. Please consult your network administrator if this is the case.

geo-update: DNS Database Update Utility (Urchin 7+)

Use the geo-update utility to check for updates to Urchin's internal DNS database files and download the updates if they are available. The utility can also be used to import custom entries into the DNS databases by using the domain.local file or another specified text file.

geo-update options:

-F     Forces download of geo databases
-f     Path to geo database ZIP packages on local filesystem [optional]
-h     Prints help information and exits
-g     <filename> Update a specific geo database
-l     Lists geo databases available on server
-V     Prints geo-database version number and exits
-v     Prints version number and exits
-I     Import domain data only. If this option is provided, geo-update utility performs custom DNS import only, without updating the geo databases.
-i     <filename>  Import domain data from specified file
-I     Import domain data only. If this flag is provided, geo-update utility should perform custom DNS import ONLY, without updating the geo databases.
-i     <filename> Specify the file to import domain data from. If the filename is specified, it will be used for import, otherwise the URCHIN_HOME/data/geodata/domain.local file will be used, if it presents.