adding-wis2downloader-exercises by alhelguera · Pull Request #173 · wmo-im/wis2box-training

alhelguera · 2026-05-28T11:59:22Z

Adding the WIS2 Downloader related exercises for the practical sessions in support of the Port of Spain training

…wmo-im/wis2box-training into adding-wis2downloader-exercises

* wis2box-1.3 updates * Auto-translated docs * Update adding-gts-headers-to-wis2-notifications.md * Auto-translated docs --------- Co-authored-by: github-actions <github-actions@github.com> Co-authored-by: Tom Kralidis <tomkralidis@gmail.com>

maaikelimper · 2026-06-04T18:42:43Z

Regarding the text on tunnel at the beginning:

Remove this image, it is showing your localconfigured sessions which looks weird on a public webpage:
http://localhost:8000/assets/img/putty-tunnel-settings.png

You can keep the second image of putty.

Please add one line with the example of setting up tunnel when using SSH in from Linux or Macbook terminal, not everyone is using PuTTy

maaikelimper · 2026-06-04T18:50:21Z

Use the following download path `/home/{USER}/wis2-downloads` and press Enter to use the defaults for both the user and groups
maybe instead say:
Use the following download path `/home/<username>/wis2-downloads`, replacing <username> with your username. Next press Enter to use the defaults for both the user and groups.

maaikelimper · 2026-06-04T19:01:57Z

Replace /home/{USER}/wis2-downloads with ~/wis2-downloads for the "ls -r" and "rm -fr" commands

…wmo-im/wis2box-training into adding-wis2downloader-exercises

david-i-berry · 2026-06-05T06:17:09Z

    ```bash
    pip3 install minio
-    pip3 install pywiscat==0.4.0
+    pip3 install pywiscat


No longer pinning to a version?

david-i-berry · 2026-06-05T06:19:16Z

 ```bash
 docker run -d --name demo-decode-eccodes-jupyter \
-    -v ~/wis2box-data/downloads:/root/downloads \
+    -v ~/wis2-downloads:/root/downloads \


david-i-berry · 2026-06-05T06:39:07Z

 !!! note

-    The current training materials are based on wis2box-release 1.2.0. 
+    The current training materials are based on wis2box-release 1.3.0. 


I've seen updating the release number in a few places. Do we want to parameterise?

david-i-berry · 2026-06-05T06:41:08Z

+
+!!! note "About WIS2 Downloader"
+
+     The WIS2 Downloader is available as a standalone Docker Compose project and is recommended to be ran on a separate server from the wis2box, so as to not have the downloads interfering with the publication of messages.


Separate server or separate VM? Some concerns were raised previously about the need for another server.

Both sound kind of wrong to me. Maybe call it a "separate environment"

environment is wrong. I would just use "on a separate server or virtual machine".

david-i-berry · 2026-06-05T07:49:42Z

