Skip to content

Commit 4f65962

Browse files
authored
TASK-91082: Announce dnsbuf module deprecation (#807)
1 parent bbcfb04 commit 4f65962

File tree

2 files changed

+12
-6
lines changed

2 files changed

+12
-6
lines changed

content/momentum/3/3-reference/3-reference-modules-dnsbuf.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,9 @@ description: "Configuration Change This feature is available as beta in Momentum
66

77
<a name="idp19364064"></a>
88

9-
**Configuration Change. ** This feature is available as beta in Momentum 3.6.5.
9+
**Configuration Change.** This feature is available as beta in Momentum 3.6.5.
10+
11+
> **NOTE: This feature was DEPRECATED in Momentum 4.8 and is no longer supported.**
1012
1113
Momentum does not manipulate the size of UDP sockets it creates and uses for DNS queries; instead, it will use the default sizes configured by the Operating System. This can create problems for clients with too many domains (e.g., tens of thousands) in the system. Responses may be dropped, causing unnecessary DNS failures and retries, thus further increasing the DNS query volume. The `dnsbuf` module enables the client to manipulate the DNS buffer sizes on demand, on the fly.
1214

@@ -150,4 +152,4 @@ The following is an example in which Momentum started with ~30,000 unresolvable
150152
DNS AAAA Queries: 0
151153
DNS MX Queries: 908388
152154
Pending DNS Queries: 311
153-
```
155+
```

content/momentum/4/modules/dnsbuf.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,9 @@ description: "Configuration Change This feature is available in Momentum 4 2 and
66

77
<a name="idp21140416"></a>
88

9-
**Configuration Change. ** This feature is available in Momentum 4.2 and later.
9+
**Configuration Change.** This feature is available from Momentum 4.2 through 4.7.
10+
11+
> **NOTE: This feature was DEPRECATED in Momentum 4.8 and is no longer supported.**
1012
1113
Momentum does not manipulate the size of UDP sockets it creates and uses for DNS queries; instead, it will use the default sizes configured by the Operating System. This can create problems for clients with too many domains (e.g., tens of thousands) in the system. Responses may be dropped, causing unnecessary DNS failures and retries, thus further increasing the DNS query volume. The `dnsbuf` module enables the client to manipulate the DNS buffer sizes on demand, on the fly.
1214

@@ -19,8 +21,8 @@ The `dnsbuf` module is configured as follows:
1921

2022
```
2123
dnsbuf {
22-
sndbuf_size = "65536" # Default value is 131072
23-
rcvbuf_size = "65536" # Default value is 131072
24+
sndbuf_size = "65536" # In Linux this is set to 131072
25+
rcvbuf_size = "65536" # In Linux this is set to 131072
2426
interval = "30" # Default value is 60 seconds
2527
}
2628
```
@@ -130,6 +132,8 @@ while sleep 1; do (netstat --udp -s | grep error; echo summary |
130132
/opt/msys/ecelerity/bin/ec_console | grep DNS); echo; done
131133
```
132134
135+
> **NOTE:** Whenever possible, prefer to use the [HTTP-API statistics](/momentum/4/http-api-stats/summary) instead of the `summary` command for performance reasons.
136+
133137
The following is an example in which Momentum started with ~30,000 unresolvable domains in the queue. Notice that the "packet receive errors" number has increased, and there are a high number of pending DNS queries.
134138
135139
```
@@ -150,4 +154,4 @@ The following is an example in which Momentum started with ~30,000 unresolvable
150154
DNS AAAA Queries: 0
151155
DNS MX Queries: 908388
152156
Pending DNS Queries: 311
153-
```
157+
```

0 commit comments

Comments
 (0)