Quickstart

If you are familiar with the BIG-IP system, and generally familiar with REST and using APIs, this section contains the minimum amount of information to get you up and running with Cloud Failover.

  1. Download the latest RPM package from F5 Cloud Failover site on GitHub in the dist directory.
  2. Upload and install the RPM package on the using the BIG-IP GUI:
  3. Be sure to see the known issues on GitHub (https://github.com/F5Networks/f5-cloud-failover/issues) to review any known issues and other important information before you attempt to use Cloud Failover.
  4. Provide authorization (basic auth) to the BIG-IP system:
  5. Using a RESTful API client like Postman, send a GET request to the URI https://{{host}}/mgmt/shared/cloud-failover/info to ensure Cloud Failover is running properly.
  6. Copy one of the Example Declarations which best matches the configuration you want to use.
  7. Paste the declaration into your API client, and modify names and IP addresses as applicable.
  8. POST to the URI https://<BIG-IP>/mgmt/shared/cloud-failover/declare

Quick Start Example

Here is an example declaration for Microsoft Azure.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
    "class": "Cloud_Failover",
    "environment": "azure",
      "externalStorage": {
        "scopingTags": {
          "f5_cloud_failover_label": "mydeployment"
        }
    },
      "failoverAddresses": {
        "scopingTags": {
          "f5_cloud_failover_label": "mydeployment"
        }
    },
    "failoverRoutes": {
      "scopingTags": {
        "f5_cloud_failover_label": "mydeployment"
      },
      "scopingAddressRanges": [
        "192.168.1.0/24"
      ]
    }
}