ntsimulator/yang/x-ran/xran-troubleshooting.yang

   1 module xran-troubleshooting {
   2   yang-version 1.1;
   3   namespace "urn:xran:troubleshooting:1.0";
   4   prefix "xran-trblsht";
   5
   6   organization "xRAN Forum";
   7
   8   contact
   9     "www.xran.org";
  10
  11   description
  12     "This module defines the operations for the troubleshooting logs on the RU.
  13
  14     Copyright 2018 the xRAN Forum.
  15
  16     THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS'
  17     AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18     IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19     ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
  20     LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  21     CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  22     SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  23     INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  24     CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  25     ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  26     POSSIBILITY OF SUCH DAMAGE.
  27
  28     Redistribution and use in source and binary forms, with or without
  29     modification, are permitted provided that the following conditions are met:
  30
  31     * Redistributions of source code must retain the above copyright notice,
  32     this list of conditions and the above disclaimer.
  33     * Redistributions in binary form must reproduce the above copyright notice,
  34     this list of conditions and the above disclaimer in the documentation
  35     and/or other materials provided with the distribution.
  36     * Neither the Members of the xRAN Forum nor the names of its
  37     contributors may be used to endorse or promote products derived from
  38     this software without specific prior written permission.";
  39
  40   revision "2018-07-20" {
  41     description
  42       "version 1.0.0 - First release of the xRAN YANG M-Plane models.
  43
  44       This version of the model supports v01.00 of the corrsponding xRAN
  45       M-Plane Specification.";
  46     reference "XRAN-FH.MP.0-v01.00";
  47   }
  48
  49
  50   grouping troubleshooting-status-grouping {
  51     description "grouping used for troubleshooting RPCs";
  52     leaf status {
  53       type enumeration {
  54         enum SUCCESS {
  55           description "rpc completed correctly";
  56         }
  57         enum FAILURE {
  58           description "rpc failed";
  59         }
  60       }
  61       description "result of rpc operation";
  62     }
  63     leaf failure-reason {
  64       when "../status = 'FAILURE'";
  65       type string;
  66       description "free form text description why error occurred";
  67     }
  68   }
  69
  70   rpc start-troubleshooting-logs {
  71     description
  72       "Management plane triggered to start collecting the troubleshooting logs files of RU.";
  73       output {
  74         uses troubleshooting-status-grouping;
  75       }
  76   }
  77
  78   rpc stop-troubleshooting-logs {
  79     description
  80       "Management plane triggered to stop collecting the troubleshooting logs files of RU.";
  81       output {
  82         uses troubleshooting-status-grouping;
  83       }
  84   }
  85
  86   notification troubleshooting-log-generated {
  87     description
  88       "When new log file generated, send this notification.";
  89     leaf-list log-file-name {
  90       type string;
  91       description
  92         "The list of troubleshooting log file names on the RU.";
  93     }
  94   }
  95 }