ltm nat

ltm nat(1)		      BIG-IP TMSH Manual		    ltm nat(1)



NAME
       nat - Configures network address translation (NAT) for the Local
       Traffic Manager.

MODULE
       ltm

SYNTAX
       Configure the nat component within the ltm module using the syntax in
       the following sections.

   CREATE/MODIFY
	create nat [name]
	modify nat [name]
	  options:
	    app-service [[string] | none]
	    arp
	    auto-lasthop [default | enabled | disabled ]
	    description [string]
	    [enabled | disabled]
	    originating-address [ip address]
	    translation-address [ip address]
	    traffic-group [[string] | default | non-default | none]
	    vlans [enabled | disabled]
	    vlans-disabled
	    vlans-enabled
	reset-stats nat
	reset-stats nat [ [ [name] | [glob] | [regex] ] ... ]

	edit nat [ [ [name] | [glob] | [regex] ] ... ]
	  options:
	    all-properties
	    non-default-properties

   DISPLAY
	list nat
	list nat [ [ [name] | [glob] | [regex] ] ... ]
	show running-config nat
	show running-config nat [ [ [name] | [glob] |
				    [regex] ] ... ]
	  options:
	    all-properties
	    non-default-properties
	    one-line
	    partition

	show nat
	show nat [name]
	  options:
	    (default | exa | gig | kil | meg | peta | raw | tera | yotta | zetta)
	    field-fmt

   DELETE
	delete nat [name]

DESCRIPTION
       A network address translation (NAT) defines a mapping between an
       originating IP address and an IP address that you specify.

       A primary reason for defining a NAT is to allow one of the servers in
       the server array behind the traffic management system to start
       communication with a computer in front of, or external to, the system.

EXAMPLES
       create nat new_nat translation-address 10.0.140.100 originating-address
       11.0.0.100

       The node behind the system with the IP address 10.0.140.100 has a
       presence in front of the BIG-IP(r) System as IP address 11.0.0.100.

       delete nat new_nat

       Permanently deletes the NAT from the system configuration.

Additional Restrictions
       The nat component has the following additional restrictions:

       o    A virtual server cannot use the IP address specified in the NAT.

       o    A NAT should not use an IP address of a BIG-IP system.

       o    A NAT cannot use an originating or translated IP address defined
	    for and used by a SNAT or another NAT.

       o    You must delete a NAT before you can redefine it.

OPTIONS
       app-service
	    Specifies the name of the application service to which the NAT
	    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 NAT. Only the application service
	    can modify or delete the NAT.

       arp  Enables or disables Address Resolution Protocol (ARP).

       description
	    User defined description.

       [enabled | disabled]
	    Enables or disables the NAT. The default value is enabled.

       glob Displays the items that match the glob expression. See help glob
	    for a description of glob expression syntax.

       inherited-traffic-group
	    Indicates if the traffic-group is inherited from the parent
	    folder. This property is read only.

       originating-address
	    Specifies the IP address from which traffic is being initiated.

       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.

       traffic-group
	    Specifies the traffic group of the failover device group on which
	    the NAT is active. The default traffic group is inherited from the
	    containing folder.

       translation-address
	    Specifies the IP address that is translated or mapped, and the IP
	    address to which it is translated or mapped. This option is
	    required when creating a NAT. This option may not be changed after
	    the nat has been created.

       unit Specifies the unit in a redundant system. Derived from traffic-
	    group. This property is read only.

       vlans
	    Specifies a list of existing VLANs on which access to the NAT is
	    enabled or disabled. A NAT is accessible on all VLANs by default.

       vlans-disabled
	    Indicates the NAT is disabled on the list of VLANs.

       vlans-enabled
	    Indicates the NAT is enabled on the list of VLANs.

SEE ALSO
       create, delete, edit, glob, list, ltm snat, ltm snat-translation,
       modify, 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-2013. All rights reserved.



BIG-IP				  2014-05-16			    ltm nat(1)