+
+     The WIS2 Downloader is available as a standalone Docker Compose project and is recommended to be ran on a separate server from the wis2box, so as to not have the downloads interfering with the publication of messages.
+
+     If you would like to develop your own service for subscribing to WIS2 notifications and downloading data, you can use the [WIS2 Downloader source code](https://github.com/World-Meteorological-Organization/wis2downloader) as a reference.


I'd recommend the simpler pywis-pubsub

david-i-berry · 2026-06-05T09:36:02Z

+
+## Preparation and requirements
+
+!!! note "If not during the training"


What does "If not during the training" mean?

That if you are not following the exercise during the training then you don't need to set up any tunnels probably as your setup would be very different

Not true. For example, we make the assumption or direct people to install on an internal network. There may still be the case that someone needs to tunnel from outside to modify subscriptions., for example someone teleworking.

Also, as written it implies that people only need to do the tunneling outside of the training.

Change it to "If on a restricted network"?

david-i-berry · 2026-06-05T09:36:23Z

+
+!!! note "If not during the training"
+
+    The following steps are only to be applied if the mentioned ports are unavailable by default on the server. In any configuration, these are the only ports needed  to be accessed in order to use the full capabilities of the WIS2 Downloader stack.    


"The following steps only need to be applied if the downloader is run on a different network and the mentioned ports are inaccessible".

david-i-berry · 2026-06-05T09:40:21Z

+
+## Reviewing the WIS2 Downloader configuration
+
+The WIS2 Downloader instance can be configured using the environment variables defined in your `.env` file.


s/can be/is/

david-i-berry · 2026-06-05T09:42:45Z

+
+You can keep the default configuration for the next exercises.
+
+## WIS2 Downloader API


How much do we / you want to go into this? The whole point of the UI is to avoid needing to do this.

I would only cover this topic if you have lots of spare time.

Not sure if I'll actually use all of the exercises as such. I only want to have it in the page in case someones comes in later and wants to check by themselves in many of them even.

maaikelimper

Please check,
rm -fr ~/wis2-downloads/synop-data

vs

rm -fr /home//wis2-downloads/surface-obs

apart from that, approved

alhelguera and others added 17 commits May 28, 2026 13:58

adding setup page

b9e03a6

Merge b9e03a6 into 426b18e

b81a8f6

Auto-translated docs

9501ac4

adding exercise on downloading data in ui

cc9dc3c

Merge branch 'adding-wis2downloader-exercises' of https://github.com/…

da5e557

…wmo-im/wis2box-training into adding-wis2downloader-exercises

Merge da5e557 into 426b18e

b6027d4

Auto-translated docs

f31e5f0

adding downloading page

af6767b

Merge af6767b into 426b18e

7afc780

Auto-translated docs

5ca648b

adding access control section and fixes

4950532

Merge 4950532 into 426b18e

0f37727

Auto-translated docs

7758eea

wis2box-1.3 updates (#175)

0855b81

* wis2box-1.3 updates * Auto-translated docs * Update adding-gts-headers-to-wis2-notifications.md * Auto-translated docs --------- Co-authored-by: github-actions <github-actions@github.com> Co-authored-by: Tom Kralidis <tomkralidis@gmail.com>

fixing errors and finishing the downloading sections

7d5ade1

Merge 7d5ade1 into 0855b81

ff95d73

Auto-translated docs

42fa36b

alhelguera requested a review from maaikelimper June 4, 2026 09:42

alhelguera requested a review from david-i-berry June 4, 2026 18:56

alhelguera and others added 2 commits June 4, 2026 20:59

wording and taking example out

b2b4c8b

Merge b2b4c8b into 0855b81

1788801

github-actions and others added 6 commits June 4, 2026 19:05

Auto-translated docs

2e3b88f

align decoding and downloading exercises with new folder-name

e73aa3a

Merge e73aa3a into 0855b81

f9703f0

Auto-translated docs

ac405b2

wording fixes and taking out unused img

779d1d8

Merge 779d1d8 into 0855b81

47faa05

github-actions and others added 5 commits June 4, 2026 20:00

Auto-translated docs

27fc536

cropping images

68844a7

Merge branch 'adding-wis2downloader-exercises' of https://github.com/…

ca2773a

…wmo-im/wis2box-training into adding-wis2downloader-exercises

Merge ca2773a into 0855b81

8f7e751

Auto-translated docs

a427022

david-i-berry reviewed Jun 5, 2026

View reviewed changes

alhelguera and others added 3 commits June 5, 2026 10:57

changing intro note

a33de77

Merge a33de77 into 0855b81

61c9f1d

Auto-translated docs

dac7630

david-i-berry reviewed Jun 5, 2026

View reviewed changes

alhelguera and others added 3 commits June 5, 2026 12:02

wording changes

781a3b6

Merge 781a3b6 into 0855b81

8e2eedc

Auto-translated docs

33af45d

alhelguera requested a review from david-i-berry June 5, 2026 12:53

maaikelimper approved these changes Jun 5, 2026

View reviewed changes

alhelguera merged commit 2c6418c into main Jun 5, 2026

alhelguera deleted the adding-wis2downloader-exercises branch June 5, 2026 15:23


		!!! note "About WIS2 Downloader"

		The WIS2 Downloader is available as a standalone Docker Compose project and is recommended to be ran on a separate server from the wis2box, so as to not have the downloads interfering with the publication of messages.


		The WIS2 Downloader is available as a standalone Docker Compose project and is recommended to be ran on a separate server from the wis2box, so as to not have the downloads interfering with the publication of messages.

		If you would like to develop your own service for subscribing to WIS2 notifications and downloading data, you can use the [WIS2 Downloader source code](https://github.com/World-Meteorological-Organization/wis2downloader) as a reference.


		## Preparation and requirements

		!!! note "If not during the training"


		!!! note "If not during the training"

		The following steps are only to be applied if the mentioned ports are unavailable by default on the server. In any configuration, these are the only ports needed to be accessed in order to use the full capabilities of the WIS2 Downloader stack.


		## Reviewing the WIS2 Downloader configuration

		The WIS2 Downloader instance can be configured using the environment variables defined in your `.env` file.


		You can keep the default configuration for the next exercises.

		## WIS2 Downloader API

Conversation

alhelguera commented May 28, 2026

Uh oh!

maaikelimper commented Jun 4, 2026

Uh oh!

maaikelimper commented Jun 4, 2026

Uh oh!

maaikelimper commented Jun 4, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

david-i-berry Jun 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

maaikelimper left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

david-i-berry Jun 5, 2026 •

edited

Loading