Skip to content

Change port number for cross gateway transmission #673

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
CritasWang merged 2 commits into from
Mar 28, 2025
Merged

Change port number for cross gateway transmission #673

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8572fd1
Change port number for cross gateway transmission
W1y1r Mar 27, 2025
5f693a7
Supporting gateway models requires modification of description inform…
W1y1r Mar 27, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added src/.vuepress/public/img/cross-network-gateway.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
16 changes: 15 additions & 1 deletion src/UserGuide/Master/Table/User-Manual/Data-Sync_timecho.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -373,7 +373,7 @@ WITH SINK (

This example demonstrates synchronizing data from one IoTDB to another through a unidirectional air gap. The data pipeline is shown below:

![](/img/e5.png)
![](/img/cross-network-gateway.png)

In this example, the `iotdb-air-gap-sink` plugin is used (currently supports specific air gap models; contact Timecho team for details). After configuring the air gap, execute the following statement on IoTDB A, where `node-urls` is the URL of the DataNode service port on the target IoTDB.

Expand All @@ -386,6 +386,19 @@ WITH SINK (
'node-urls' = '10.53.53.53:9780' -- URL of the DataNode service port on the target IoTDB
)
```
**Notes: Currently supported gateway models**
> For other models of network gateway devices, Please contact timechodb staff to confirm compatibility.

| Gateway Type | Model | Return Packet Limit | Send Limit |
| ---------------------- | ------------------------------------------------------------ | ------------------- | ---------------------- |
| Forward Gate | NARI Syskeeper-2000 Forward Gate | All 0 / All 1 bytes | No Limit |
| Forward Gate | XJ Self-developed Diaphragm | All 0 / All 1 bytes | No Limit |
| Unknown | WISGAP | No Limit | No Limit |
| Forward Gate | KEDONG StoneWall-2000 Network Security Isolation Device | No Limit | No Limit |
| Reverse Gate | NARI Syskeeper-2000 Reverse Direction | All 0 / All 1 bytes | Meet E Language Format |
| Unknown | DPtech ISG5000 | No Limit | No Limit |
| Unknown | GAP‌‌
XL—GAP | No Limit | No Limit |

### 3.7 Compressed Synchronization

Expand All @@ -402,6 +415,7 @@ WITH SINK (
)
```


### 3.8 Encrypted Synchronization

IoTDB supports SSL encryption during synchronization to securely transmit data between IoTDB instances. By configuring SSL-related parameters such as the certificate path (`ssl.trust-store-path`) and password (`ssl.trust-store-pwd`), data can be protected by SSL encryption during synchronization.
Expand Down
3 changes: 2 additions & 1 deletion src/UserGuide/Master/Tree/User-Manual/Data-Sync_timecho.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -433,7 +433,7 @@ with sink (

This example is used to demonstrate the scenario where data from one IoTDB is synchronized to another IoTDB through a unidirectional gateway, as shown in the figure below:

![](/img/pipe5.jpg)
![](/img/cross-network-gateway.png)


In this example, the iotdb-air-gap-sink plugin in the sink task needs to be used . After configuring the gateway, execute the following statement on A IoTDB. Fill in the node-urls with the URL of the data service port of the DataNode node on the target IoTDB configured by the gateway, as detailed below:
Expand All @@ -445,6 +445,7 @@ with sink (
'node-urls' = '10.53.53.53:9780', -- The URL of the data service port of the DataNode node on the target IoTDB
```
**Notes: Currently supported gateway models**
> For other models of network gateway devices, Please contact timechodb staff to confirm compatibility.

| Gateway Type | Model | Return Packet Limit | Send Limit |
| ---------------------- | ------------------------------------------------------------ | ------------------- | ---------------------- |
Expand Down
2 changes: 1 addition & 1 deletion src/UserGuide/V1.3.x/User-Manual/Data-Sync-old_timecho.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -436,7 +436,7 @@ with sink (

This example is used to demonstrate the scenario where data from one IoTDB is synchronized to another IoTDB through a unidirectional gateway, as shown in the figure below:

![](/img/pipe5.jpg)
![](/img/cross-network-gateway.png)


In this example, the iotdb-air-gap-sink plugin in the sink task needs to be used (currently supports some gateway models, for specific models, please contact Timecho staff for confirmation). After configuring the gateway, execute the following statement on A IoTDB. Fill in the node-urls with the URL of the data service port of the DataNode node on the target IoTDB configured by the gateway, as detailed below:
Expand Down
3 changes: 2 additions & 1 deletion src/UserGuide/V1.3.x/User-Manual/Data-Sync_timecho.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -433,7 +433,7 @@ with sink (

This example is used to demonstrate the scenario where data from one IoTDB is synchronized to another IoTDB through a unidirectional gateway, as shown in the figure below:

![](/img/pipe5.jpg)
![](/img/cross-network-gateway.png)


In this example, the iotdb-air-gap-sink plugin in the sink task needs to be used . After configuring the gateway, execute the following statement on A IoTDB. Fill in the node-urls with the URL of the data service port of the DataNode node on the target IoTDB configured by the gateway, as detailed below:
Expand All @@ -445,6 +445,7 @@ with sink (
'node-urls' = '10.53.53.53:9780', -- The URL of the data service port of the DataNode node on the target IoTDB
```
**Notes: Currently supported gateway models**
> For other models of network gateway devices, Please contact timechodb staff to confirm compatibility.

| Gateway Type | Model | Return Packet Limit | Send Limit |
| ---------------------- | ------------------------------------------------------------ | ------------------- | ---------------------- |
Expand Down
3 changes: 2 additions & 1 deletion src/UserGuide/dev-1.3/User-Manual/Data-Sync_timecho.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -433,7 +433,7 @@ with sink (

This example is used to demonstrate the scenario where data from one IoTDB is synchronized to another IoTDB through a unidirectional gateway, as shown in the figure below:

![](/img/pipe5.jpg)
![](/img/cross-network-gateway.png)


In this example, the iotdb-air-gap-sink plugin in the sink task needs to be used . After configuring the gateway, execute the following statement on A IoTDB. Fill in the node-urls with the URL of the data service port of the DataNode node on the target IoTDB configured by the gateway, as detailed below:
Expand All @@ -445,6 +445,7 @@ with sink (
'node-urls' = '10.53.53.53:9780', -- The URL of the data service port of the DataNode node on the target IoTDB
```
**Notes: Currently supported gateway models**
> For other models of network gateway devices, Please contact timechodb staff to confirm compatibility.

| Gateway Type | Model | Return Packet Limit | Send Limit |
| ---------------------- | ------------------------------------------------------------ | ------------------- | ---------------------- |
Expand Down
16 changes: 15 additions & 1 deletion src/UserGuide/latest-Table/User-Manual/Data-Sync_timecho.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -373,7 +373,7 @@ WITH SINK (

This example demonstrates synchronizing data from one IoTDB to another through a unidirectional air gap. The data pipeline is shown below:

![](/img/e5.png)
![](/img/cross-network-gateway.png)

In this example, the `iotdb-air-gap-sink` plugin is used (currently supports specific air gap models; contact Timecho team for details). After configuring the air gap, execute the following statement on IoTDB A, where `node-urls` is the URL of the DataNode service port on the target IoTDB.

Expand All @@ -387,6 +387,20 @@ WITH SINK (
)
```

**Notes: Currently supported gateway models**
> For other models of network gateway devices, Please contact timechodb staff to confirm compatibility.

| Gateway Type | Model | Return Packet Limit | Send Limit |
| ---------------------- | ------------------------------------------------------------ | ------------------- | ---------------------- |
| Forward Gate | NARI Syskeeper-2000 Forward Gate | All 0 / All 1 bytes | No Limit |
| Forward Gate | XJ Self-developed Diaphragm | All 0 / All 1 bytes | No Limit |
| Unknown | WISGAP | No Limit | No Limit |
| Forward Gate | KEDONG StoneWall-2000 Network Security Isolation Device | No Limit | No Limit |
| Reverse Gate | NARI Syskeeper-2000 Reverse Direction | All 0 / All 1 bytes | Meet E Language Format |
| Unknown | DPtech ISG5000 | No Limit | No Limit |
| Unknown | GAP‌‌
XL—GAP | No Limit | No Limit |

### 3.7 Compressed Synchronization

IoTDB supports specifying data compression methods during synchronization. The `compressor` parameter can be configured to enable real-time data compression and transmission. Supported algorithms include `snappy`, `gzip`, `lz4`, `zstd`, and `lzma2`. Multiple algorithms can be combined and applied in the configured order. The `rate-limit-bytes-per-second` parameter (supported in V1.3.3 and later) limits the maximum number of bytes transmitted per second (calculated after compression). If set to a value less than 0, there is no limit.
Expand Down
3 changes: 2 additions & 1 deletion src/UserGuide/latest/User-Manual/Data-Sync_timecho.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -433,7 +433,7 @@ with sink (

This example is used to demonstrate the scenario where data from one IoTDB is synchronized to another IoTDB through a unidirectional gateway, as shown in the figure below:

![](/img/pipe5.jpg)
![](/img/cross-network-gateway.png)


In this example, the iotdb-air-gap-sink plugin in the sink task needs to be used . After configuring the gateway, execute the following statement on A IoTDB. Fill in the node-urls with the URL of the data service port of the DataNode node on the target IoTDB configured by the gateway, as detailed below:
Expand All @@ -445,6 +445,7 @@ with sink (
'node-urls' = '10.53.53.53:9780', -- The URL of the data service port of the DataNode node on the target IoTDB
```
**Notes: Currently supported gateway models**
> For other models of network gateway devices, Please contact timechodb staff to confirm compatibility.

| Gateway Type | Model | Return Packet Limit | Send Limit |
| ---------------------- | ------------------------------------------------------------ | ------------------- | ---------------------- |
Expand Down
3 changes: 2 additions & 1 deletion src/zh/UserGuide/Master/Table/User-Manual/Data-Sync_timecho.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -371,7 +371,7 @@ with sink (

本例子用来演示将一个 IoTDB 的数据，经过单向网闸，同步至另一个 IoTDB 的场景，数据链路如下图所示：

![](/img/%E6%95%B0%E6%8D%AE%E4%BC%A0%E8%BE%931.png)
![](/img/cross-network-gateway.png)

在这个例子中，需要使用 sink 任务中的 iotdb-air-gap-sink 插件，配置网闸后，在 A IoTDB 上执行下列语句，其中 node-urls 填写网闸配置的目标端 IoTDB 中 DataNode 节点的数据服务端口的 url，详细语句如下：

Expand All @@ -383,6 +383,7 @@ with sink (
)
```
**注意：目前支持的网闸型号**
> 其他型号的网闸设备，请与天谋商务联系确认是否支持。

| 网闸类型 | 网闸型号 | 回包限制 | 发送限制 |
| ------------ | -------------------------------------------- | ----------------- | --------------- |
Expand Down
3 changes: 2 additions & 1 deletion src/zh/UserGuide/Master/Tree/User-Manual/Data-Sync_timecho.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -429,7 +429,7 @@ with sink (

本例子用来演示将一个 IoTDB 的数据，经过单向网闸，同步至另一个 IoTDB 的场景，数据链路如下图所示：

![](/img/%E6%95%B0%E6%8D%AE%E4%BC%A0%E8%BE%931.png)
![](/img/cross-network-gateway.png)

在这个例子中，需要使用 sink 任务中的 iotdb-air-gap-sink 插件，配置网闸后，在 A IoTDB 上执行下列语句，其中 node-urls 填写网闸配置的目标端 IoTDB 中 DataNode 节点的数据服务端口的 url，详细语句如下：

Expand All @@ -441,6 +441,7 @@ with sink (
)
```
**注意：目前支持的网闸型号**
> 其他型号的网闸设备，请与天谋商务联系确认是否支持。

| 网闸类型 | 网闸型号 | 回包限制 | 发送限制 |
| ------------ | -------------------------------------------- | ----------------- | --------------- |
Expand Down
2 changes: 1 addition & 1 deletion src/zh/UserGuide/V1.2.x/User-Manual/Data-Sync_timecho.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -279,7 +279,7 @@ with connector (

本例子用来演示将一个 IoTDB 的数据，经过单向网闸，同步至另一个IoTDB的场景，数据链路如下图所示：

![](/img/%E6%95%B0%E6%8D%AE%E4%BC%A0%E8%BE%931.png)
![](/img/cross-network-gateway.png)

在这个例子中，需要使用 connector 任务中的iotdb-air-gap-connector 插件（目前支持部分型号网闸，具体型号请联系天谋科技工作人员确认），配置网闸后，在 A IoTDB 上执行下列语句，其中ip和port填写网闸信息，详细语句如下：

Expand Down
2 changes: 1 addition & 1 deletion src/zh/UserGuide/V1.3.x/User-Manual/Data-Sync-old_timecho.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -431,7 +431,7 @@ with sink (

本例子用来演示将一个 IoTDB 的数据，经过单向网闸，同步至另一个 IoTDB 的场景，数据链路如下图所示：

![](/img/%E6%95%B0%E6%8D%AE%E4%BC%A0%E8%BE%931.png)
![](/img/cross-network-gateway.png)

在这个例子中，需要使用 sink 任务中的 iotdb-air-gap-sink 插件（目前支持部分型号网闸，具体型号请联系天谋科技工作人员确认），配置网闸后，在 A IoTDB 上执行下列语句，其中 node-urls 填写网闸配置的目标端 IoTDB 中 DataNode 节点的数据服务端口的 url，详细语句如下：

Expand Down
3 changes: 2 additions & 1 deletion src/zh/UserGuide/V1.3.x/User-Manual/Data-Sync_timecho.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -429,7 +429,7 @@ with sink (

本例子用来演示将一个 IoTDB 的数据，经过单向网闸，同步至另一个 IoTDB 的场景，数据链路如下图所示：

![](/img/%E6%95%B0%E6%8D%AE%E4%BC%A0%E8%BE%931.png)
![](/img/cross-network-gateway.png)

在这个例子中，需要使用 sink 任务中的 iotdb-air-gap-sink 插件，配置网闸后，在 A IoTDB 上执行下列语句，其中 node-urls 填写网闸配置的目标端 IoTDB 中 DataNode 节点的数据服务端口的 url，详细语句如下：

Expand All @@ -441,6 +441,7 @@ with sink (
)
```
**注意：目前支持的网闸型号**
> 其他型号的网闸设备，请与天谋商务联系确认是否支持。

| 网闸类型 | 网闸型号 | 回包限制 | 发送限制 |
| ------------ | -------------------------------------------- | ----------------- | --------------- |
Expand Down
4 changes: 3 additions & 1 deletion src/zh/UserGuide/dev-1.3/User-Manual/Data-Sync_timecho.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -429,7 +429,7 @@ with sink (

本例子用来演示将一个 IoTDB 的数据，经过单向网闸，同步至另一个 IoTDB 的场景，数据链路如下图所示：

![](/img/%E6%95%B0%E6%8D%AE%E4%BC%A0%E8%BE%931.png)
![](/img/cross-network-gateway.png)

在这个例子中，需要使用 sink 任务中的 iotdb-air-gap-sink 插件，配置网闸后，在 A IoTDB 上执行下列语句，其中 node-urls 填写网闸配置的目标端 IoTDB 中 DataNode 节点的数据服务端口的 url，详细语句如下：

Expand All @@ -442,6 +442,8 @@ with sink (
```
**注意：目前支持的网闸型号**

> 其他型号的网闸设备，请与天谋商务联系确认是否支持。

| 网闸类型 | 网闸型号 | 回包限制 | 发送限制 |
| ------------ | -------------------------------------------- | ----------------- | --------------- |
| 正向型 | 南瑞 Syskeeper-2000 正向型 | 全 0 / 全 1 bytes | 无限制 |
Expand Down
3 changes: 2 additions & 1 deletion src/zh/UserGuide/latest-Table/User-Manual/Data-Sync_timecho.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -371,7 +371,7 @@ with sink (

本例子用来演示将一个 IoTDB 的数据，经过单向网闸，同步至另一个 IoTDB 的场景，数据链路如下图所示：

![](/img/%E6%95%B0%E6%8D%AE%E4%BC%A0%E8%BE%931.png)
![](/img/cross-network-gateway.png)

在这个例子中，需要使用 sink 任务中的 iotdb-air-gap-sink 插件，配置网闸后，在 A IoTDB 上执行下列语句，其中 node-urls 填写网闸配置的目标端 IoTDB 中 DataNode 节点的数据服务端口的 url，详细语句如下：

Expand All @@ -383,6 +383,7 @@ with sink (
)
```
**注意：目前支持的网闸型号**
> 其他型号的网闸设备，请与天谋商务联系确认是否支持。

| 网闸类型 | 网闸型号 | 回包限制 | 发送限制 |
| ------------ | -------------------------------------------- | ----------------- | --------------- |
Expand Down
3 changes: 2 additions & 1 deletion src/zh/UserGuide/latest/User-Manual/Data-Sync_timecho.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -429,7 +429,7 @@ with sink (

本例子用来演示将一个 IoTDB 的数据，经过单向网闸，同步至另一个 IoTDB 的场景，数据链路如下图所示：

![](/img/%E6%95%B0%E6%8D%AE%E4%BC%A0%E8%BE%931.png)
![](/img/cross-network-gateway.png)

在这个例子中，需要使用 sink 任务中的 iotdb-air-gap-sink 插件，配置网闸后，在 A IoTDB 上执行下列语句，其中 node-urls 填写网闸配置的目标端 IoTDB 中 DataNode 节点的数据服务端口的 url，详细语句如下：

Expand All @@ -441,6 +441,7 @@ with sink (
)
```
**注意：目前支持的网闸型号**
> 其他型号的网闸设备，请与天谋商务联系确认是否支持。

| 网闸类型 | 网闸型号 | 回包限制 | 发送限制 |
| ------------ | -------------------------------------------- | ----------------- | --------------- |
Expand Down