ltm profile diameter
ltm profile diameter(1) BIG-IP TMSH Manual ltm profile diameter(1)
NAME
diameter - Configures a profile to manage Diameter network traffic.
MODULE
ltm profile
SYNTAX
Configure the diameter component within the ltm profile module using the syntax in the following sections.
CREATE/MODIFY
create diameter [name]
modify diameter [name]
options:
app-service [[string] | none]
connection-prime [disabled | enabled]
defaults-from [name]
description [string]
destination-realm [string]
handshake-timeout [number]
host-ip-rewrite [disabled | enabled]
max-retransmit-attempts [number]
max-watchdog-failure [number]
origin-host-to-client [string]
origin-host-to-server [string]
origin-realm-to-client [string]
origin-realm-to-server [string]
overwrite-destination-host [disabled | enabled]
parent-avp [ [number] | [string] ]
persist-avp [ [number] | [string] ]
reset-on-timeout [disabled | enabled]
retransmit-timeout [number]
watchdog-timeout [number]
mv diameter [ [[source-name] [destination-name]] | [[name] to-folder [folder-name]] | [[name...name] to-folder [folder-name]] ]
options:
to-folder
edit diameter [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
reset-stats diameter
reset-stats diameter [ [ [name] | [glob] | [regex] ] ... ]
DISPLAY
list diameter
list diameter [ [ [name] | [glob] | [regex] ] ... ]
show running-config diameter
show running-config diameter [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
one-line
partition
show diameter
show diameter [ [ [name] | [glob] | [regex] ] ... ]
options:
(default | exa | gig | kil | meg | peta | raw | tera | yotta | zetta)
field-fmt
global
DELETE
delete diameter [name]
DESCRIPTION
You can use the diameter component to configure a profile to manage Diameter network traffic.
EXAMPLES
create diameter my_diameter_profile defaults-from diameter
Creates a Diameter profile named my_diameter_profile that inherits its settings from the system default Diameter profile.
list diameter
Displays the properties of all Diameter profiles.
mv diameter /Common/my_diameter_profile to-folder /Common/my_folder
Moves a custom diameter profile named my_diameter_profile to a folder named my_folder, where my_folder has already been
created and exists within /Common.
OPTIONS
app-service
Specifies the name of the application service to which the profile belongs. The default value is none. Note: If the
strict-updates option is enabled on the application service that owns the object, you cannot modify or delete the
profile. Only the application service can modify or delete the profile.
connection-prime
When enabled, and the system receives a capabilities exchange request from the client, the system will establish
connections and perform handshaking with all the servers prior to sending the capabilities exchange answer to the
client. The default value is disabled.
defaults-from
Specifies the profile that you want to use as the parent profile. Your new profile inherits all settings and values
from the parent profile specified. The default value is diameter.
description
User defined description.
destination-realm
This attribute has been deprecated as of BIG-IP v11.3.0. Specifies the realm to which messages are routed. A value of
none indicates that the destination-realm option is disabled. The default value is none.
You can specify a fully qualified domain name as an ASCII string. For more information about this option, see RFC 3588
section 6.6.
glob Displays the items that match the glob expression. See help glob for a description of glob expression syntax.
handshake-timeout
Specifies the handshake timeout in seconds. This setting specifies the maximum number of seconds that a connection can
be idle after the capabilities exchange request was sent to the server.The default value is 10. The system will reset
the connection after it has timed out.
You can specify a numeric value in the range 0 to 4294967295. The recommended value is in the range of 5 to 30
host-ip-rewrite
When enabled and the message is a capabilities exchange request or capabilities exchange answer, rewrite the host-ip-
address attribute with the system's egress IP address. The default value is enabled.
max-retransmit-attempts
Specifies the maximum number of retransmit attempts. This setting specifies the maximum number of attempts that BIG-IP
will take to retransmit the request messages if it does not receive the corresponding answer messages. If retransmit
is unsuccessful, after maximum attempts, BIG_IP will send an error response. The default value is 1.
You can specify a numeric value in the range 0 to 4294967295. The recommended value is in the range of 1 to 10
max-watchdog-failure
Specifies the maximum number of device watchdog failures that the traffic management system can take before it tears
down the connection. After the system receives this number of device watchdog failures, it closes the connection. The
default value is 10.
You can specify a numeric value in the range 0 to 4294967295.
name Specifies a unique name for the component. This option is required for the commands create, delete, and modify.
origin-host
This attribute has been deprecated as of BIG-IP v11.3.0. Please use, origin-host-to-client or origin-host-to-server.
Specifies the origin host of BIG-IP. The origin-host is used to overwrite the server's actual origin host attribute
when it responds to the client. A value of none indicates that origin-host is disabled. The default value is none.
You can specify an ASCII string as a FQDN. See RFC 3588 section 6.3.
origin-host-to-client
Specifies the origin host to client of BIG-IP. The origin-host-to-client is used to overwrite the server's actual
origin host attribute when it responds to the client. A value of none indicates that origin-host-to-client is
disabled. The default value is none.
You can specify an ASCII string as a FQDN. See RFC 3588 section 6.3.
origin-host-to-server
Specifies the origin host to server of BIG-IP. The origin-host-to-server is used to overwrite the client's actual
origin host attribute when it responds to the server. A value of none indicates that origin-host-to-server is
disabled. The default value is none.
You can specify an ASCII string as a FQDN. See RFC 3588 section 6.3.
origin-realm
This attribute has been deprecated as of BIG-IP v11.3.0. Please use, origin-realm-to-client or origin-realm-to-server.
Specifies the origin realm of BIG-IP. The origin-realm is used to overwrite the server's actual origin realm attribute
when it responds to the client. A value of none indicates that origin-realm is disabled. The default value is none.
You can specify an ASCII string as a FQDN. See RFC 3588 section 6.4.
origin-realm-to-client
Specifies the origin realm of BIG-IP. The origin-realm-to-client is used to overwrite the server's actual origin realm
attribute when it responds to the client. A value of none indicates that origin-realm-to-client is disabled. The
default value is none.
You can specify an ASCII string as a FQDN. See RFC 3588 section 6.4.
origin-realm-to-server
Specifies the origin realm to server of BIG-IP. The origin-realm-to-server is used to overwrite the client's actual
origin realm attribute when it responds to the server. A value of none indicates that origin-realm-to-server is
disabled. The default value is none.
You can specify an ASCII string as a FQDN. See RFC 3588 section 6.4.
overwrite-destination-host
This attribute has been deprecated as of BIG-IP v11.3.0. When you enable this option, the system replaces the value of
the destination host field in the Diameter header with the BIG-IP(r) pool member address. When you disable this
option, the system does not modify the destination host field. The default value is enabled.
parent-avp
Specifies the name of the Diameter attribute that the system uses to indicate if the persist-avp option is embedded in
a grouped avp. A value of none indicates that the value of the persist-avp option is not embedded in a grouped avp.
The default value is none.
You can specify an ASCII string or a numeric ID in the range 1 to 4294967295. Acceptable strings can be found in RFC
3588 section 4.5.
partition
Displays the administrative partition within which the profile resides.
persist-avp
Specifies the name of the Diameter attribute that the system persists on. A value of none indicates that persistence
is disabled. The default value is session-id.
You can specify an ASCII string or a numeric ID in the range 1 to 4294967295. Acceptable strings can be found in RFC
3588 section 4.5.
regex
Displays the items that match the regular expression. The regular expression must be preceded by an at sign (@[regular
expression]) to indicate that the identifier is a regular expression. See help regex for a description of regular
expression syntax.
reset-on-timeout
When it is enabled and the watchdog failures exceed the max watchdog failure, the system resets the connection. The
default value is enabled.
retransmit-timeout
Specifies the retransmit timeout in seconds. This setting specifies the number of seconds to retransmit the request
messages if BIG-IP does not receive the corresponding answer messages . The default value is 10.
You can specify a numeric value in the range 0 to 4294967295. The recommended value is in the range of 5 to 30
to-folder
diameter profiles can be moved to any folder under /Common, but configuration dependencies may restrict moving the
profile out of /Common.
watchdog-timeout
Specifies the watchdog timeout in seconds. This setting specifies the number of seconds that a connection is idle
before the device watchdog request is sent. The default value is 0, which means BIG-IP will not send a device watchdog
request to either client or server side.
You can specify a numeric value in the range 0 to 4294967295. The recommended value is in the range of 6 to 30
SEE ALSO
create, delete, edit, glob, list, ltm virtual, modify, mv, regex, reset-stats, show, tmsh
COPYRIGHT
No part of this program may be reproduced or transmitted in any form or by any means, electronic or mechanical, including
photocopying, recording, or information storage and retrieval systems, for any purpose other than the purchaser's personal
use, without the express written permission of F5 Networks, Inc.
F5 Networks and BIG-IP (c) Copyright 2009-2013, 2015. All rights reserved.
BIG-IP 2015-07-22 ltm profile diameter(1)