It is very easy to upgrade to YumaPro SDK 21.10.


YumaWorks follows the following strict programming rules that ensure backward compatibility with existing server behavior.


  • No API Changes: Customer facing API functions are never changed. Instead, new variants are added over time as needed.
  • No CLI Changes: Existing CLI parameters are almost never changed. If a CLI parameter has been found to cause operational problems, it might be changed in a future release. 
  • Deprecation before Removal: In the rare case where an existing API or CLI parameter is removed, it will be marked as "deprecated" for at least a year before removal.


If your current release version is 17.10, refer to Upgrading to YumaPro SDK 18.10 first.

If your current release version is 18.10, refer to Upgrading to YumaPro SDK 19.10 first.

If your current release version is 19.10, refer to Upgrading to YumaPro 20.10 first.



Non-Backward Compatible Changes


The following non-backward-compatible changes apply to the YumaPro SDK 21.10 release train:


yangdump-sdk Code Generation Parameters


  • The default value for yangdump-sdk code generation has changed. The EDIT2 and GET2 callback modes are now the default. The following parameters are now redundant and can be omitted:
    • --sil-edit2
    • --sil-get2
  • Previously these parameters were omitted to use the EDIT1 and GET1 callback modes.
    Now the --sil-edit1 or --sil-get1 parameter must be used instead


make_sil_dir Code Generation Parameters

  • The --split parameter is now the default for the make_sil_dir_pro and make_sil_sa_dir scripts.
    • Using --split is now redundant and can be omitted
    • Use the new --no-split parameter to obtain the old behavior


New Features


The following new features are added (so far) to the YumaPro SDK 21.10 release train:

  • yp-grpc: netconfd-pro now supports the gRPC protocol
    • This feature is well isolated and not present unless the WITH_GRPC=1 flag is used in the build
    • It is not present in 21.10 binary packages
    • It is present in 21.10T binary packages
    • The use of this feature in the  21.10 release train is not supported
  • Event Handlers: yangcli-pro now supports notification event handler shell scripts



New Source Code Make Flags


The following source code make flags have been added. Refer to the top-level README file for details:

  • WITH_GRPC=1 : Add gRPC protocol support to netconfd-pro



New netconfd-pro CLI Parameters


The following server CLI parameters have been added. Refer to the YumaPro netconfd-pro User Manual for details:

  • superuser parameter changed from a leaf to a leaf-list to allow multiple superuser accounts
  • with-grpc parameter to enable the yp-grpc protocol feature



Refer to the YumaPro CLI Reference for details on all CLI parameters in the 21.10 release train.



New netconfd-pro YANG Modules


The following YANG modules have been added. Refer to the YumaPro netconfd-pro User Manual for details:

  • yumaworks-grpc-mon [Requires --with-grpc=true] (gRPC monitoring module)
  • yumaworks-yp-grpc: [Requires --with-grpc=true] (Internal module for YControl protocol messages)
  • ietf-yang-structure-ext: YANG Data Structure Extensions 
    • See the YANG Automation Guide for details on using the standard "structure" and "augment-structure" extensions



New yangdump-sdk CLI parameters


The following code generation CLI parameters have been added. Refer to the YumaPro yangdump-pro User Manual and YumaPro Developer Manual for details:

  • sil-edit1 : Enable deprecated EDIT1 callback code generation
  • sil-get1 : Enable deprecated GET1 callback code generation




New yangcli-pro CLI parameters


The following event handler control CLI parameters have been added. Refer to the yangcli-pro CLI Reference for details:

  • autoeventhandlers : Enable automatic event handlers config load and save
  • callhome-user: Changed from a leaf to a leaf-list. 
    • yangcli-pro will go through the list in order when a user fails. If the server retries, the next address will be tried.
    • yp-client has an API so a callback can pick the callhome user, based on the connection.



New yangcli-pro commands


The following event handler commands have been added.  Refer to the yangcli-pro User Manual for details:

  • session-cfg :New parameter called use-event-handler added to this command
  • event-handlers-cfg: Manage all event handlers
  • event-handler-cfg: Manage a single event handler