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)