Getting Started

The documentation contains information about how to install and use the F5 AS3 Configuration Converter. F5 AS3 Configuration Converter is a community-supported offering. Please use GitHub Issues to submit an issue for our team. You can also see current Known Issues and their status on that page.

About F5 AS3 Configuration Converter

The F5 AS3 Configuration Converter, or ACC, provides a way to convert configuration files to AS3 declarations. The converter, which tuns in a Docker container, converts .ucs, .scf, or bigip.conf files, outputting to valid AS3 declaration stanzas.

Note

Docker must be installed prior to using ACC. See Docker Desktop for information on installing Docker.

Important Information

  • Currently ACC does not support all BIG-IP configuration object types, although coverage will increase over time.
  • Only TMOS versions 12.1+ are supported.
  • After the conversion, some manipulation of AS3 stanzas may be required.
  • The converter produces an AS3 declaration, placing any configuration objects located in /Common partition on the source BIG-IP into /Common/Shared (an existing AS3 construct).
  • For a list of the objects that are converted, see [FAQ](FAQ.md).
  • While ACC will convert a BIG-IP app services configuration created by a legacy iApp template, ACC will ignore the iApp template configuration itself.
  • iRules only export in UTF-8 (no base64), and comments are removed by the parser.
  • TLS/SSL certificates and keys are only extracted if the input source is a UCS file, and the private keys were included when the UCS was created (default option).

Note

Passphrases/passwords CAN be extracted as a cryptogram and not cleartext, although the output generated by the converter will only work on the same BIG-IP instance that created the configuration input.

  • Multiple Client_TLS and Server_TLS profiles have limited support. Configurations will be converted, but to apply them see the Referencing multiple SSL profiles documentation. SSL profiles must exist on the BIG-IP device.

  • All items on the pre-AS3 configuration must be uniquely named. BIG-IP itself allows some objects to have the same name, while AS3 does not. Any object with a duplicate name will be overwritten.

  • By default, ACC sets “shareNodes”:true for all nodes. “shareNodes”:true is appended to the node to avoid conflicts or errors when exporting more than one AS3 configuration sharing the same node, and is set to true even if no duplicate nodes are configured.

    For example:

"web_pool1": {
    "class": "Pool",
    "members": [
        {
          "serverAddresses": [
             "10.244.1.58"
            ],
            "servicePort": 80,
        "shareNodes": true
    }