openconfig-system

Model for managing system-wide services and functions on network devices. Portions of this code were derived from IETF RFC 7317...

  • Version: 2020-03-25

    openconfig-system@2020-03-25


    
      module openconfig-system {
    
        yang-version 1;
    
        namespace
          "http://openconfig.net/yang/system";
    
        prefix oc-sys;
    
        import openconfig-inet-types {
          prefix oc-inet;
        }
        import openconfig-yang-types {
          prefix oc-yang;
        }
        import openconfig-types {
          prefix oc-types;
        }
        import openconfig-extensions {
          prefix oc-ext;
        }
        import openconfig-aaa {
          prefix oc-aaa;
        }
        import openconfig-system-logging {
          prefix oc-log;
        }
        import openconfig-system-management {
          prefix oc-sys-mgmt;
        }
        import openconfig-system-terminal {
          prefix oc-sys-term;
        }
        import openconfig-procmon {
          prefix oc-proc;
        }
        import openconfig-alarms {
          prefix oc-alarms;
        }
        import openconfig-messages {
          prefix oc-messages;
        }
        import openconfig-license {
          prefix oc-license;
        }
    
        organization "OpenConfig working group";
    
        contact
          "OpenConfig working group
        netopenconfig@googlegroups.com";
    
        description
          "Model for managing system-wide services and functions on
        network devices.
    
        Portions of this code were derived from IETF RFC 7317.
        Please reproduce this note if possible.
    
        IETF code is subject to the following copyright and license:
        Copyright (c) IETF Trust and the persons identified as authors of
        the code.
        All rights reserved.
    
        Redistribution and use in source and binary forms, with or without
        modification, is permitted pursuant to, and subject to the license
        terms contained in, the Simplified BSD License set forth in
        Section 4.c of the IETF Trust's Legal Provisions Relating
        to IETF Documents (http://trustee.ietf.org/license-info).";
    
        revision "2020-03-25" {
          description
            "Fix typo in description statement for ipv4-address
          list.";
          reference
            "0.9.1";
    
        }
    
        revision "2020-01-07" {
          description
            "Add import of license management model.";
          reference
            "0.9.0";
    
        }
    
        revision "2019-03-15" {
          description
            "Update boot time to be nanoseconds since epoch.";
          reference
            "0.8.0";
    
        }
    
        revision "2019-01-29" {
          description
            "Add messages module to the system model";
          reference
            "0.7.0";
    
        }
    
        revision "2018-11-21" {
          description
            "Add OpenConfig module metadata extensions.";
          reference
            "0.6.1";
    
        }
    
        revision "2018-07-17" {
          description "Add gRPC server data";
          reference
            "0.6.0";
    
        }
    
        revision "2018-01-21" {
          description "Add cpu utilization data";
          reference
            "0.5.0";
    
        }
    
        revision "2017-12-15" {
          description
            "Add alarms to the system model";
          reference
            "0.4.0";
    
        }
    
        revision "2017-09-18" {
          description
            "Updated to use OpenConfig types modules";
          reference
            "0.3.0";
    
        }
    
        revision "2017-07-06" {
          description
            "Move to oc-inet types, add IETF attribution, add RADIUS
          counters, changed password leaf names to indicate hashed";
          reference
            "0.2.0";
    
        }
    
        revision "2017-01-29" {
          description "Initial public release";
          reference
            "0.1.0";
    
        }
    
        oc-ext:openconfig-version "0.9.1";
        oc-ext:regexp-posix;
        oc-ext:catalog-organization "openconfig";
        oc-ext:origin "openconfig";
    
        identity NTP_AUTH_TYPE {
          description
            "Base identity for encryption schemes supported for NTP
          authentication keys";
        }
    
        identity NTP_AUTH_MD5 {
          base NTP_AUTH_TYPE;
          description "MD5 encryption method";
        }
    
        typedef timezone-name-type {
          type string;
          description
            "A time zone name as used by the Time Zone Database,
           sometimes referred to as the 'Olson Database'.
    
           The exact set of valid values is an implementation-specific
           matter.  Client discovery of the exact set of time zone names
           for a particular server is out of scope.";
          reference
            "BCP 175: Procedures for Maintaining the Time Zone Database";
    
        }
    
        grouping system-clock-config {
          description
            "Configuration data for system-wide clock configuration";
          leaf timezone-name {
            type timezone-name-type;
            description
              "The TZ database name to use for the system, such
             as 'Europe/Stockholm'.";
            reference
              "IANA Time Zone Database
              http://www.iana.org/time-zones";
    
          }
        }  // grouping system-clock-config
    
        grouping system-clock-state {
          description
            "Operational state data for system-wide clock configuration";
        }  // grouping system-clock-state
    
        grouping system-clock-top {
          description
            "Top-level grouping for system-wide clock configuration";
          container clock {
            description
              "Top-level container for clock configuration data";
            container config {
              description
                "Configuration data for system clock";
              uses system-clock-config;
            }  // container config
    
            container state {
              config false;
              description
                "Operational state data for system clock";
              uses system-clock-config;
    
              uses system-clock-state;
            }  // container state
          }  // container clock
        }  // grouping system-clock-top
    
        grouping system-global-config {
          description
            "system-wide configuration parameters";
          leaf hostname {
            type oc-inet:domain-name;
            description
              "The hostname of the device -- should be a single domain
            label, without the domain.";
          }
    
          leaf domain-name {
            type oc-inet:domain-name;
            description
              "Specifies the domain name used to form fully qualified name
            for unqualified hostnames.";
          }
    
          leaf login-banner {
            type string;
            description
              "The console login message displayed before the login prompt,
            i.e., before a user logs into the system.";
          }
    
          leaf motd-banner {
            type string;
            description
              "The console message displayed after a user logs into the
            system.  They system may append additional standard
            information such as the current system date and time, uptime,
            last login timestamp, etc.";
          }
        }  // grouping system-global-config
    
        grouping system-global-state {
          description
            "Global operational state data for the system";
          leaf current-datetime {
            type oc-yang:date-and-time;
            description
              "The current system date and time.";
          }
    
          leaf boot-time {
            type oc-types:timeticks64;
            units "nanoseconds";
            description
              "This timestamp indicates the time that the system was last
              restarted.  The value is the timestamp in nanoseconds relative
              to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).";
          }
        }  // grouping system-global-state
    
        grouping system-dns-config {
          description
            "DNS / resolver related configuration data";
          leaf-list search {
            type oc-inet:domain-name;
            ordered-by user;
            description
              "An ordered list of domains to search when resolving
            a host name.";
          }
        }  // grouping system-dns-config
    
        grouping system-dns-state {
          description
            "Operational state data for system DNS resolver";
        }  // grouping system-dns-state
    
        grouping system-dns-servers-config {
          description
            "Configuration data for DNS resolvers";
          leaf address {
            type oc-inet:ip-address;
            description
              "The address of the DNS server, can be either IPv4
            or IPv6.";
          }
    
          leaf port {
            type oc-inet:port-number;
            default '53';
            description
              "The port number of the DNS server.";
          }
        }  // grouping system-dns-servers-config
    
        grouping system-dns-static-config {
          description
            "Configuration data for static host entries";
          leaf hostname {
            type string;
            description
              "Hostname for the static DNS entry";
          }
    
          leaf-list alias {
            type string;
            description
              "Additional aliases for the hostname";
          }
    
          leaf-list ipv4-address {
            type oc-inet:ipv4-address;
            description
              "List of IPv4 addresses for the host entry";
          }
    
          leaf-list ipv6-address {
            type oc-inet:ipv6-address;
            description
              "List of IPv6 addresses for the host entry";
          }
        }  // grouping system-dns-static-config
    
        grouping system-dns-static-state {
          description
            "Operational state data for static host entries";
        }  // grouping system-dns-static-state
    
        grouping system-dns-static-top {
          description
            "Top-level grouping for static DNS host entries";
          container host-entries {
            description
              "Enclosing container for list of static host entries";
            list host-entry {
              key "hostname";
              description
                "List of static host entries";
              leaf hostname {
                type leafref {
                  path "../config/hostname";
                }
                description
                  "Reference to the hostname list key";
              }
    
              container config {
                description
                  "Configuration data for static host entries";
                uses system-dns-static-config;
              }  // container config
    
              container state {
                config false;
                description
                  "Operational state data for static host entries";
                uses system-dns-static-config;
    
                uses system-dns-static-state;
              }  // container state
            }  // list host-entry
          }  // container host-entries
        }  // grouping system-dns-static-top
    
        grouping system-dns-servers-state {
          description
            "Operational state data for DNS resolvers";
        }  // grouping system-dns-servers-state
    
        grouping system-dns-servers-top {
          description
            "Top-level grouping for the list of DNS resolvers.";
          container servers {
            description
              "Enclosing container for DNS resolver list";
            list server {
              key "address";
              ordered-by user;
              description
                "List of the DNS servers that the resolver should query.
    
               When the resolver is invoked by a calling application, it
               sends the query to the first name server in this list.  If
               no response has been received within 'timeout' seconds,
               the resolver continues with the next server in the list.
               If no response is received from any server, the resolver
               continues with the first server again.  When the resolver
               has traversed the list 'attempts' times without receiving
               any response, it gives up and returns an error to the
               calling application.
    
               Implementations MAY limit the number of entries in this
               list.";
              leaf address {
                type leafref {
                  path "../config/address";
                }
                description
                  "References the configured address of the DNS server";
              }
    
              container config {
                description
                  "Configuration data for each DNS resolver";
                uses system-dns-servers-config;
              }  // container config
    
              container state {
                config false;
                description
                  "Operational state data for each DNS resolver";
                uses system-dns-servers-config;
    
                uses system-dns-servers-state;
              }  // container state
            }  // list server
          }  // container servers
        }  // grouping system-dns-servers-top
    
        grouping system-dns-top {
          description
            "Top-level grouping for DNS / resolver config and operational
          state data";
          container dns {
            description
              "Enclosing container for DNS resolver data";
            container config {
              description
                "Configuration data for the DNS resolver";
              uses system-dns-config;
            }  // container config
    
            container state {
              config false;
              description
                "Operational state data for the DNS resolver";
              uses system-dns-config;
    
              uses system-dns-state;
            }  // container state
    
            uses system-dns-servers-top;
    
            uses system-dns-static-top;
          }  // container dns
        }  // grouping system-dns-top
    
        grouping system-ntp-server-config {
          description
            "Configuration data for NTP servers";
          leaf address {
            type oc-inet:host;
            description
              "The address or hostname of the NTP server.";
          }
    
          leaf port {
            type oc-inet:port-number;
            default '123';
            description
              "The port number of the NTP server.";
          }
    
          leaf version {
            type uint8 {
              range "1..4";
            }
            default '4';
            description
              "Version number to put in outgoing NTP packets";
          }
    
          leaf association-type {
            type enumeration {
              enum "SERVER" {
                value 0;
                description
                  "Use client association mode.  This device
                 will not provide synchronization to the
                 configured NTP server.";
              }
              enum "PEER" {
                value 1;
                description
                  "Use symmetric active association mode.
                 This device may provide synchronization
                 to the configured NTP server.";
              }
              enum "POOL" {
                value 2;
                description
                  "Use client association mode with one or
                 more of the NTP servers found by DNS
                 resolution of the domain name given by
                 the 'address' leaf.  This device will not
                 provide synchronization to the servers.";
              }
            }
            default 'SERVER';
            description
              "The desired association type for this NTP server.";
          }
    
          leaf iburst {
            type boolean;
            default 'false';
            description
              "Indicates whether this server should enable burst
            synchronization or not.";
          }
    
          leaf prefer {
            type boolean;
            default 'false';
            description
              "Indicates whether this server should be preferred
            or not.";
          }
        }  // grouping system-ntp-server-config
    
        grouping system-ntp-server-state {
          description
            "Operational state data for NTP servers";
          leaf stratum {
            type uint8;
            description
              "Indicates the level of the server in the NTP hierarchy. As
            stratum number increases, the accuracy is degraded.  Primary
            servers are stratum while a maximum value of 16 indicates
            unsynchronized.  The values have the following specific
            semantics:
    
            | 0      | unspecified or invalid
            | 1      | primary server (e.g., equipped with a GPS receiver)
            | 2-15   | secondary server (via NTP)
            | 16     | unsynchronized
            | 17-255 | reserved";
            reference
              "RFC 5905 - Network Time Protocol Version 4: Protocol and
              Algorithms Specification";
    
          }
    
          leaf root-delay {
            type uint32;
            units "milliseconds";
            description
              "The round-trip delay to the server, in milliseconds.";
            reference
              "RFC 5905 - Network Time Protocol Version 4: Protocol and
              Algorithms Specification";
    
          }
    
          leaf root-dispersion {
            type uint64;
            units "milliseconds";
            description
              "Dispersion (epsilon) represents the maximum error inherent
            in the measurement";
            reference
              "RFC 5905 - Network Time Protocol Version 4: Protocol and
              Algorithms Specification";
    
          }
    
          leaf offset {
            type uint64;
            units "milliseconds";
            description
              "Estimate of the current time offset from the peer.  This is
            the time difference between the local and reference clock.";
          }
    
          leaf poll-interval {
            type uint32;
            units "seconds";
            description
              "Polling interval of the peer";
          }
        }  // grouping system-ntp-server-state
    
        grouping system-ntp-server-top {
          description
            "Top-level grouping for the list of NTP servers";
          container servers {
            description
              "Enclosing container for the list of NTP servers";
            list server {
              key "address";
              description
                "List of NTP servers to use for system clock
              synchronization.  If '/system/ntp/enabled'
              is 'true', then the system will attempt to
              contact and utilize the specified NTP servers.";
              leaf address {
                type leafref {
                  path "../config/address";
                }
                description
                  "References the configured address or hostname of the
                NTP server.";
              }
    
              container config {
                description
                  "Configuration data for an NTP server.";
                uses system-ntp-server-config;
              }  // container config
    
              container state {
                config false;
                description
                  "Operational state data for an NTP server.";
                uses system-ntp-server-config;
    
                uses system-ntp-server-state;
              }  // container state
            }  // list server
          }  // container servers
        }  // grouping system-ntp-server-top
    
        grouping system-ntp-auth-keys-config {
          description "Configuration data ";
          leaf key-id {
            type uint16;
            description
              "Integer identifier used by the client and server to
            designate a secret key.  The client and server must use
            the same key id.";
          }
    
          leaf key-type {
            type identityref {
              base NTP_AUTH_TYPE;
            }
            description
              "Encryption type used for the NTP authentication key";
          }
    
          leaf key-value {
            type string;
            description
              "NTP authentication key value";
          }
        }  // grouping system-ntp-auth-keys-config
    
        grouping system-ntp-auth-keys-state {
          description
            "Operational state data for NTP auth key data";
        }  // grouping system-ntp-auth-keys-state
    
        grouping system-ntp-auth-keys-top {
          description
            "Top-level grouping for NTP auth key data";
          container ntp-keys {
            description
              "Enclosing container for list of NTP authentication keys";
            list ntp-key {
              key "key-id";
              description
                "List of NTP authentication keys";
              leaf key-id {
                type leafref {
                  path "../config/key-id";
                }
                description
                  "Reference to auth key-id list key";
              }
    
              container config {
                description
                  "Configuration data for NTP auth keys";
                uses system-ntp-auth-keys-config;
              }  // container config
    
              container state {
                config false;
                description
                  "Operational state data for NTP auth keys";
                uses system-ntp-auth-keys-config;
    
                uses system-ntp-auth-keys-state;
              }  // container state
            }  // list ntp-key
          }  // container ntp-keys
        }  // grouping system-ntp-auth-keys-top
    
        grouping system-ntp-config {
          description
            "Configuration data for system-wide NTP operation.";
          leaf enabled {
            type boolean;
            default 'false';
            description
              "Enables the NTP protocol and indicates that the system should
            attempt to synchronize the system clock with an NTP server
            from the servers defined in the 'ntp/server' list.";
          }
    
          leaf ntp-source-address {
            type oc-inet:ip-address;
            description
              "Source address to use on outgoing NTP packets";
          }
    
          leaf enable-ntp-auth {
            type boolean;
            default 'false';
            description
              "Enable or disable NTP authentication -- when enabled, the
            system will only use packets containing a trusted
            authentication key to synchronize the time.";
          }
        }  // grouping system-ntp-config
    
        grouping system-ntp-state {
          description
            "Operational state data for system-wide NTP operation.";
          leaf auth-mismatch {
            type oc-yang:counter64;
            description
              "Count of the number of NTP packets received that were not
            processed due to authentication mismatch.";
          }
        }  // grouping system-ntp-state
    
        grouping system-ntp-top {
          description
            "Top-level grouping for configuration and state data for NTP";
          container ntp {
            description
              "Top-level container for NTP configuration and state";
            container config {
              description
                "Configuration data for NTP client.";
              uses system-ntp-config;
            }  // container config
    
            container state {
              config false;
              description
                "Operational state data for NTP services.";
              uses system-ntp-config;
    
              uses system-ntp-state;
            }  // container state
    
            uses system-ntp-auth-keys-top;
    
            uses system-ntp-server-top;
          }  // container ntp
        }  // grouping system-ntp-top
    
        grouping system-memory-config {
          description
            "Configuration data for system memory";
        }  // grouping system-memory-config
    
        grouping system-memory-state {
          description
            "Operational state data for system memory";
          leaf physical {
            type uint64;
            units "bytes";
            description
              "Reports the total physical memory available on the
            system.";
          }
    
          leaf reserved {
            type uint64;
            units "bytes";
            description
              "Memory reserved for system use";
          }
        }  // grouping system-memory-state
    
        grouping system-memory-top {
          description
            "Top-level grouping for system memory data definitions";
          container memory {
            description
              "Top-level container for system memory data";
            container config {
              description
                "Configuration data for system memory";
              uses system-memory-config;
            }  // container config
    
            container state {
              config false;
              description
                "Operational state data for system memory";
              uses system-memory-config;
    
              uses system-memory-state;
            }  // container state
          }  // container memory
        }  // grouping system-memory-top
    
        grouping system-cpu-state {
          description
            "Operational state data for the system CPU(s)";
          leaf index {
            type union {
              type enumeration {
                enum "ALL" {
                  value 0;
                  description
                    "Index value indicating all CPUs in the system";
                }
              }
              type uint32;
            }
            description
              "The CPU index for each processor core on the system.  On a
            single-core system, the index should be zero.  The ALL
            index signifies an aggregation of the CPU utilization
            statistics over all cores in the system.";
          }
    
          container total {
            description "Total CPU utilization.";
            uses oc-types:avg-min-max-instant-stats-pct;
          }  // container total
    
          container user {
            description
              "Percentage of CPU time spent running in user space.";
            uses oc-types:avg-min-max-instant-stats-pct;
          }  // container user
    
          container kernel {
            description
              "Percentage of CPU time spent running in kernel space.";
            uses oc-types:avg-min-max-instant-stats-pct;
          }  // container kernel
    
          container nice {
            description
              "Percentage of CPU time spent running low-priority (niced)
            user processes.";
            uses oc-types:avg-min-max-instant-stats-pct;
          }  // container nice
    
          container idle {
            description
              "Percentage of CPU time spent idle.";
            uses oc-types:avg-min-max-instant-stats-pct;
          }  // container idle
    
          container wait {
            description
              "Percentage of CPU time spent waiting for I/O.";
            uses oc-types:avg-min-max-instant-stats-pct;
          }  // container wait
    
          container hardware-interrupt {
            description
              "Percentage of CPU time spent servicing hardware interrupts.";
            uses oc-types:avg-min-max-instant-stats-pct;
          }  // container hardware-interrupt
    
          container software-interrupt {
            description
              "Percentage of CPU time spent servicing software interrupts";
            uses oc-types:avg-min-max-instant-stats-pct;
          }  // container software-interrupt
        }  // grouping system-cpu-state
    
        grouping system-cpu-top {
          description
            "Top-level grouping for system CPU data";
          container cpus {
            config false;
            description
              "Enclosing container for the list of CPU cores on the
            system";
            list cpu {
              key "index";
              description
                "List of CPU cores on the system (including logical CPUs
              on hyperthreaded systems), keyed by either a numerical
              index, or the ALL value for an entry representing the
              aggregation across all CPUs.";
              leaf index {
                type leafref {
                  path "../state/index";
                }
                description
                  "Reference to list key";
              }
    
              container state {
                description
                  "Operational state data for the system CPU(s)";
                uses system-cpu-state;
              }  // container state
            }  // list cpu
          }  // container cpus
        }  // grouping system-cpu-top
    
        grouping system-top {
          description
            "Top level system data containers";
          container system {
            description
              "Enclosing container for system-related configuration and
            operational state data";
            container config {
              description
                "Global configuration data for the system";
              uses system-global-config;
            }  // container config
    
            container state {
              config false;
              description
                "Global operational state data for the system";
              uses system-global-config;
    
              uses system-global-state;
            }  // container state
    
            uses system-clock-top;
    
            uses system-dns-top;
    
            uses system-ntp-top;
    
            uses oc-sys-mgmt:system-grpc-server-top;
    
            uses oc-sys-term:system-ssh-server-top;
    
            uses oc-sys-term:system-telnet-server-top;
    
            uses oc-log:logging-top;
    
            uses oc-aaa:aaa-top;
    
            uses system-memory-top;
    
            uses system-cpu-top;
    
            uses oc-proc:procmon-processes-top;
    
            uses oc-alarms:alarms-top;
    
            uses oc-messages:messages-top;
    
            uses oc-license:license-top;
          }  // container system
        }  // grouping system-top
    
        uses system-top;
      }  // module openconfig-system
    

© 2023 YumaWorks, Inc. All rights reserved.