Skip to content

Utility to migate ChirpStack v3 data into ChirpStack v4.

License

Notifications You must be signed in to change notification settings

chirpstack/chirpstack-v3-to-v4

Repository files navigation

ChirpStack v3 to v4 data-migration

This utility migrates data from a single ChirpStack Application Server instance and one or multiple ChirpStack Network Server instances (in case of multiple-regions) into the new ChirpStack v4 data-structure.

Help:

Usage:
  chirpstack-v3-to-v4 [flags]

Flags:
      --as-config-file string                Path to chirpstack-application-server.toml configuration file
      --cs-config-file string                Path to chirpstack.toml configuration file
      --deveui-list-file string              Path to file containing DevEUIs to migrate (one DevEUI per line)
      --device-profile-id-list-file string   Path to file containing list of Device Profile IDs to migrate (one per line)
      --device-session-ttl-days int          Device-session TTL in days (default 31)
      --disable-migrated-devices             Disable migrated devices in ChirpStack v3
      --drop-tenants-and-users               Drop tenants and users before migration
  -h, --help                                 help for chirpstack-v3-to-v4
      --migrate-applications                 Migrate applications (default true)
      --migrate-device-metrics               Migrate device metrics (default true)
      --migrate-device-profiles              Migrate device profiles (default true)
      --migrate-devices                      Migrate devices (default true)
      --migrate-gateway-metrics              Migrate gateway metrics (default true)
      --migrate-gateways                     Migrate gateways (default true)
      --migrate-tenants                      Migrate tenants (default true)
      --migrate-users                        Migrate users (default true)
      --ns-config-file stringArray           Path to chirpstack-network-server.toml configuration file (can be repeated)

Usage example:

./chirpstack-v3-to-v4 \
	--cs-config-file /etc/chirpstack/chirpstack.toml \
	--as-config-file /etc/chirpstack-application-server/chirpstack-application-server.toml \
	--ns-config-file /etc/chirpstack-network-server/chirpstack-network-server.toml

Warning: Always make a backup before starting a migration. If the --drop-tenants-and-users argument is used, then all data in the target database will be removed!

Notes

  • This utility is compatible with the ChirpStack v4.8.1 database schema.
  • This utility does not support environment variables in configuration files, like ChirpStack does.

Building from source

For creating a snapshot release:

make snapshot

For creating a release:

make release