Manual Chapter : BIG-IP Reference guide v3.3: BIG/db Configuration Keys

Applies To:

Show Versions Show Versions

BIG-IP versions 1.x - 4.x

  • 3.3.1 PTF-06, 3.3.1 PTF-05, 3.3.1 PTF-04, 3.3.1 PTF-03, 3.3.1 PTF-02, 3.3.1 PTF-01, 3.3.1, 3.3.0
Manual Chapter


8

BIG/db Configuration Keys



Supported BIG/db configuration keys

The BIG/db is a database that contains configuration elements for the BIG-IP Controller. Currently, the following configuration options are supported by BIG/db:

  • Fail-over
  • State mirroring
  • Gateway pingers
  • Configuration synchronization
  • Interface related settings

    The BIG/db keys for each of these features are described in the following series of tables.

Using the Failover and Cluster keys

The switch-over daemon (sod) uses all .Failover keys (Table 8.1). The sod and the mirroring daemon (sfd) use all .Cluster keys. If you change one of these values, you must update the BIG-IP Controller configuration with the bigpipe failover init command. This command forces sod to reread the BIG/db database and use the new values. To run this command, type the following:

bigpipe failover init

For more information about sod, see sod, on page 7-2.

The BIG/db keys that store fail-over information
Fail-Over Key Name Description
Common.Bigip.Failover.AwaitPeerAliveDelay Delay in seconds before testing whether peer is active. The default value is 2.
Common.Bigip.Failover.AwaitPeerDeadDelay Delay in seconds before testing whether the peer has failed. The default value is 1.
Local.Bigip.Failover.UnitId This key is required. Each controller must have a unique unit ID of 1 or 2 in the event that network communication is not possible with its peer.
Common.Bigip.Failover.ActiveMode Use active-active mode if set to 1. By default, this is off and active/standby mode is used.
Common.Bigip.Failover.ManFailBack If using active-active mode, the fail-over mechanism waits until receiving a command before surrendering resources to a rebooted machine.
Common.Bigip.Failover.NoSyncTime By default, one BIG-IP Controller synchronizes its time with the other. Set this key to 1 to turn off the time synchronization feature.
Common.Bigip.Failover.DbgFile File into which sod logs the fail-over debug information.
Common.Bigip.Failover.PrintPeerState The default value for this key is 0. Fail-over daemon (/sbin/sod) writes the state of its connection to its peer, hardwire and/or network. This information is written to the fail-over daemon's debug log file.
Common.Sys.Failover.Network Use the network (via the sfd) as a backup to, or instead of, the serial line for fail-over if this value is 1. By default, this feature is off.
Common.Bigip.Cluster.ActiveKeepAliveSec The default value for this key is 0. An active unit sends a heartbeat message to its peer with this frequency. Default is 1 second.
Common.Bigip.Cluster.StandbyTimeoutSec Consider the peer BIG-IP Controller failed if no message is receied within the timeout period. Used by network fail-over. Default is 3 seconds.

Using StateMirror keys

The mirroring daemon (sfd) uses all StateMirror keys (Table 8.2). If you change one of these values, you must reboot the BIG-IP Controller to load the new configuration and restart the sfd.

The BIG/db keys that store state mirroring information
State Mirroring Key Name Description
Common.Bigip.StateMirror.DbgFile File into which debug information is written, required if debug level is specified (below).
Common.Bigip.StateMirror.DbgLevel The debug level is composed of the following options: 1 - log reads and writes 2 - log connection attempts and results 4 - log state changes 8 - open log files in append mode, the default is to truncate the files when opening. The debug level is zero by default.
Common.Bigip.StateMirror.NoGC By default, state mirroring causes mirrored data structures to be deleted when it receives a new connection. This key is brought up to date by the controller's peer. This can cause a delay if the system is absolutely loaded. Turning off the GC is provided as an option.
Common.Bigip.StateMirror.ActiveFile Enables writing of data from the active unit's kernel into the ActiveFile file. This data file can be read with the sfread program.
Common.Bigip.StateMirror.StandbyFile Enables writing of standby data into the StandBy file. This data file can be read with the sfread program.
Common.Bigip.StateMirror.PeerListenPort Port on which the BIG-IP Controller listens for connections from the active unit. Default is 1028.
Local.Bigip.StateMirror.Ipaddr IP address of this BIG-IP Controller.
Local.Bigip.StateMirror.PeerIpaddr IP address of this BIG-IP Controller's peer controller. A value is required.

