Project

General

Profile

1 702 aaronmk
Installation:
2
    Install: make install
3
    Uninstall: make uninstall
4 1749 aaronmk
        WARNING: This will delete your VegBIEN DB!
5 554 aaronmk
6 702 aaronmk
Data import:
7 1550 aaronmk
    Import data into VegBIEN: . bin/import_all
8 1556 aaronmk
    Stop all running imports: . bin/stop_imports
9 703 aaronmk
    Empty the DB: make empty_db
10 1749 aaronmk
        WARNING: This will delete your VegBIEN DB!
11 1550 aaronmk
    Re-import data: make empty_db; . bin/import_all
12 1749 aaronmk
        WARNING: This will delete your VegBIEN DB!
13 554 aaronmk
14 1773 aaronmk
Datasource setup:
15
    Add a new datasource: make inputs/<short_name>/add
16
        If the datasource is a herbarium, <short_name> should be the herbarium
17
        code as defined by the Index Herbariorum <http://sweetgum.nybg.org/ih/>
18
19 702 aaronmk
Schema changes:
20
    Regenerate schema from installed DB: make schemas/remake
21
    Reinstall DB from schema: make reinstall_db
22 1750 aaronmk
        WARNING: This will delete your VegBIEN DB!
23 702 aaronmk
    Sync ERD with vegbien.sql schema:
24
        Run make schemas/vegbien.my.sql
25
        Open schemas/vegbien.ERD.mwb in MySQLWorkbench
26
        Go to File > Export > Synchronize With SQL CREATE Script...
27
        For Input File, select schemas/vegbien.my.sql
28
        Click Continue
29
        Click in the changes list and press Ctrl+A or Apple+A to select all
30
        Click Update Model
31
        Click Continue
32
        Note: The generated SQL script will be empty because we are syncing in
33
            the opposite direction
34
        Click Execute
35
        Reposition any lines that have been reset
36
        Add any new tables by dragging them from the Catalog in the left sidebar
37
            to the diagram
38
        Remove any deleted tables by right-clicking the table's diagram element,
39
            selecting Delete '<table name>', and clicking Delete
40
        Save
41
        Go to File > Export > Export as PNG...
42
        Select schemas/vegbien.ERD.png
43
        Go to File > Export > Export as SVG...
44
        Select schemas/vegbien.ERD.svg
45
        Go to File > Export > Export as Single Page PDF...
46
        Select schemas/vegbien.ERD.pdf
47 203 aaronmk
48 1459 aaronmk
Testing:
49
    Mapping process: make test
50
    Map spreadsheet generation: make remake
51 1744 aaronmk
    Missing mappings: make missing_mappings
52 1459 aaronmk
    Everything (for most complete coverage): make test-all
53 702 aaronmk
54
General:
55
    To see a program's description, read its top-of-file comment
56
    To see a program's usage, run it without arguments