Complete these tasks to modify the boot parameters of the Session Border Controller (SBC).
This example assumes you have exported the access token to the variable $TOKEN
.
- Retrieve the current boot parameters.
curl -X GET -o response.xml \
--header "Accept: application/xml" \
--header "Authorization: Bearer $TOKEN" \
"https://${SBCIP}/rest/v1.1/configuration/bootparams"
The response is saved to the file response.xml
.
- 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
- 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>
- Acquire the configuration lock.
curl -X POST \
--header "Accept: application/xml" \
--header "Authorization: Bearer $TOKEN" \
"https://${SBCIP}/rest/v1.1/configuration/lock"
- Update the boot parameters.
curl -X PUT -d@request.xml \
--header "Accept: application/xml" \
--header "Authorization: Bearer $TOKEN" \
"https://${SBCIP}/rest/v1.1/configuration/bootparams"
- Release the configuration lock.
curl -X POST \
--header "Accept: application/xml" \
--header "Authorization: Bearer $TOKEN" \
"https://${SBCIP}/rest/v1.1/configuration/unlock"
- Confirm the change was made with a GET request.
curl -X GET \
--header "Accept: application/xml" \
--header "Authorization: Bearer $TOKEN" \
"https://${SBCIP}/rest/v1.1/configuration/bootparams"
- Reboot the machine.
curl -X POST \
--header "Accept: application/xml" \
--header "Authorization: Bearer $TOKEN" \
"https://${SBCIP}/rest/v1.1/admin/reboot"
The SBC reboots with the configured boot parameters.