ltm rule command BWC priority

iRule(1)					  BIG-IP TMSH Manual					     iRule(1)

BWC::priority
       This command is used to create a priority class for a bwc policy.

SYNOPSIS
       BWC::priority (PRIORITY_CLASS   WEIGHT)
			     (PRIORITY_CLASS   WEIGHT)?
			     (PRIORITY_CLASS   WEIGHT)?
			     (PRIORITY_CLASS   WEIGHT)?

DESCRIPTION
       A BWC policy instance or category can be mapped to a priority class of a priority group. This is part of the
       configuration and can be done via tmsh or GUI. Once a BWC instance has these mappings we can use the iRule
       defined below to change those. The syntax for this iRule is like below,

       BWC::priority   [ ] [ ] [ ]

	   nameX - name of a priority class. valueX - weight of the priority class in percentage.

       In the above iRule you can specify one or more traffic classes and specify the desired weight-percentage for
       that priority-class. Please note that the weight-percentages are updated only for the BWC instance over which
       the iRule is being run. The policy continues to have the weight-percentage as configured by tmsh/GUI. Any new
       BWC instance will get the weight-percentage from the tmsh/GUI based configuration unless the new instance
       executed a BWC:priority iRule to override it.

RETURN VALUE
VALID DURING
EXAMPLES
	An example BWC::priority iRule. In this iRule we are setting the weight percentage of tg1->tc1 and tg1->tc2 to 60 and 40 respectively. Note that the BWC configuration has defined these weights to be 80 and 20. We are using iRules to override that and change it to 60 and 40.

	when SERVER_CONNECTED {

	    set my_policy bwc_policy set my_cat none set my_cookie [IP::remote_addr] switch -glob [TCP::remote_port] {
		"101" {
		    set my_cat c1
		}
		"102" {
		    set my_cat c2
		}
	    }
	    BWC::policy attach $my_policy $my_cookie if { $my_cat != "none" } {
		log local0. "BWC::color set $my_policy $my_cat" BWC::color set $my_policy $my_cat BWC::priority "tc1" 60 "tc2" 40
	    }
	}

	tmsh configuration:

	net bwc policy bwc_policy {

	    categories {
		c1 {
		    max-cat-rate 10mbps
		    traffic-priority-map tg1->tc1
		}
		c2 {
		    max-cat-rate 10mbps
		    traffic-priority-map tg1->tc2
		}
	    }
	    dynamic enabled log-publisher /Common/test_publisher max-rate 10mbps max-user-rate 10mbps
	}

	net bwc priority-group tg1 {

	    priority-classes {
		tc1 {
		    weight-percentage 80
		}
		tc2 {
		    weight-percentage 20
		}
	    }
	}

HINTS
SEE ALSO
CHANGE LOG
       @BIGIP-11.3.0 --First introduced the command.

BIG-IP						      2020-06-23					     iRule(1)