• Antelope Release 5.10 Linux CentOS release 7.6.1810 (Core) 3.10.0 2020-05-12

 

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

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

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:

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
Printer icon