pem forwarding-endpointΒΆ

pem forwarding-endpoint(1)			  BIG-IP TMSH Manual			   pem forwarding-endpoint(1)

NAME
       forwarding-endpoint - Configures forwarding endpoints for the Policy Enforcement Manager (PEM).

MODULE
       pem

SYNTAX
       Modify the forwarding-endpoint component within the pem module using the syntax shown in the following
       sections.

   CREATE/MODIFY
	create forwarding-endpoint [name]
	modify forwarding-endpoint [name]
	  options:
	    app-service [[string] | none]
	    description [[string] | none]
	    persistence {
	      options:
		type [destination-ip | disabled | hash | source-ip]
		fallback [destination-ip | disabled | source-ip]
		hash-settings {
		  options:
		    algorithm [carp ]
		    length [integer]
		    offset [integer]
		    source [tcl-snippet | uri]
		    tcl-value [string]
		}
	    }
	    pool [name]
	    snat-pool [name]
	    source-port [change | preserve | preserve-strict]
	    translate-address [disabled | enabled]
	    translate-service [disabled | enabled]

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

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

   DELETE
	delete forwarding-endpoint [name]

       Note: All references to the forwarding-endpoint must be removed before it can be deleted.

DESCRIPTION
       forwarding-endpoint is used to specify PEM policy forwarding action(s).

       Note: A valid LTM pool with at least one member must be pre-configured before creating a forwarding-endpoint.
       Please refer to ltm pool for more info about configuring LTM pools.

EXAMPLES
       create forwarding-endpoint my_endpoint { pool my_pool snatpool my_snatpool source-port preserved translate-
       address enabled translate-service enabled }

       Creates a Policy Enforcement Manager forwarding endpoint named my_endpoint.

       delete forwarding-endpoint my_endpoint

       Deletes the forwarding-endpoint named my_endpoint.

       list forwarding-endpoint my_endpoint

       Displays the properties of the forwarding-endpoint named my_endpoint.

OPTIONS
       app-service
	    Specifies the name of the application service to which the object belongs. The default value is none.
	    Note: If the strict-updates option is enabled on the application service that owns the object, user
	    cannot modify or delete the object. Only the application service can modify or delete the object.

       description
	    Specifies a user-defined description.

       persistence
	    Allows to set a specific persistence method for the pool member selection.

	    fallback
		 Specifies the fallback persistence method so that it applies when default persistence fail.

		 The options are:

		 destination-ip
		      Map the destination ip address to a specific pool member so that subsequent traffic sent to
		      this address is directed to the same pool member.

		 source-ip
		      Map the source ip address to a specific pool member so that subsequent traffic from this
		      address is directed to the same pool member.

		 disabled
		      Specifies that this feature is disabled.

	    hash-settings
		 Specifies the settings for the hash persistence method.

		 algorithm
		      Specifies the algorithm to calculate the hash value. Currently only the carp algorithm is
		      available.

		 length
		      Specifies the length of the source string used to calculate hash value. Default value of length
		      is 1024.

		 offset
		      Specifies the offset in bytes from start of the source string to calculate the hash value.
		      Default value of offset is 0.

		 source
		      Specifies the source for the string value which is used to calculate hash value.

		 tcl-value
		      Specifies the tcl script snippet so that when this script is executed its result used to
		      calculate the hash value.

	    type Specifies the persistence method.

		 The options are:

		 destination-ip
		      Map the destination ip address to a specific pool member so that subsequent traffic sent to
		      this address is directed to the same pool member.

		 hash Map the hash value to a specific pool member so that subsequent traffic with the same hash
		      value is directed to the same pool member.

		 source-ip
		      Map the source ip address to a specific pool member so that subsequent traffic from this
		      address is directed to the same pool member.

		 disabled
		      Specifies that this feature is disabled.

       pool Specifies the name of an LTM pool where the traffic is going to be directed to. Is used in the PEM policy
	    rule forwarding actions. Note that the pool must be pre-configured before it can be referenced by a
	    forwarding action.

       snat-pool
	    Specifies the name of an existing LTM SNAT pool (snatpool) that is used to translate the client IP
	    address to one of the configured IP addresses in that SNAT pool. The Self-IP addresses of the BIG-IP
	    system must not be included in the SNAT pool. The default value is none.

       source-port
	    Specifies whether the system preserves the source port of the connection. The default value is preserve.

	    The options are:

	    change
		 Specifies that the system changes the source port. This setting is useful for obfuscating internal
		 network address.

	    preserve
		 Specifies that the system preserves the value configured for the source port, unless the source port
		 from a particular snat is already in use, in which case the system uses a different port.

	    preserve-strict
		 Specifies that the system preserves the value configured for the source port. If the port is in use,
		 the system does not process the connection. F5 Networks recommends restricting the use of this
		 setting to cases that meet at least one of the following conditions:

		      The port is configured for UDP traffic.

		      The system is configured for nPath routing or is running in transparent mode (that is, there is
		      no translation of any other Layer 3 or Layer 4 field).

		      There is a one-to-one relationship between virtual IP addresses and node addresses, or
		      clustered multiprocessing (CMP) is disabled.

       translate-address
	    Specifies, when enabled, that the system translates the original destination address of the virtual
	    server. When disabled, specifies that the system uses the address without translation. The default value
	    is disabled.

       translate-service
	    Note that translate-service is really translate-port. It specifies, when enabled, that the system
	    translates the original destination port. When disabled, it specifies that the system uses the original
	    destination port without translation. The default value is disabled.

SEE ALSO
       create, delete, edit, glob, list, modify, pem interception-endpoint, pem listener, pem policy, pem profile
       diameter-endpoint, pem profile spm, pem reporting format-script, pem service-chain-endpoint, pem subscriber,
       pem subscribers, regex, 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-2014. All rights reserved.

BIG-IP						      2016-01-07			   pem forwarding-endpoint(1)