Manual Chapter : Exporting and importing a per-request policy across BIG-IP systems

Applies To:

  • BIG-IP APM

    15.1.8, 15.1.7, 15.1.6, 15.1.5, 15.1.4, 15.1.3, 15.1.2, 15.1.1, 15.1.0

Updated Date: 07/07/2026

Exporting and importing a per-request policy across BIG-IP systems

Export a per-request policy from one BIG-IP system and import it on another (at the same product version level) to copy a policy across systems.

Note: Per-request policy import does not support the import of custom categories or the URLs defined for them. Before you import a per-request policy from one BIG-IP system to another BIG-IP system, you must first list any custom categories configured on the source system and make sure you have the same custom categories on the target system. Otherwise, import will fail.

  1. On the Main tab, click Access > Profiles / Policies > Per-Request Policies.

    The Per-Request Policies screen opens.

  2. Click the link in the Export column for the policy that you want to export.

    A file downloads.

  3. Note the list of custom categories:

    1. Click Access Policy > Secure Web Gateway > URL Categories.

    2. Expand the Custom Categories list.

  4. Log in to the Configuration utility on the BIG-IP system where you want to import the per-request policy.

  5. Verify that the custom categories that exist on the other BIG-IP system also exist on this BIG-IP system:

    1. Click Access Policy > Secure Web Gateway > URL Categories.

    2. Expand the Custom Categories list.

    3. Create any additional custom categories needed to match the list on the other BIG-IP system.

      The import process does not add URLs to custom categories. To include the URLs defined for a custom category on the source system, you can add them to the target system now or wait until after you import the per-request policy.

  6. On the Main tab, click Access > Profiles / Policies > Per-Request Policies.

    The Per-Request Policies screen opens.

  7. Click Import.

    An Import Policy screen displays.

  8. In New Policy Name, type a name.

  9. For Config File Upload, click Browse, locate and select the file downloaded from the other BIG-IP system.

  10. To reuse objects already existing on this BIG-IP system, select the Reuse Existing Objects check box.

  11. Click Import.