How to: Edit the configuration for a managed BIG-IP Next instance

Use this procedure to view and edit the configuration details for a managed BIG-IP Next instance that was created from a template.

Prerequisites

You must have Administrator credentials to edit a managed BIG-IP Next instance’s properties. The BIG-IP Next configuration you edit must have been created using a template.

For more information about creating BIG-IP Next instances from a template, see How to: Create a BIG-IP Next HA instance in a VE environment from BIG-IP Next Central Manager.

Procedure

  1. Log in to BIG-IP Next Central Manager as admin, click the workspace switcher next to the F5 icon, and click Infrastructure.

  2. Click the name of the BIG-IP Next instance you want to edit.
    The Properties panel opens.

  3. At the top of the panel, click the Edit button.
    This button is available only if you have Administrator credentials.

  4. Edit the properties as required and click the Next button.

  5. Review your changes and then click the Deploy button at the bottom of the panel.
    The My instances page displays.

Prerequisite

Authenticate with the BIG-IP Next Central Manager API. For details refer to How to: Authenticate with the BIG-IP Next Central Manager API.

Use the following APIs to modify the configuration of a BIG-IP Next instance.

  1. Get the BIG-IP Next instance ID which you want to configure by sending the GET request spaces/default/instances?filter=address eq '{{bigip_next_mgmt_ip}} endpoint.

    GET https://{{bigip_next_cm_mgmt_ip}}/api/v1/spaces/default/instances?filter=address eq '{{bigip_next_mgmt_ip}}'
    Click for sample response ▶ 
    {
    "_embedded": {
        "devices": [
            {
                "_links": {
                    "self": {
                        "href": "/api/v1/spaces/default/instances?filter=address+eq+%27xxx.xxx.xxx.xxx%27/3bf570b6-7763-4e70-a3b5-4c07492c2c06"
                    }
                },
                "address": "xxx.xxx.xxx.xxx",
                "certificate_validated": "2024-05-23T20:39:08.611071Z",
                "certificate_validity": false,
                "hostname": "myvelosinstance",
                "id": "3bf570b6-7763-4e70-a3b5-4c07492c2c06",
                "mode": "STANDALONE",
                "platform_name": "VELOS",
                "platform_type": "CHASSIS",
                "port": 5443,
                "short_id": "2UVWZSAG",
                "version": "20.3.0-2.435.1"
            }
        ]
    },
    "_links": {
        "self": {
            "href": "/api/v1/spaces/default/instances?filter=address+eq+%27xxx.xxx.xxx.xxx%27"
        }
    },
    "count": 1,
    "total": 1
}

  2. Retrieve the current configuration of the BIG-IP Next instance by sending the GET request to spaces/default/instances/initialization/{instance_id} endpoint.

    GET https://{{cm_mgmt_ip}}/api/v1/spaces/default/instances/initialization/{instance_id}

    For more information about retrieving the instance current configuration using BIG-IP Next Central Manager APIs, see OpenAPI Documentation.

  3. Update the configuration of the BIG-IP Next instance by sending the PATCH request to spaces/default/instances/initialization/{instance_id} endpoint.

    PATCH https://{{cm_mgmt_ip}}/api/v1/spaces/default/instances/initialization/{instance_id}

    For more information about updating the instance current configuration using BIG-IP Next Central Manager APIs, see OpenAPI Documentation.

Result

The BIG-IP Next instance configuration is updated successfully.