1 module o-ran-file-management {
3 namespace "urn:o-ran:file-management:1.0";
4 prefix "o-ran-file-mgmt";
6 import ietf-crypto-types {
11 organization "O-RAN Alliance";
17 "This module defines the configuration and operations for handling upload.
19 Copyright 2019 the O-RAN Alliance.
21 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS'
22 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
25 LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26 CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27 SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28 INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31 POSSIBILITY OF SUCH DAMAGE.
33 Redistribution and use in source and binary forms, with or without
34 modification, are permitted provided that the following conditions are met:
36 * Redistributions of source code must retain the above copyright notice,
37 this list of conditions and the above disclaimer.
38 * Redistributions in binary form must reproduce the above copyright notice,
39 this list of conditions and the above disclaimer in the documentation
40 and/or other materials provided with the distribution.
41 * Neither the Members of the O-RAN Alliance nor the names of its
42 contributors may be used to endorse or promote products derived from
43 this software without specific prior written permission.";
45 revision "2019-06-05" {
49 1) backward compatible changes according to NOK-0002 sFTP Server Authentication Correction.
50 2) minor fixes according to lack of descriptions";
52 reference "ORAN-WG4.M.0-v01.00";
55 revision "2019-03-07" {
59 1) backward compatible changes to introduce groupings.";
61 reference "ORAN-WG4.M.0-v01.00";
64 revision "2019-02-04" {
68 1) imported model from xRAN
69 2) changed namespace and reference from xran to o-ran";
71 reference "ORAN-WG4.M.0-v01.00";
74 grouping file-path-grouping {
75 description "Complete logical path of the file to upload/download
76 (no wildcard is allowed) ex : /o-RAN/log/syslog.1";
78 leaf local-logical-file-path {
81 description "Local logical file path";
84 leaf remote-file-path {
87 description "URI specifying the remote-file-path on O-DU/NMS.
88 Format:sftp://<username>@<host>[:port]/path";
92 grouping output-status-grouping {
93 description "Status grouping";
102 description "Operation status";
106 when "../status = 'FAILURE'";
112 grouping credential-information {
113 description "Type of authentication to use for SFTP upload or download.";
122 "password needed for O-RU authentication.";
125 "password for O-RU authentication method in use";
131 uses ct:public-key-grouping;
133 "List of allowed algorithms with its keys";
136 "Key for sFTP server authentication";
140 container certificate {
143 "certificate authentication method in use";
150 grouping retrieve-input {
151 description "Grouping for information retrieval RPC input";
155 description "O-RAN unit of which the files are to be listed.
156 ex : O-RAN/log, o-RAN/PM, O-RAN/transceiver";
158 leaf file-name-filter {
160 description "Filter which are to be applied on the result list of file names (* is allowed as wild-card).";
164 grouping retrieve-output {
165 description "Grouping for information retrieval RPC output";
166 uses output-status-grouping;
167 leaf-list file-list {
168 when "../status = 'SUCCESS'";
170 description "List of files in the unit with the filter applied.";
177 description "File upload over SFTP from equipment to NETCONF client";
179 uses file-path-grouping;
180 uses credential-information;
183 uses output-status-grouping;
187 rpc retrieve-file-list {
188 description "List all the files in the logical O-RAN unit (* is allowed as wild-card).";
194 uses retrieve-output;
198 notification file-upload-notification {
199 uses file-path-grouping;
200 uses output-status-grouping;
206 "Management plane triggered to generate the download file of O-RU.";
208 uses file-path-grouping;
209 uses credential-information;
212 uses output-status-grouping;
216 notification file-download-event {
217 uses file-path-grouping;
218 uses output-status-grouping;