Release v3.30.2 documentation (#1351)

* docs: Release v3.30.2 * doc: Update featured section --------- Co-authored-by: Krishna Iyer <[email protected]>
TheThingsIndustries · Jun 17, 2024 · fadf0ba · fadf0ba
1 parent 83e865d
commit fadf0ba
Show file tree

Hide file tree

Showing 9 changed files with 727 additions and 1,052 deletions.
diff --git a/doc/config/_default/config.toml b/doc/config/_default/config.toml
@@ -24,7 +24,7 @@ pygmentsUseClasses = true
   github_repository = "https://github.com/TheThingsIndustries/lorawan-stack-docs"
   github_repository_edit = "https://github.com/TheThingsIndustries/lorawan-stack-docs/blob/master/doc/content"
   tts_github_repository = "https://github.com/TheThingsNetwork/lorawan-stack"
-  version = "3.30.1"
+  version = "3.30.2"
 
 [markup]
   [markup.goldmark]

diff --git a/doc/content/the-things-stack/host/aws/ecs/changelog/index.md b/doc/content/the-things-stack/host/aws/ecs/changelog/index.md
@@ -8,6 +8,30 @@ All meaningful changes to templates are documented in this file.
 
 ## Unreleased
 
+## 3.30.2
+
+- TimescaleDB replicas are now split to a separate template. Previously replicas had an ephemeral disk that needed to be copied when the replica was re-deployed. This made some upgrades really long to complete. Now the replicas are standalone and have their own disk that can be reattached to a new instance. This change should make upgrades faster and more reliable.
+
+### Upgrade procedure
+
+- Disable TimescaleDB replicas in the `5-4-ecs-services` template.
+- Upgrade the `2-5-db-timescale` template. This will remove TimescaleDB replicas if there were any.
+- Deploy the `2-6-db-timescale-replica` template for each replica that was removed in the previous step.
+- Re-enable TimescaleDB replicas in the `5-4-ecs-services` template.
+
+### 2-5-db-timescale
+
+- Rename to `2-5-db-timescale-master`.
+- Remove replica configuration from the template.
+
+### 2-6-db-timescale-replica
+
+- Add new optional template for TimescaleDB replica.
+
+### `4-2a-configuration`
+
+- Add configuration parameters for the UDP rate limiting firewall (`UDPRateLimitingFirewallEnabled`/`UDPRateLimitingFirewallMessages`/`UDPRateLimitingFirewallThreshold`). Environments which use the general purpose rate limiting of the Gateway Server (via `4-2b-configuration-rate-limiting`) do not need to enable this firewall.
+
 ## 3.30.1
 
 ### Proxy

diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_applications_storage_get.md b/doc/content/ttn-lw-cli/ttn-lw-cli_applications_storage_get.md
@@ -167,6 +167,7 @@ ttn-lw-cli applications storage get [application-id] [flags]
       --up.uplink-message.network-ids.tenant-id                                             select the up.uplink_message.network_ids.tenant_id field
       --up.uplink-message.normalized-payload                                                select the up.uplink_message.normalized_payload field
       --up.uplink-message.normalized-payload-warnings                                       select the up.uplink_message.normalized_payload_warnings field
+      --up.uplink-message.packet-error-rate                                                 select the up.uplink_message.packet_error_rate field
       --up.uplink-message.received-at                                                       select the up.uplink_message.received_at field
       --up.uplink-message.rx-metadata                                                       select the up.uplink_message.rx_metadata field
       --up.uplink-message.session-key-id                                                    select the up.uplink_message.session_key_id field

diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_end-devices_storage_get.md b/doc/content/ttn-lw-cli/ttn-lw-cli_end-devices_storage_get.md
@@ -170,6 +170,7 @@ ttn-lw-cli end-devices storage get [application-id] [device-id] [flags]
       --up.uplink-message.network-ids.tenant-id                                             select the up.uplink_message.network_ids.tenant_id field
       --up.uplink-message.normalized-payload                                                select the up.uplink_message.normalized_payload field
       --up.uplink-message.normalized-payload-warnings                                       select the up.uplink_message.normalized_payload_warnings field
+      --up.uplink-message.packet-error-rate                                                 select the up.uplink_message.packet_error_rate field
       --up.uplink-message.received-at                                                       select the up.uplink_message.received_at field
       --up.uplink-message.rx-metadata                                                       select the up.uplink_message.rx_metadata field
       --up.uplink-message.session-key-id                                                    select the up.uplink_message.session_key_id field

diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_simulate_application-uplink.md b/doc/content/ttn-lw-cli/ttn-lw-cli_simulate_application-uplink.md
@@ -36,6 +36,7 @@ ttn-lw-cli simulate application-uplink [application-id] [device-id] [flags]
       --network-ids.tenant-address string                                     
       --network-ids.tenant-id string                                          
       --normalized-payload-warnings strings                                   
+      --packet-error-rate float32                                             
       --received-at timestamp                                                 
       --session-key-id bytesBase64                                            
       --settings.concentrator-timestamp int                                   

diff --git a/doc/content/whats-new/3.30.2.md b/doc/content/whats-new/3.30.2.md
@@ -0,0 +1,18 @@
+---
+date: 2024-06-17T13:18:11Z
+title: "3.30.2"
+featured:
+  {
+    fixed:
+      [
+        Reconnect a gateway when the antenna gain is adjusted,
+        Increased the timeout for Basic Station gateways sending HTTP headers,
+      ],
+  }
+---
+
+### Fixed
+
+- Increased the timeout for Basic Station gateways sending HTTP headers. There should now be enough time for embedded devices with little to no hardware acceleration to perform a TLS handshake. In particular, The Things Indoor Gateway can now connect to The Things Stack presenting a ECDSA certificate.
+- Reconnect a gateway when the antenna gain is adjusted.
+- Fixed length bytes fields, such as EUIs, device addresses or device keys, are no longer considered as being all zero when provided as null values in JSON requests.
diff --git a/doc/data/api/ttn.lorawan.v3/messages/ApplicationUplink.yml b/doc/data/api/ttn.lorawan.v3/messages/ApplicationUplink.yml
@@ -103,6 +103,12 @@ fields:
     package: google.protobuf
     name: Duration
   default: 0s
+- name: packet_error_rate
+  comment: |-
+    Packet error rate of the recent uplinks in the current session.
+    Calculated by the Network Server. The value is defined in the [0, 1] interval.
+  type: float
+  default: 0
 - name: locations
   comment: End device location metadata, set by the Application Server while handling
     the message.

diff --git a/doc/data/api/ttn.lorawan.v3/services/UserBookmarkRegistry.yml b/doc/data/api/ttn.lorawan.v3/services/UserBookmarkRegistry.yml
@@ -9,7 +9,7 @@ methods:
       name: UserBookmark
     http:
     - method: POST
-      path: /users/bookmarks
+      path: /users/{user_ids.user_id}/bookmarks
   List:
     name: List
     comment: List the bookmarks for the given user.