New In Version10


Description

The v10 release brings a host of new iRules events and commands. This page is a collection of what’s new and what has changed. These commands will show up in their respective command pages as well (I.E. within the operators page or the ONECONNECT page), but this is a v10 specific list to allow you to browse what’s new.

LTM

New Events


New Commands

  • after - Allows delayed or suspended command execution, and info about delayed or suspended commands.
  • class - The handling of classes (data group lists) has been improved dramatically in v10. Refer to the wiki page for details. Note that starting in v10, data groups (classes) can no longer be accessed as a global list which will break some iRules.
  • ISESSION::deduplication - Enable or disable iSession deduplication for the current connection.
  • LB::class - Returns the traffic class of a connection
  • matches_glob - New operator to perform glob style matching in a comparison
  • members - like active_members, but counts or lists all members (IP+port) in a pool, not just active ones
  • nodes - like active_nodes, but counts or lists all nodes (IP addresses) in a pool, not just active ones
  • ONECONNECT::select - Select OneConnect keying mode
  • ONECONNECT::label - Update the OneConnect key value for a given connection
  • ROUTE::domain - Returns the routing domain ID for the current connection.
  • SSL::collect - Collect decrypted SSL payload.
  • SSL::payload - Access collected decrypted SSL payload
  • SSL::release - Stop collection of SSL payload and release collected data
  • SSL::respond - Encrypt and send a response to the client
  • translate - Enables, disables, or queries destination or port translation on a connection.

Other new additions

  • static - Read-only global variables. Allows global variables to be used on CMP-enabled virtual servers
  • tcl_platform - Returns the version number of BIG-IP.

Changes to Existing Commands

  • LB::server - No longer takes “vlan” parameter, now takes “route_domain” parameter
  • ONECONNECT::reuse - Can now query the current reuse mode by specifying no parameter
  • CACHE::payload - Now has an optional offset parameter to specify the offset at which data is returned
  • HTTP::payload - Now has an optional offset parameter to specify the offset at which data is returned
  • RTSP::payload - Now has an optional offset parameter to specify the offset at which data is returned
  • SCTP::payload - Now has an optional offset parameter to specify the offset at which data is returned
  • TCP::payload - Now has an optional offset parameter to specify the offset at which data is returned
  • UDP::payload - Now has an optional offset parameter to specify the offset at which data is returned

New Behavior

Commands that can suspend execution (SOL12962) may be problematic with packet payloads. In particular, data may be added to the collected payload while an iRule is suspended. As a result, if you inspect the collected payload and then run a (e.g.) persist command, the payload could contain more data than it did before you ran the persist command. This issue is being tracked by Product Development as CR110761 and is scheduled to be fixed in an upcoming release.
Classes (data groups) used to be accessible as a global TCL list. Starting in v10, accessing a data group as a global variable ($::class_name) simply returns the name of the data group and is no longer a TCL list. You must now use the “class” command for all data group access.

GTM

New Commands

  • whoami - Returns the server name for the local GTM.
  • whereami - Returns the datacenter name for the local GTM.
  • uptime - Returns the number of seconds the local GTM has been up.
  • members - Returns the number or list of pool members in the specified state. If you do not specify a state, returns all pool members
  • pools - Returns the number of pools or a list of pools in the wideIP that are in the specified state. If you do not specify a state, returns all pools.
  • persist - Returns the persistence state value, when enabled. If you specify arguments, returns the previous state value.
  • nodes_up - Returns the number of up nodes behind a virtual server. LTM virtual servers can have a pool with multiple nodes. If there is not a monitor on the LTM side, the server is blue. However, the GTM interprets this blue virtual server as green, and the nodes_up value is 1.

The BIG-IP API Reference documentation contains community-contributed content. F5 does not monitor or control community code contributions. We make no guarantees or warranties regarding the available code, and it may contain errors, defects, bugs, inaccuracies, or security vulnerabilities. Your access to and use of any code available in the BIG-IP API reference guides is solely at your own risk.