Service Forwarding IP

[penguin2839]

Enviornment

• Application Services Version: 3.19.1
• BIG-IP Version: 15.1.0.4

Summary

I am trying to create a service forwarding VIP but I keep getting this error: "/enterprise_networking/radius_coa_tis/radius_coa_tis_udp_1700: # is NOT valid"

Steps To Reproduce

Post the following declaration to the BIG-IP assuming enterprise_networking is a valid tenant.

{
  "class": "AS3",
  "action": "patch",
  "patchBody": [{
    "op": "add",
    "path": "/enterprise_networking/radius_coa_tis",
    "value": {
      "class": "Application",
      "template": "generic",
      "radius_coa_tis_udp_1700": {
        "class": "Service_Forwarding",
        "forwardingType": "ip",
        "layer4": "udp",
        "snat": {
          "use": "radius_coa_snat_pool"
        },
        "virtualAddresses": [
          ["0.0.0.0/0",
          "10.7.28.0/24"]
        ],
        "virtualPort": 1700,
        "pool": "",
        "persistenceMethods": []
      },
      "radius_coa_snat_pool": {
        "class": "SNAT_Pool",
        "snatAddresses": [
          "10.7.26.114"
        ]
      }
    }
  }]
}

Expected Behavior

The declaration would post with no errors.

Actual Behavior

{
    "code": 422,
    "errors": [
        "/enterprise_networking/radius_coa_tis/radius_coa_tis_udp_1700: # is NOT valid"
    ],
    "declarationFullId": "",
    "message": "declaration is invalid"
}

[dstokesf5]

The pool and persistenceMethods properties are not supported on the Service_Forwarding class: https://clouddocs.f5.com/products/extensions/f5-appsvcs-extension/latest/refguide/schema-reference.html#service-forwarding

The following PATCH body succeeds:

{
  "class": "AS3",
  "action": "patch",
  "patchBody": [{
    "op": "add",
    "path": "/enterprise_networking/radius_coa_tis",
    "value": {
      "class": "Application",
      "template": "generic",
      "radius_coa_tis_udp_1700": {
        "class": "Service_Forwarding",
        "forwardingType": "ip",
        "layer4": "udp",
        "snat": {
          "use": "radius_coa_snat_pool"
        },
        "virtualAddresses": [
          ["0.0.0.0/0",
          "10.7.28.0/24"]
        ],
        "virtualPort": 1700
      },
      "radius_coa_snat_pool": {
        "class": "SNAT_Pool",
        "snatAddresses": [
          "10.7.26.114"
        ]
      }
    }
  }]
}

[melkypie]

If they are not supported should they not be taken out of documentation, since it clearly shows them being supported in schema reference? Also noticed that virtualPort is not included in Service_Forwarding which is a pretty critical option as it won't let you create a service without defining it and will keep throwing you this error: "\\\"/TENANT/10.0.0.0:undefined\\\" contains invalid or ambiguous service undefined"

[dstokesf5]

It turns out that the tooling we use to generate the schema documentation is not handling the Service_Forwarding class properly. It is including several unsupported properties and failing to document supported properties, such as virtualPort. I have added AUTOTOOL-1779 to our internal product backlog to find a way to get the tooling to generate more accurate documentation.

[sunitharonan]

If you are still looking for a fix, please reach out to us at [email protected]

[github-actions[bot]]

This issue has been automatically closed because there has been no response to our request for more information from the original author. With only the information that is currently in the issue, we don't have enough information to take action. Please reach out if you have or find the answers we need so that we can investigate further.

[sunitharonan]

Closing as this has been released in AS3 3.48.0