Merge pull request #809 from colouring-cities/roll-out

ETL doc minor additions
This commit is contained in:
Ed Chalstrey 2022-04-28 10:30:16 +01:00 committed by GitHub
commit f6646a6cc9
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -25,7 +25,11 @@ The building geometries are sourced from Ordnance Survey (OS) MasterMap (Topogra
# :penguin: Making data available to Ubuntu # :penguin: Making data available to Ubuntu
Before creating or updating a Colouring London database, you'll need to make sure the downloaded OS files are available to the Ubuntu machine where the database is hosted. If you are using Virtualbox, you could host share folder(s) containing the OS files with the VM (e.g. [see these instructions for Mac](https://medium.com/macoclock/share-folder-between-macos-and-ubuntu-4ce84fb5c1ad)). Before creating or updating a Colouring London database, you'll need to make sure the downloaded OS files are available to the Ubuntu machine where the database is hosted.
If you are using Virtualbox, you could host share folder(s) containing the OS files with the VM (e.g. [see these instructions for Mac](https://medium.com/macoclock/share-folder-between-macos-and-ubuntu-4ce84fb5c1ad)).
For a production server hosted on a cloud computing platform (e.g. Azure), you could [use SCP](https://uoa-eresearch.github.io/vmhandbook/doc/copy-file-linux.html).
# :new_moon: Creating a Colouring London database from scratch # :new_moon: Creating a Colouring London database from scratch
@ -113,6 +117,8 @@ export PGHOST=localhost
export PGDATABASE=<colouringlondondb> export PGDATABASE=<colouringlondondb>
``` ```
First make sure to run `git pull` to catch any code changes and run any new database migrations from `../migrations` added since the last time the db was updated.
Move into the `etl` directory and set execute permission on all scripts. Move into the `etl` directory and set execute permission on all scripts.
```bash ```bash
@ -164,3 +170,9 @@ Mark buildings with geometries not present in the update as demolished.
```bash ```bash
./mark_demolitions.sh ./mark_demolitions.sh
``` ```
#### On a production server
**TODO:** Update this after PR [#794](https://github.com/colouring-cities/colouring-london/pull/794)
Run the Colouring London [deployment scripts](https://github.com/colouring-cities/colouring-london-config#deployment).