TTN V2 migratie naar TTN V3

Wanneer systemen erg groeien gebeurt het dat er functionaliteiten bij moeten komen of bugs gefixed moeten worden waarvoor zodanig veel verandert moet worden dat het uitgesteld wordt naar een nieuwe major versie. In dit geval gaat TheThingsNetwork zijn systemen upgraden van v2.x.x naar v3.x.x, het gevolg is dat hier Breaking Changes in kunnen zitten. Breaking changes betekent dat de gebruiker ook actie moet ondernemen om gebruikt te kunnen maken van deze nieuwe versie.

In het kort heeft dit impact op de volgende zaken.

Voor al deze zaken worden al aan oplossingen gewerkt. Zodra deze bekend zijn zal deze pagina geüpdatet worden

  • Apparaten moeten opnieuw geregistreerd worden op het nieuwe V3 platform. (Zie Applicatie Verhuizen)

    • Hiervoor moeten apparaten opnieuw de Join Procedure ondergaan. Dit kan door het apparaat uit en aan te zetten nadat deze opnieuw geregistreerd is op het V3 platform.

  • Apparaten moeten langer aanstaan om berichten te versturen en ontvangen, dit kost aanzienlijk meer energie en vermindert de levensduur naar een jaar.

  • Gateways moeten opnieuw geregistreerd worden op het nieuwe V3 platform. (Zie Gateway Verhuizen)

    • Hiervoor moeten de gateway instellingen geüpdatet worden om te communiceren met de V3 servers in plaats van de V2 servers. (Tevens nadat deze opnieuw geregistreerd is)

  • Data opname via ons portaal moet geüpdatet worden om het nieuwe V3 formaat te ondersteunen

Gateway verhuizen

Het verhuizen van een gateway naar V3 komt met het gevolg dat deze gateway geen data zal doorsturen van v2 apparaten; apparaten die nog op het oude systeem staan geregistreerd.

Gateways die staan geregistreerd op het V2 systeem sturen wel data door naar het V3 systeem. Daarom wordt aangeraden het verhuizen van je gateways in overleg met je lokale TTN community te regelen. (Zoek naar je community: https://www.thethingsnetwork.org/community)

Applicatie verhuizen

Een applicatie is een verzameling aan apparaten die geregistreerd staan op het TheThingsNetwork netwerk. Elk apparaat heeft een aantal sleutels waarmee het zichzelf kan identificeren en autoriseren.

Om te beginnen met data te versturen moet er een beveiligde sessie worden opgezet. Als deze sessie is opgezet krijgt het apparaat een Device Address (devAddr). Alle mogelijke device adressen zijn opgedeeld in blokken. V2 heeft een ander blok aan device adressen dan V3.

Een applicatie op het V2 systeem kan geen gebruik maken van gateways op het V3 systeem. Vice versa kan wel, een applicatie op het V3 systeem kan wel gebruik maken van gateways op het V2 systeem. (Zie Gateway Verhuizen)

Met herstarten van het apparaat (beste keuze)

Wanneer een apparaat geregistreerd wordt op het V3 systeem, hoort deze sessie niet mee gekopieerd te worden en moet er een nieuwe sessie worden opgezet. In de meeste gevallen betekend dit het apparaat opnieuw opstarten / uit en aan zetten. Het apparaat zal automatisch een nieuwe sessie maken. In dit geval kunnen zowel V2 als V3 gateways data van het apparaat ontvangen en verlies je geen bereik.

Zonder herstarten van het apparaat

Er is een mogelijkheid om een sessie mee te kopiëren van het V2 naar het V3 systeem. Omdat het apparaat nog een device adres heeft van het V2 netwerk, zullen V2 gateways deze data niet doorsturen naar het V3 netwerk. Alleen V3 gateways zullen dit doen. Hierdoor wordt een heel groot deel van de bestaande gateways onbruikbaar, totdat deze zijn verhuist naar het V3 systeem en dat kan een redelijke tijd duren.