ltm node
ltm node(1) BIG-IP TMSH Manual ltm node(1)
NAME
node - Configures node addresses and services.
MODULE
ltm
SYNTAX
Configure the node component within the ltm module using the syntax in
the following sections.
CREATE/MODIFY
create node [name]
modify node [name]
options:
address [ip address]
app-service [[string] | none]
connection-limit [integer]
description [string]
[down | up]
dynamic-ratio [integer]
fqdn {
name [string]
address-family [ipv4 | ipv6]
autopopulate [enabled | disabled]
down-interval [integer]
interval [integer]
}
logging [enabled | disabled]
monitor [ [name] | none]
rate-limit [integer]
ratio [integer]
session [user-enabled | user-disabled]
state [user-down | user-up]
metadata
[add | delete | modify] {
[metadata_name ... ] {
value [ "value content" ]
persist [ true | false ]
}
}
reset-stats node
reset-stats node [ [ [ip address] | [glob] | [regex] ] ... ]
edit node [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
mv node [ [[source-name] [destination-name]] | [[name] to-folder [folder-name]] | [[name...name] to-folder [folder-name]] ]
options:
to-folder
DISPLAY
list node
list node [ [ [name] | [glob] | [regex] ] ... ]
show running-config node
show running-config node [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
one-line
partition
show node
show node [name]
options:
all-properties
(default | exa | gig | kil | meg | peta | raw | tera | yotta | zetta)
field-fmt
DELETE
delete node [name]
DESCRIPTION
Displays information about nodes, and sets attributes of nodes and node
IP addresses.
EXAMPLES
list node all-properties
Displays all of the properties of all of the nodes.
modify node all monitor none
Removes all monitor associations from nodes.
create node myNode address 10.10.10.15
Creates a node named myNode with an IP address of 10.10.10.15.
modify node myNode monitor none
Removes all monitor associations from the node, myNode.
show node
Displays statistics and status for all nodes in the system
configuration.
show node all-properties
Displays statistics and status for all nodes in the system
configuration. If the system includes Packet Velocity(r) ASIC (PVA) and
PVA Assist capabilities, this command displays status and statistics
for that feature.
mv /ltm node /Common/10.10.10.15 to-folder /Common/all_nodes
Moves the node 10.10.10.15 to a folder named all_nodes, where all_nodes
has already been created under /Common.
Note: If you wish to change the name of the node, you must use the
nodes same IP Address or a name that does not represent an IP Address
that does not match the address configured on the node.
Please refer to the mv manual page for additional examples on how to
use the mv command.
OPTIONS
address
Specifies the IP address of the node.
app-service
Specifies the name of the application service to which the node
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 node. Only the application service
can modify or delete the node.
connection-limit
Specifies the maximum number of connections that a node or node
address can handle. The default value is 0 (zero).
description
Specifies a user-defined description.
[down | up]
Marks the node up or down. The default value is down.
dynamic ratio
Sets the dynamic ratio number for the node. The ratio weights are
based on continuous monitoring of the servers and are therefore
continually changing. The default value is 1.
Dynamic Ratio load balancing can currently be implemented on
RealNetworks RealServer platforms, on Windows platforms equipped
with Windows Management Instrumentation (WMI), or on a server
equipped with either the UC Davis SNMP agent or Windows 2000
Server SNMP agent.
glob Displays the items that match the glob expression. See help glob
for a description of glob expression syntax.
metadata
Associates user defined data, each of which has a name and value
pair and persistence. The default value is persistent, which saves
the data to the config file.
fqdn Specifies the attributes for defining a fully qualified domain
name for the node.
name Specifies the fully-qualified domain name of the node.
address-family
Specifies whether the fqdn should consider IPv4, IPv6, or IP-
agnostic address family.
autopopulate
Specifies whether a node defined by a fully-qualified domain
name should automatically scale to the set of IP addresses
returned by the DNS query. If disabled, only one ephemeral
node is generated from the first IP address returned by DNS.
The default is disabled.
interval
Specifies the interval to instantiate DNS queries on a fully-
qualified domain name. The default is the TTL.
down-interval
Specifies the interval for the domain name resolution
operation when a DNS query fails.
logging
Specifies whether the monitor applied should log its actions. Logs
are stored in /var/log/monitors/ and are regularly rotated and
compressed. The default value is disabled. This option isn't a
part of configuration and will reset to disabled on load. This
option doesn't sync.
monitor
Specifies the name of the monitor that you want to associate with
the node. The default value is none.
partition
Displays the administrative partition in which the node object
resides.
rate-limit
Specifies the maximum number of connections per second allowed for
a node or node address. The default value is 'disabled'.
ratio
Specifies the fixed ratio value used for a node during Ratio load
balancing. The default value is 1.
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.
session
Establishing a session with a node is establishing the ability of
the client to persist to the node when making new connections.
When a node is session disabled, clients that have already
established sessions with the node may create new connections, but
a client that has not already established a session may not create
a new one (or make a connection which would create a new session).
This feature is used to gently drain connections from a node,
typically as part of a maintenance operation. The default value is
user-enabled.
state
Specifies the current state of the node. Use user-down to indicate
that the node may not handle any new connections. Use user-up,
after using user-down, to indicate that the node may accept new
connections.
to-folder
This is used with the mv command to specify a folder in which to
move the node to.
Note: nodes can be moved to any folder under /Common, but
dependencies upon it may restrict moving it out of /Common.
SEE ALSO
create, delete, edit, glob, list, ltm pool, 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 2008-2010, 2012-2015. All rights
reserved.
BIG-IP 2015-12-03 ltm node(1)