NETCONF Configuration Guide
...
System
System‑Config
20 min
asternos system config this chapter provides examples on how to use netconf to manage system configurations on asternos devices create dns server request example to create dns server via edit config \<config> \<top> \<system config> \<dns resolver> \<server operation="create"> \<address>1 1 1 1\</address> \</server> \</dns resolver> \</system config> \</top> \</config> response example \<rpc reply xmlns="urn\ ietf\ params\ xml\ ns\ netconf\ base 1 0" message id="urn\ uuid 4f3ee6c9 9bae 427a 93c8 d151b6f2f190"> \<ok/> \</rpc reply> modify hostname note valid hostname requirements only letters (a–z, a–z), digits (0–9), and hyphens ( ) are allowed special characters like underscores ( ), dots ( ), spaces, or symbols are not allowed the hostname must start and end with a letter or a digit it cannot begin or end with a hyphen the total length must be between 1 and 63 characters request example to modify hostname via edit config \<config> \<top> \<system config operation="merge"> \<hostname>test netconf\</hostname> \</system config> \</top> \</config> response example \<rpc reply xmlns="urn\ ietf\ params\ xml\ ns\ netconf\ base 1 0" message id="urn\ uuid 4f3ee6c9 9bae 427a 93c8 d151b6f2f190"> \<ok/> \</rpc reply> modify system clock note here we can mpdify the system datetime and timezone the datetime format is yyyy mm ddthh\ mm\ ss±hh\ mm and we can obtain the supported timezones via rpc show supported timezones however, we recommend using ntp to synchronize the time whenever possible request example to modify hostname via edit config \<config> \<top> \<system config> \<clock operation="merge"> \<datetime>2025 02 12t02 26 01z\</datetime> \<timezone>asia/shanghai\</timezone> \</clock> \</system config> \</top> \</config> response example \<rpc reply xmlns="urn\ ietf\ params\ xml\ ns\ netconf\ base 1 0" message id="urn\ uuid 4f3ee6c9 9bae 427a 93c8 d151b6f2f190"> \<ok/> \</rpc reply> modify ssh max session number request example to modify ssh max session number via edit config \<config> \<top> \<system config operation="merge"> \<ssh max session>20\</ssh max session> \</system config> \</top> \</config> response example \<rpc reply xmlns="urn\ ietf\ params\ xml\ ns\ netconf\ base 1 0" message id="urn\ uuid 4f3ee6c9 9bae 427a 93c8 d151b6f2f190"> \<ok/> \</rpc reply> modify telnet max session number request example to modify telnet max session number via edit config \<config> \<top> \<system config operation="merge"> \<telnet max session>20\</telnet max session> \</system config> \</top> \</config> response example \<rpc reply xmlns="urn\ ietf\ params\ xml\ ns\ netconf\ base 1 0" message id="urn\ uuid 4f3ee6c9 9bae 427a 93c8 d151b6f2f190"> \<ok/> \</rpc reply> delete dns server request example to delete dns server via edit config \<config> \<top> \<system config> \<dns resolver> \<server operation="delete"> \<address>1 1 1 1\</address> \</server> \</dns resolver> \</system config> \</top> \</config> response example \<rpc reply xmlns="urn\ ietf\ params\ xml\ ns\ netconf\ base 1 0" message id="urn\ uuid 4f3ee6c9 9bae 427a 93c8 d151b6f2f190"> \<ok/> \</rpc reply> get dns servers request example to retrieve dns servers via get config with subtree filter \<filter type="subtree"> \<top> \<system config> \<dns resolver> \<server/> \</dns resolver> \</system config> \</top> \</filter> response example \<data> \<top> \<system config xmlns="http //asterfusion com/ns/yang/asternos system config"> \<dns resolver> \<server> \<address>2 2 2 2\</address> \</server> \<server> \<address>1 1 1 1\</address> \</server> \</dns resolver> \</system config> \</top> \</data> get system configurations request example to retrieve system configurations via get config with subtree filter \<filter type="subtree"> \<top> \<system config/> \</top> \</filter> response example \<data> \<top> \<system config xmlns="http //asterfusion com/ns/yang/asternos system config"> \<hostname>test netconf\</hostname> \<ssh max session>20\</ssh max session> \<telnet max session>20\</telnet max session> \<dns resolver> \<server> \<address>1 1 1 1\</address> \</server> \</dns resolver> \<clock> \<timezone>asia/shanghai\</timezone> \</clock> \</system config> \</top> \</data> show license status request example to retrieve license status via rpc show license \<show license/> response example \<rpc reply xmlns="urn\ ietf\ params\ xml\ ns\ netconf\ base 1 0" message id="urn\ uuid 05b3dfdd 15c1 44e8 8777 bddcde13a3ed"> \<data xmlns="http //asterfusion com/ns/yang/asternos system config"> license name all 19710101 license md5 fab126157378dd632cc607d0c00488cd valid true build time 1971 01 01 00 07 24 valid to 2026 07 19 17 39 08 feature status \ igmp true tunnel true router protocol true cli true \</data> \</rpc reply> update license note to update the license, you need to place the license file in the /etc/sonic/lic/ directory beforehand request example to update license via rpc update license \<update license/> response example \<rpc reply xmlns="urn\ ietf\ params\ xml\ ns\ netconf\ base 1 0" message id="urn\ uuid 90228ddf 2cbc 4d64 895b cc135051e210"> \<ok/> \</rpc reply> get supported timezones request example to get supported timezone via rpc show supported timezones \<show supported timezones/> response example \<rpc reply xmlns="urn\ ietf\ params\ xml\ ns\ netconf\ base 1 0" message id="urn\ uuid\ dd07584a 43f9 4036 8488 653dc46d48f2"> \<data>africa/abidjan\</data> \<data>africa/accra\</data> \<! the time zones in the middle have been omitted > \<data>wet\</data> \<data>zulu\</data> \</rpc reply>
