Enable/Disable

The Storage Integration is implemented as an Application Package.

Note:

Enabling/disabling Storage Integration for applications can be done using The Things Stack Console or CLI. Enabling/disabling Storage Integration for individual end devices is available only via CLI.

Enable for an Application

Console
CLI

Navigate to Applications in the top menu and then select your application. On the left side, click Integrations and then Storage Integration.

Click on Activate Storage Integration to enable the storage integration for your application.

Set up a default association between the desired application and the storage-integration package.

$ ttn-lw-cli applications packages default-associations set "app1" 100 --package-name storage-integration

Note:

The f_port for the default association is set to 100. This value is irrelevant. The storage integration will receive and store all uplink messages, regardless of f_port. The f_port value is only needed because of the way application packages work with The Things Stack.

Warning:

Do not configure more than one default association for the same application, since that will lead to storing duplicate messages in the persistent storage.

Enable for an End Device

Command-line interface only

The instructions below use the command-line interface (CLI).

Make sure that the CLI is up-to-date and uses an updated configuration file: ttn-lw-cli use...

Learn how to install or upgrade the CLI

Set up an association between the desired end device and the storage-integration package.

$ ttn-lw-cli applications packages associations set "app1" "dev1" 100 --package-name storage-integration

Note:

The f_port value is irrelevant.

Warning:

Do not configure multiple associations for the same end device, since that will lead to storing duplicate uplinks in the persistent storage.

To disable the integration, you only need to click the Deactivate Storage Integration button:

To disable the integration, delete the package association, or the default association:

# List default associations
$ ttn-lw-cli applications packages default-associations list "app1"
{
  "defaults": [
    {
      "ids": {
        "application_ids": {
          "application_id": "app1"
        },
        "f_port": 100
      },
      "created_at": "2020-08-24T21:09:44.649890166Z",
      "updated_at": "2020-08-24T21:09:44.649890166Z",
      "package_name": "storage-integration"
    }
  ]
}

$ ttn-lw-cli applications packages default-associations delete "app1" 100

Disable for an End Device

Command-line interface only

The instructions below use the command-line interface (CLI).

Learn how to install the CLI

To disable the integration, delete the association. First, list associations:

# List associations
$ ttn-lw-cli applications packages associations list "app1" "dev1"
{
  "associations": [
    {
      "ids": {
        "end_device_ids": {
          "device_id": "dev1",
          "application_ids": {
            "application_id": "app1"
          }
        },
        "f_port": 100
      },
      "created_at": "2020-08-24T21:09:44.649890166Z",
      "updated_at": "2020-08-24T21:09:44.649890166Z",
      "package_name": "storage-integration"
    }
  ]
}

Delete the association with:

# Delete association between "app1" and "dev1"
$ ttn-lw-cli applications packages associations delete "app1" "dev1" 100

← Configuration Retrieve messages →