Save, Verify, and Activate the Configuration

Complete these tasks to save, verify, and activate your configuration.

Table - Prerequisites

Prerequisite More Information
Authenticate Authenticate

This example assumes you have exported the access token to the variable $TOKEN and made a recent change to the configuration of your Session Border Controller (SBC).

  1. Acquire the configuration lock.
    curl -X POST \
        --header "Accept: application/xml" \
        --header "Authorization: Bearer $TOKEN" \
        "https://10.0.0.2/rest/v1.1/configuration/lock"
  2. Save your configuration.
    curl -X PUT \
      --header "Accept: application/xml" \
      --header "Authorization: Bearer $TOKEN" \
      "https://10.0.0.2/rest/v1.1/configuration/management?action=save"

    Poll the link returned in <links> element to confirm your configuration was activated.

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <response>
      <data>
        <operationState>
          <operation>save</operation>
          <status>success</status>
        </operationState>
      </data>
      <messages/>
      <links/>
    </response>
  3. Verify there are no errors in your configuration.
    curl -X PUT \
      --header "Accept: application/xml" \
      --header "Authorization: Bearer $TOKEN" \
      "https://10.0.0.2/rest/v1.1/configuration/management?action=verify"

    Poll the link returned in <links> element to confirm your configuration was activated.

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <response>
      <data>
        <operationState>
          <operation>verify</operation>
          <status>success</status>
        </operationState>
        <additionalInfo>
          <verifySummary numCriticals="0" numErrors="0" numWarnings="0"/>
        </additionalInfo>
      </data>
      <messages/>
      <links/>
    </response>
  4. If the verification returned no errors, activate the configuration.
    curl -X POST \
      --header "Accept: application/xml" \
      --header "Authorization: Bearer $TOKEN" \
      "https://10.0.0.2/rest/v1.1/configuration/management?action=activate"

    Poll the link returned in <links> element to confirm your configuration was activated.

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <response>
      <data>
        <operationState>
          <operation>activate</operation>
          <status>success</status>
        </operationState>
      </data>
      <messages/>
      <links/>
    </response>
  5. Release the configuration lock.
    curl -X POST \
        --header "Accept: application/xml" \
        --header "Authorization: Bearer $TOKEN" \
        "https://10.0.0.2/rest/v1.1/configuration/unlock"