QuickstartΒΆ
Download wis2box and start using Malawi test data:
git clone https://github.com/wmo-im/wis2box.git
cd wis2box
For the purposes of a quickstart, this deployment expects the test environment, which includes data and metadata. This is done by using the test environment file:
cp tests/test.env dev.env
vi dev.env
# ensure WIS2BOX_HOST_DATADIR is set to a local path on disk for persistent storage
Note
For more information on deployment, see Administration and Configuration
Start wis2box with Docker Compose and login to the wis2box container:
python3 wis2box-ctl.py start
python3 wis2box-ctl.py status --all # The --all flag shows all containers, even ones that are down.
python3 wis2box-ctl.py login
Once logged in, create the enviroment and verify it is correct:
wis2box environment create
wis2box environment show
Setup observation data processing and API publication:
wis2box data setup --topic-hierarchy data.core.observations-surface-land.mw.FWCL.landFixed
wis2box api add-collection --topic-hierarchy data.core.observations-surface-land.mw.FWCL.landFixed $WIS2BOX_DATADIR/metadata/discovery/surface-weather-observations.yml
Publish station collection and discovery metadata to the API:
wis2box metadata station cache $WIS2BOX_DATADIR/metadata/station/station_list.csv
wis2box metadata station publish-collection
wis2box metadata discovery publish $WIS2BOX_DATADIR/metadata/discovery/surface-weather-observations.yml
Process data via CLI:
wis2box data ingest --topic-hierarchy data.core.observations-surface-land.mw.FWCL.landFixed --path $WIS2BOX_DATADIR/observations/WIGOS_0-454-2-AWSNAMITAMBO_2021-07-07.csv
wis2box api add-collection-items --recursive --path $WIS2BOX_DATADIR/data/public
Logout of wis2box container:
exit
Restart the wis2box API container:
python3 wis2box-ctl.py restart pygeoapi
From here, you can run python3 wis2box-ctl.py status
to confirm that containers are running.
To explore your wis2box installation and services, visit http://localhost:8999 in your web browser.