Set the Hostname

Complete these tasks to set the hostname 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 system-config template.

   The template of a configuration element is a data structure containing all required sub-elements and supported attributes with their default values, along with any specified optional sub-elements.

   curl -X GET -o response.xml \
       --header "Accept: application/xml" \
       --header "Authorization: Bearer $TOKEN" \
       "https://10.0.0.2/rest/v1.1/configuration/elementTypes/template?elementType=system-config"

   The response is saved to the file response.xml.
2. Copy the content between the opening and closing <configElement> tags to a new file called system-config.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 '/<configElement>/,/<\/configElement>/p' response.xml | xmllint --format - > system-config.xml

3. Open the file and set the value of the hostname attribute to its desired value.

   For example, if the hostname is example-sbc:

   <?xml version="1.0"?>
   <configElement>
     <elementType>system-config</elementType>
     <attribute>
       <name>hostname</name>
       <value>example-sbc</value>
     </attribute>
     ...
   </configElement>

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. Add the system-config configuration element.

   curl -X POST \
       [e-mail] \
       --header "Accept: application/xml" \
       --header "Authorization: Bearer $TOKEN" \
       "https://10.0.0.2/rest/v1.1/configuration/configElements"

6. If done editing the configuration, save, verify, and activate the configuration.
7. 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"