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¶
- CLIENTSSL_DATA - Similar to CLIENT_DATA, but for decrypted SSL payloads. Use with SSL::collect
- SERVERSSL_DATA - Similar to SERVER_DATA, but for decrypted SSL payloads. Use with SSL::collect
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.