netconf/sal-netconf-connector/src/main/yang/odl-sal-netconf-connector-cfg.yang

   1 module odl-sal-netconf-connector-cfg {
   2     yang-version 1;
   3     namespace "urn:opendaylight:params:xml:ns:yang:controller:md:sal:connector:netconf";
   4     prefix "sal-netconf";
   5
   6     import config { prefix config; revision-date 2013-04-05; }
   7     import threadpool {prefix th;}
   8     import netty {prefix netty;}
   9     import opendaylight-md-sal-dom {prefix dom;}
  10     import opendaylight-md-sal-binding {prefix md-sal-binding; revision-date 2013-10-28;}
  11     import odl-netconf-cfg { prefix cfg-net; revision-date 2014-04-08; }
  12     import ietf-inet-types {prefix inet; revision-date "2013-07-15";}
  13
  14     description
  15         "Config definition for Netconf Connector modules";
  16
  17     revision "2015-08-03" {
  18         description
  19             "Non-mandatory keepalive executor";
  20     }
  21
  22     revision "2013-10-28" {
  23         description
  24             "Initial revision";
  25     }
  26
  27     identity sal-netconf-connector {
  28         base config:module-type;
  29         config:java-name-prefix NetconfConnector;
  30         status deprecated;
  31     }
  32
  33     grouping server {
  34         leaf address {
  35             type string;
  36         }
  37
  38         leaf port {
  39             type uint32;
  40         }
  41     }
  42
  43     augment "/config:modules/config:module/config:configuration" {
  44         status deprecated;
  45         case sal-netconf-connector {
  46             when "/config:modules/config:module/config:type = 'sal-netconf-connector'";
  47
  48             leaf address {
  49                 type inet:host;
  50             }
  51
  52             leaf port {
  53                 type inet:port-number;
  54             }
  55
  56             leaf tcp-only {
  57                 type boolean;
  58             }
  59
  60             leaf username {
  61                 type string;
  62             }
  63
  64             leaf password {
  65                 type string;
  66             }
  67
  68             leaf concurrent-rpc-limit {
  69                 type uint16;
  70                 default 0;
  71                 description "Limit of concurrent messages that can be send before reply messages are received.
  72                              If value less than 1 is provided, no limit will be enforced";
  73             }
  74
  75             leaf schema-cache-directory {
  76                 type string;
  77                 default "schema";
  78                 description "The destination schema repository for yang files relative to the cache directory.  This may be specified per netconf mount
  79                              so that the loaded yang files are stored to a distinct directory to avoid potential conflict.";
  80             }
  81
  82             container yang-module-capabilities {
  83                 leaf override {
  84                     type boolean;
  85                     default false;
  86                     description "Whether to override or merge this list of capabilities with capabilities from device";
  87                 }
  88
  89                 leaf-list capability {
  90                     type string;
  91                     description "Set a list of capabilities to override capabilities provided in device's hello message.
  92                                  Can be used for devices that do not report any yang modules in their hello message";
  93                 }
  94             }
  95
  96             leaf reconnect-on-changed-schema {
  97                 type boolean;
  98                 default false;
  99                 description "If true, the connector would auto disconnect/reconnect when schemas are changed in the remote device.
 100                              The connector subscribes (right after connect) to base netconf notifications and listens for netconf-capability-change notification";
 101             }
 102
 103             container dom-registry {
 104                 uses config:service-ref {
 105                     refine type {
 106                         mandatory false;
 107                         config:required-identity dom:dom-broker-osgi-registry;
 108                     }
 109                 }
 110             }
 111
 112             container binding-registry {
 113                 uses config:service-ref {
 114                     refine type {
 115                         mandatory true;
 116                         config:required-identity md-sal-binding:binding-broker-osgi-registry;
 117                     }
 118                 }
 119             }
 120
 121             container event-executor {
 122                 uses config:service-ref {
 123                     refine type {
 124                         mandatory true;
 125                         config:required-identity netty:netty-event-executor;
 126                     }
 127                 }
 128             }
 129
 130             container processing-executor {
 131                 uses config:service-ref {
 132                     refine type {
 133                         mandatory true;
 134                         config:required-identity th:threadpool;
 135                     }
 136                 }
 137
 138                 description "Makes up for flaws in netty threading design";
 139             }
 140
 141             container client-dispatcher {
 142                 uses config:service-ref {
 143                     refine type {
 144                         mandatory false;
 145                         config:required-identity cfg-net:netconf-client-dispatcher;
 146                     }
 147                 }
 148             }
 149
 150             leaf connection-timeout-millis {
 151                 description "Specifies timeout in milliseconds after which connection must be established.";
 152                 type uint32;
 153                 default 20000;
 154             }
 155
 156             leaf default-request-timeout-millis {
 157                 description "Timeout for blocking operations within transactions.";
 158                 type uint32;
 159                 default 60000;
 160             }
 161
 162             leaf max-connection-attempts {
 163                 description "Maximum number of connection retries. Non positive value or null is interpreted as infinity.";
 164                 type uint32;
 165                 default 0; // retry forever
 166             }
 167
 168             leaf between-attempts-timeout-millis {
 169                 description "Initial timeout in milliseconds to wait between connection attempts. Will be multiplied by sleep-factor with every additional attempt";
 170                 type uint16;
 171                 default 2000;
 172             }
 173
 174             leaf sleep-factor {
 175                 type decimal64 {
 176                     fraction-digits 1;
 177                 }
 178                 default 1.5;
 179             }
 180
 181             // Keepalive configuration
 182             leaf keepalive-delay {
 183                 type uint32;
 184                 default 120;
 185                 description "Netconf connector sends keepalive RPCs while the session is idle, this delay specifies the delay between keepalive RPC in seconds
 186                              If a value less than 1 is provided, no keepalives will be sent";
 187             }
 188
 189             container keepalive-executor {
 190                 uses config:service-ref {
 191                     refine type {
 192                         mandatory false;
 193                         config:required-identity th:scheduled-threadpool;
 194                     }
 195                     refine name {
 196                         mandatory false;
 197                     }
 198                 }
 199
 200                 description "Dedicated solely to keepalive execution";
 201             }
 202
 203             container yang-library {
 204                 leaf yang-library-url {
 205                     config true;
 206                     type inet:uri;
 207                     description "Yang library to be plugged as additional source provider into the shared schema repository";
 208                 }
 209
 210                 // credentials for basic http authentication for get request for yanglib data
 211                 leaf username {
 212                     config true;
 213                     type string;
 214                 }
 215
 216                 leaf password {
 217                     config true;
 218                     type string;
 219                 }
 220             }
 221         }
 222     }
 223 }