Config command, bigpipe

From RZWiki

A CLI command available on F5 Networks BigIP platforms; used to install, check and save configuration on the device itself, display configuration synchronisation status and synchronise configurations between two devices in a high availability (HA) pair.

Usage Syntax

noinclude/noinclude

bigpipe config font color=deepskyblueoptions/font [font color=darkorangefilename/font | font color=deepskyblueall/font]

Common options include;

• font color=deepskybluesave/font font color=darkorangefilename/font - save the current running configuration to the specified filename
• font color=deepskyblueinstall/font font color=darkorangefilename/font - replace the current running configuration with the configuration contained in the configuration file specified
• font color=deepskybluesync [all]/font - synchronise the current running configuration to the peer device
• font color=deepskybluesync pull/font - synchronise the current running configuration from the peer device
• font color=deepskybluesync show/font - display current configuration synchronisation status
• font color=deepskybluecheck [all]/font - perform a syntax check of the current startup configuration

Usage Examples

bigpipe config font color=deepskybluesave/font font color=darkorange/config.ucs/font - Save the current running LTM configuration to file config.ucs on the root of the file system as well as to /config/bigip.conf and saves the base configuration to file /config/bigip_base.conf

bigpipe config font color=deepskybluesync all/font - Synchronises the current running configuration to the other device in a redundant pair

bigpipe config font color=deepskybluesync show/font - Displays configuration synchronisation status and details of the latest configuration change

bigpipe config font color=deepskybluesave all/font - Save the current running configuration to file /config/bigip.conf and the base configuration to file /config/bigip_base.conf - note this option is only available in older software versions and has been superseded by the bigpipe save command

Usage Notes

The save all option is only available in older software versions and has been superseded by the bigpipe save command

The all keyword is optional

The sync and sync pull options will save the current running configuration to either a backup file or the startup configuration file (depending on the type of sync operation) prior to performing any configuration synchronisation operations

Configuration archives created in the GUI are located in var/local/ucs/

What Is Not Synchronised?

The following configuration settings and objects are not synchronised by the config sync feature;

• VLANs
  • MAC Masquerade
• Non-floating Self IP addresses

Typical Output

noinclude/noinclude

bigpipe config sync show;

CONFIG SYNC STATUS --
    Status 0 - Synchronized
    Last change (Self) 2008-03-11 18:21:35
    Last change (Peer) 2008-03-11 18:21:38
    Last Configsync 2008-03-11 18:21:38

b config sync;

Synchronizing Master Keys...Cannot fetch unit certificate from peer

Saving active configuration...
Configsync Mode: Push
Transferring UCS to peer...
Installing UCS on peer...
Obtaining results of remote configuration installation...
Saving active configuration...
Current configuration backed up to /var/local/ucs/cs_backup.ucs.
Hostname of UCS file is testlb1.networkstuff.eu, local hostname is testlb2.networkstuff.eu
Installing shared configuration on host testlb2.networkstuff.eu
Installing...
Reloading configuration... It may take a few minutes...
Reading configuration from /defaults/config_base.conf.
Reading configuration from /config/bigip_base.conf.
Reading configuration from /config/bigip_sys.conf.
Reading configuration from /usr/bin/monitors/builtins/base_monitors.conf.
Reading configuration from /config/profile_base.conf.
Reading configuration from /config/daemon.conf.
Reading configuration from /config/bigip.conf.
Reading configuration from /config/bigip_local.conf.
Loading the configuration ...

Bigpipe Usage Notes

font color=redFrom v9.4, be aware of the administrative partition that is currently active;/font use the bigpipe shell partition command to display the current active partition name and the bigpipe shell partition name command to change partitions.

A full command manual can be displayed using the man command followed by the command name, for example: man pool or by suffixing the command name with the help keyword, for example; bigpipe pool help.

In most cases, the font color=purpleshow/font keyword displays object status or statistics and the font color=purplelist/font keyword displays configuration. URemember/U, from v9.4, only objects in the currently active administrative partition will be displayed.

The bigpipe command can be abbreviated to just b (e.g. b help instead of bigpipe help.) Alternatively, (from v9.4,) you can use the bigpipe shell to enter commands without prefixing them with bigpipe.

Where curly or normal brackets {}' or () or quotes ' or exclamation mark ! are required as part of a command and you are not using the bigpipe shell, they must be proceeded with a back slash \ to prevent the BASH shell from parsing them as system commands.

font color=redDon't forget to save your changes using the bigpipe save all command as necessary./font noinclude/noinclude

Related Commands

Use the bigpipe configsync command to actually configure the configsync feature.

The bigpipe save command should be used to save the running configuration to the device's local configuration files.

The bigpipe export command is used to save the LTM and operating system configuration to a flat text file.

Related Articles

For further information on device file locations see the File locations, F5 BigIP article.

For further information on configuration file contents see the Configuration Files In Detail article.

Information on other F5 BigIP commands

Information on Linux commands

Information on Cisco commands

Information on Vyatta commands

Information on Force10 commands

Information on Arista commands

Information on Extreme commands

Information on Nortel commands

Information on Zebra commands

Information on Windows commands

Information on Secure Platform commands

Information on Blue Coat SGOS commands

Information on Nokia IPSO commands

We really do appreciate all feedback so please do send your comments, suggestions or corrections to sjiveson#routerzone.eu (replacing the # with an @)