Citrix ADC

Configuring a Pattern Set

To configure a pattern set, you must specify the strings that are to serve as patterns. You can manually assign a unique index value to each of these patterns, or you can allow the index values to be assigned automatically.

Note: Pattern sets are case sensitive (unless you specify the expression to ignore case). Therefore, the string pattern “product1,” for example, is not the same as the string pattern “Product1.”

Points to remember about index values:

  • You cannot bind the same index value to more than one pattern.
  • An automatically assigned index value is one number larger than the highest index value of the existing patterns within the pattern set. For example, if the highest index value of existing patterns in a pattern set is 104, the next automatically assigned index value is 105.
  • If you do not specify an index for the first pattern, index value 1 is automatically assigned to that pattern.
  • Index values are not regenerated automatically if one or more patterns are deleted or modified. For example, if the set contains five patterns, with indexes from 1 through 5, and if the pattern with an index of 3 is deleted, the other index values in the pattern set are not automatically regenerated to produce values from 1 through 4.
  • The maximum index value that can be assigned to a pattern is 4294967290. If that value is already assigned to a pattern in the set, you must manually assign index values to any newly added patterns. An unused index value that is lower than a currently used value cannot be assigned automatically.

To configure a pattern set by using the command line interface

At the command prompt, do the following:

  1. Create a pattern set.

    add policy patset <name>


    > add policy patset samplepatset
  2. Bind patterns to the pattern set.

    bind policy patset <name> <string> [-index <positive_integer>]


    > bind policy patset samplepatset product1 -index 1

    Note: Repeat this step for all the patterns you want to bind to the pattern set.

  3. Verify the configuration.

    show policy patset <name>

To configure a pattern set by using the configuration utility

  1. Navigate to AppExpert > Pattern Sets.
  2. In the details pane, click Add to open the Create Pattern Set dialog box.
  3. Specify a name for the pattern set in the Name text box.
  4. Under Specify Pattern, type the first pattern and, optionally, specify values for the following parameters:
    • Treat back slash as escape character—Select this check box to specify that any backslash characters that you might include in the pattern are to be treated as escape characters.
    • Index—A user assigned index value, from 1 through 4294967290.
  5. Verify that you have entered the correct characters, and then click Add.
  6. Repeat steps 4 and 5 to add more patterns, and then click Create.
Configuring a Pattern Set