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)