F5BigDnsxGlobalOptions

Overview

The F5BigDnsxGlobalOptions Custom Resource (CR) contains optional settings that allow ‌users to enable non-standard behaviors or features. By default, these non-standard behaviors and features are set to default values in the global settings and these values may need to be enabled for some use cases. If a user has to change these non-standard optional behaviors or features, they must understand and acknowledge the consequences before changing the global settings from their default values.

CR Parameters

The following table lists and describes the F5BigDnsxGlobalOptions CR parameters.

Metadata

Parameter	Description
name	Specifies the name of the nameserver.

spec

Parameter	Description
rrsetRotate	Controls rrset rotate. The value can be none, tmid, or random (default).
includeDs	Controls inclusion of DS RR despite lack of RRSIG. The value can be True or False (default).
minimalResponse	Controls inclusion of extra RRs in Auth/Add sections. The value can be True or False (default).
dbWriteNsd	Controls writing of NSD style db file. The value can be True or False (default).
dbWriteDelay	Specifies the time to delay (seconds) after receiving the changes and before writing out the database. The range is between 15 and 4294967295 with a default value as 15 seconds.
rrPerZoneStats	Specifies the per-zone query statistics collected (in rapid response mode) in exchange for a performance penalty. The value can be True (default) or False.
rrTcpClose	Specifies the handling of TCP requests in rapid response mode close. The value can be client, server (default), or reset. For client - Allows the client to close the connection and respond with FIN/ACK. For server - FIN the connection with the response and respond to client FIN with ACK. For reset - FIN the connection with the response and respond to the client FIN with RST.
rpzUpdateTime	Specifies the time of day to update the tmm db if an Response Policy Zone (RPZ) zone has received an update. The value ranges from 0 to 86400. Value 0 (default): Represents an unset value Non-zero to 0 transition: If the value changes from non-zero to zero, and a timer is active, the system will trigger an immediate update (dump) of the RPZ data.
xfrJitter	Controls zone transfer period jitter. The value can be True (default) or False.
xfrPendingMax	Maximum number of outstanding zone transfers. The range is from 1 to 16384, with a default value of 100.
xfrNotifyDelay	Specifies the time (in seconds) to delay upon receiving an Notify before queueing an [AI]XFR. The range is from 0 to 4294967295 with a default value as 5.
maxNotifyPerSec	Specifies the maximum number of notifications to process per second. The value range is from 0 (default) to 4294967295.
dumpAsText	Enables the Zoned Transfer Daemon (zxfrd) to dump zone contents when saving the db, and dump all Zone Transfer (XFR) requests and responses in text format to standard error (stderr). When the zxfrd is turned on, it consumes a lot of CPU, memory and disk resources. The value can be True or False (default).
xfrTimeout	Specifies the Timeout of idle DNS Express zone transfers. The range is from 5 to 60 with a default value as 1.

CR Example

Following is an example F5BigDnsxGlobalOptions CR:

cat dnsx-global-option.yaml
apiVersion: k8s.f5net.com/v1
kind: F5BigDnsxGlobalOptions
metadata:
  name: globaloptions
  namespace: default
spec:
  minimalResponse: true
  dumpAsText: true
  xfrNotifyDelay: 300

Requirements

Ensure you have:

• Installed the CNF Controller Pods.
• A Linux based workstation.

Installation

1. To apply the Dns Express Globaloptions CR, copy the following example into a YAML file:

   apiVersion: k8s.f5net.com/v1
   kind: F5BigDnsxGlobalOptions
   metadata:
     name: globaloptions
     namespace: default
   spec:
     minimalResponse: true
     dumpAsText: true
     xfrNotifyDelay: 300
   

2. Install the Dnsx Global options F5BigDnsxGlobalOptions CR:

   oc apply -f dnsx-global-option.yaml
   

   Sample output

   f5bigdnsxglobaloptions.k8s.f5net.com/globaloptions created
   

   Sample logs

   The BIG-IP Controller logs indicate that the CrName globaloptions is Adding or Updating.

   "ts"="2025-02-25 09:27:01.147"|"l"="info"|"m"="Adding or Updating"|"lt"="A"|"CrKind"=""|"AppNS"="default"|"CrName"="globaloptions"|"pod"="cnf-f5ingress-5b9b7c4dd8-zls84"|"ct"="f5-controller"|"cv"="v0.694.0"|"ns"="default"|"v"="1.0"
   
   
   oc get f5bigdnsxglobaloptions.k8s.f5net.com/globaloptions
   NAME            READY   MESSAGE                                AGE
   globaloptions   True    CR config sent to all grpc endpoints   3m1s
   

Feedback

To provide feedback and help improve this document, please email us at cnfdocs@f5.com.