NAME
install_mapdata - download and install data files for enhanced maps
SYNOPSIS
install_mapdata [-n] [-d directory]
DESCRIPTION
Some Antelope applications (such as
dbevents(1)) support enhanced mapping
capabilities. In order to show the enhanced maps, these programs require separate
download and installation of the supporting data files. The
install_mapdata script
downloads these map files from the BRTT web-site and installs them.
install_mapdata checks the checksum files accompanying each data file.
If the destination directory already contains files with up-to-date checksums,
install_mapdata
does not re-download the data.
OPTIONS
-
-d directory
This option allows specification of an alternate target directory for the download (rather than the sub-directory
constructed from the parameter file as topdir/install_subdir).
-
-n
Dry-run only: report what would be downloaded and with what total size, without actually downloading anything.
FILES
The names of the files that
install_mapdata will download are given in the parameter named
files in
install_mapdata.pf. For each of these named files,
install_mapdata
expects to find both a file of that name and a file of that name plus the
.md5 suffix on the
download_site named in the parameter file.
PARAMETER FILE
Parameters
-
download_site
This parameter gives the web-site Uniform Resource Locator (URL) where the map data files
are available
-
files
This Tbl parameter lists the names of the files to download. The .md5 files
containing their checksums are automatically assumed and should not by specified
explicitly.
-
install_subdir
This parameter gives the subdirectory of topdir in which to install the downloaded
map data files (normally data/maps/bmd).
-
topdir
This parameter gives the top-level directory under which to install the downloaded
map data files in install_subdir (normally /opt/antelope).
Parameter-file Example
download_site http://www.brtt.com/mapdata
topdir /opt/antelope
install_subdir data/maps/bmd
files &Tbl{
bluemarble.world.200407.v01.grid.bmd
}
EXAMPLE
% install_mapdata
New enhanced map data file 'bluemarble.world.200407.v01.grid.bmd' available.
Downloading 2.6 GB of enhanced map data to '/opt/antelope/data/maps/bmd':
Downloading 'http://www.brtt.com/mapdata/bluemarble.world.200407.v01.grid.bmd' to '/opt/antelope/data/maps/bmd'...done
Downloading 'http://www.brtt.com/mapdata/bluemarble.world.200407.v01.grid.bmd.md5' to '/opt/antelope/data/maps/bmd'...done
install_mapdata run completed successfully.
%
RETURN VALUES
install_mapdata exits with return code 0 upon success and -1 upon any error.
DIAGNOSTICS
install_mapdata complains about a number of possible problems:
-
Inability to contact the download web-site
-
Inability to find the expected files or their md5 checksum files on the download site
-
Inability to download any of the expected files or their md5 checksum files
-
Inability to write to the destination subdirectory
-
Insufficient disk space in the destination subdirectory
install_mapdata will quit with an error exit upon the first error it encounters.
SEE ALSO
dbevents(1)
install_contrib(1)
BUGS AND CAVEATS
install_mapdata needs an internet connection capable of connecting to the BRTT
web-site and downloading large data files.
install_mapdata also requires write
permissions in the $ANTELOPE/data directory as well as sufficient disk space there to
save the downloaded files.
install_mapdata does not recompute file checksums. It just checks the checksum files
that exist alongside their respective data files.
AUTHOR
Kent Lindquist