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)