Using Gateway Pinger keys

The following table lists the Gateway Pinger keys.

The BIG/db keys that store gateway pinger information
Gateway Pinger Key Name Description
Local.Bigip.GatewayPinger.Ipaddr IP address or host name of the gateway router for the BIG-IP Controller
Local.Bigip.GatewayPinger.Pinginterval Ping interval of this BIG-IP Controller gateway pinger
Local.Bigip.GatewayPinger.Timeout Timeout of the BIG-IP Controller gateway pinger

Using configuration synchronization and Interface keys

The First-Time Boot utility sets the configuration syncronization and Interface keys (Table 8.4 and Table 8.5). You should not change these keys manually with bigdba.

The BIG/db keys that store configuration synchronization information.
Configuration Synchronization Key Name Description
Common.Bigip.ConfigSyncKey Used for synchronizing the configuration of two BIG-IP Controllers.
Local.Bigip.FTB.DefaultRoute
Local.Bigip.FTB.FailoverIp
Local.Bigip.FTB.FTP
Local.Bigip.FTB.FTP.allow
Local.Bigip.FTB.FTP.support Local.Bigip.FTB.HostName = bigip1
Local.Bigip.FTB.HostNumber = 1
Local.Bigip.FTB.Interfaces
Local.Bigip.FTB.IsRedundant Local.Bigip.FTB.License
Local.Bigip.FTB.Locality = domestic
Local.Bigip.FTB.Product = BIG-IP®
Local.Bigip.FTB.RootSet
Local.Bigip.FTB.RSH
Local.Bigip.FTB.RSH.allow
Local.Bigip.FTB.RSH.support
Local.Bigip.FTB.SupportEmail
Local.Bigip.FTB.SupportFax
Local.Bigip.FTB.SupportPhone
Local.Bigip.FTB.Telnet
Local.Bigip.FTB.Telnet.allow
Local.Bigip.FTB.Telnet.support = yes
Local.Bigip.FTB.TimeZone = US/Pacific
Local.Bigip.FTB.Vendor
Local.Bigip.FTB.VendorCommonName
Local.Bigip.FTB.VendorSupportIp
Local.Bigip.FTB.Version = "BIG/ip 3.2"
Local.Bigip.FTB.WebServer.Cert.City = Seattle
Local.Bigip.FTB.WebServer.Cert.Company = "Company"
Local.Bigip.FTB.WebServer.Cert.Country = US
Local.Bigip.FTB.WebServer.Cert.Division = undef
Local.Bigip.FTB.WebServer.Cert.State = WA
Local.Bigip.FTB.WebServer.Prefix = http
Local.Bigip.FTB.WebServer.ReplaceKeys = no
First-Time Boot utility fields. These fields are populated by the First-Time Boot utility. These represent a small fraction of the actual fields produced, as the rest are dynamic and dependent upon First-Time Boot utility user input such as host names and interface identifiers.
The BIG/db keys that store interface information
Interface Key Name Description
Local.Bigip.Interface.*.Name
Common.Bigip.Interface.*.Name
The interface name is used as the key for querying or modifying its attributes. The key is common by default, but can be local to accommodate redundant BIG-IP Controllers with different interface names. However, the interface names must all be local or all be common.
Common.Bigip.Interface.*.AddrList.*.Address
Common.Bigip.Interface.*.AddrList.*.Netmask
Common.Bigip.Interface.*.AddrList.*.Broadcast
Attributes of an interface's addresses. Currently, the BIG/db contains only shared IP addresses.
Common.Bigip.Interface.*.AddrList.*.Type Type is Shared or True. Shared is associated with an IP alias, True is associated with an IP address.
Common.Bigip.Interface.*.AddrList.*.UnitId Common.Bigip.Interface.*.AddrList.*.VlanTag The unit number with which the shared IP alias is associated.