= Make a KML Overview =

This page describes how to use the script make_kmloverview.py.

== First run ==

Needs to be ran as airborne user.

This should be run at the unpacking stage - note that the first time it runs it will fail if the weblink does not exist. This can be created after the first run as follows.

{{{
make_kmloverview.py -l <main_project_directory> --unpacking
}}}

Runs in dry run mode - please check that there are no suspicious or fatal errors before running in --final mode. One error that you will get is the following:

'''Symlink does not exist on webserver. This must exist to continue - paste below into terminal and enter password. Then re-run this script'''

Copy / Paste the required command into the terminal and enter the rsgadmin password. 

Also note that in dry-run mode, the output password to the terminal will NOT be the same as the password created when run in --final mode.

== Final run ==

If happy that everything looks in order run with --final, i.e.

{{{
make_kmloverview.py -l <main_project_directory> --unpacking --final
}}}

If you require the username and password for emailing the PI then you can access it from the processing/kml_overview/.htaccess file.

== Auto updates ==

This script is set up as a cronjob to run automatically every night.