1. REST API for the Session Border ControllerREST API for Session Border Controller, Enterprise Session Border Controller, and Subscriber-Aware Load Balancer, Release 8.4.0
  2. Examples
  3. Modify the Boot Parameters

Modify the Boot Parameters

Complete these tasks to modify the boot parameters of the Session Border Controller (SBC).

Table - Prerequisites

Prerequisite More Information
Authenticate Authenticate

This example assumes you have exported the access token to the variable $TOKEN.

  1. Retrieve the current boot parameters. 
    curl -X GET -o response.xml \
    --header "Accept: application/xml" \
    --header "Authorization: Bearer $TOKEN" \
    "https://10.0.0.2/rest/v1.1/configuration/bootparams"
    The response is saved to the file response.xml.
  2. Copy the content between the opening and closing <bootparams> tags to a new file called request.xml.

    If you are on a Linux system with xmllint installed, you may optionally format the XML before writing it to the file system. 

    sed -n '/<bootparams>/,/<\/bootparams>/p' response.xml | xmllint --format - > request.xml
  3. Open the file and change the text of the <value> elements to their desired values.

    The request.xml file only needs to include the <bootparam> elements that you want to change.

    To change only the IP address, netmask, and target name, write the following to the request.xml file: 

    <?xml version="1.0"?>
<bootparams>
  <bootparam>
    <name>IP Address</name>
    <value>10.0.0.2</value>
  </bootparam>
  <bootparam>
    <name>Netmask</name>
    <value>255.255.255.0</value>
  </bootparam>
  <bootparam>
    <name>Target Name</name>
    <value>PRIMARY</value>
  </bootparam>
</bootparams>
  4. 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"
  5. Update the boot parameters. 
    curl -X PUT -d@request.xml \
    --header "Accept: application/xml" \
    --header "Authorization: Bearer $TOKEN" \
    "https://10.0.0.2/rest/v1.1/configuration/bootparams"
  6. 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"
  7. Confirm the change was made with a GET request. 
    curl -X GET \
    --header "Accept: application/xml" \
    --header "Authorization: Bearer $TOKEN" \
    "https://10.0.0.2/rest/v1.1/configuration/bootparams"
  8. Reboot the machine. 
    curl -X POST \
    --header "Accept: application/xml" \
    --header "Authorization: Bearer $TOKEN" \
    "https://10.0.0.2/rest/v1.1/admin/reboot"

    The SBC reboots with the configured boot parameters.