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://${SBCIP}/rest/v1.1/configuration/lock"
  2. Save your configuration.
    curl -X PUT \
  --header "Accept: application/xml" \
  --header "Authorization: Bearer $TOKEN" \
  "https://${SBCIP}/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://${SBCIP}/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://${SBCIP}/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://${SBCIP}/rest/v1.1/configuration/unlock"