ttn-lw-migrate
is a tool that can be used for migrating end devices and applications from supported LoRaWAN® networks (like ChirpStack) to The Things Stack, or between The Things Stack distributions. This section provides details on how to install, configure and use this tool.
This tool works in a way that it exports descriptions of end devices and applications to a JSON file, that can later be imported in The Things Stack.
Installation
The migration tool can be installed using package managers or manually from binary files. We highly recommend installing or upgrading to ttn-lw-migrate
version 0.5.0
or newer, because some features like session migration are not available for prior versions.
To install ttn-lw-migrate
tool with brew
:
brew install TheThingsNetwork/homebrew-lorawan-stack/ttn-lw-migrate
To upgrade ttn-lw-migrate
tool if updates are available:
brew upgrade TheThingsNetwork/homebrew-lorawan-stack/ttn-lw-migrate
To install ttn-lw-migrate
tool with snap
:
sudo snap install ttn-lw-migrate
To upgrade ttn-lw-migrate
tool if updates are available:
sudo snap refresh ttn-lw-migrate
Download the zipped archive with binary files for Windows from Github.
Extract the folder from ZIP archive and enter the folder. Double-click to run the ttn-lw-migrate.exe
executable file.
After this, you will be notified that you can run ttn-lw-migrate
from the command prompt.
Usage
To use the ttn-lw-migrate
tool after successful installation, use your terminal or command prompt to navigate to the folder where it is installed and run the commands from there. Run ttn-lw-migrate help
to see all available commands and flags.
To list available sources that you can migrate your end devices and applications from:
ttn-lw-migrate sources
Currently, there are three available sources listed in the table below. For detailed migration instructions using these three sources, check the linked sections.
The
tts
source can be used for migrating devices between applications in the same The Things Stack tenant, migrating between different tenants, or migrating between different The Things Stack deployments.
Source | Section | Used for |
---|---|---|
tts |
Export Devices from The Things Stack | Migrating between The Things Stack distributions |
chirpstack |
Export Devices from ChirpStack | Migrating devices from ChirpStack |
ttnv2 |
Discontinued | Migrating from legacy V2 deployments |