---
# System prepended metadata

title: Chapter 9 File Management
tags: [WG4]

---

# Chapter 9 File Management
###### tags: `WG4`

This chapter specifies File Management for the O-RU. Following operations are supported as a File Management.

- **upload**
    - File upload from O-RU to file server triggered by O-RU Controller
- **retrieve file list**
    - O-RU Controller retrieves the file list in O-RU.
- **download**
    - File download from file server to O-RU triggered by O-RU Controller
    - Note: file-download has different purpose with software-download
- **File transfers are done with sFTP.**
    1. Password for RU authentication and list of public keys (DSA/RSA) for sFTP server authentication
    2. Certificate for both RU and sFTP server authentication

## 9.1 File System Structure

The file System structure of the O-RU is represented as a logical structure that is used by the file management procedures defined in the rest of this chapter.

**The O-RU shall support the standardized logical folders:**

- O-RAN/log/
- O-RAN/PM/
- O-RAN/transceiver/
- O-RAN/beamforming/ (if O-RU support beamforming)
- another file vendor support

## 9.2 File Management Operation: upload

Simultaneous multiple file upload operations can be supported under the same sFTP connection between O-RU to the fileserver.

- if the upload numbers are over the limitation that O-RU allowed, O-RU will report failure notification

Following rpc is used for upload operation.

### rpc: file-upload

- input
    - **local-logical-file-path:** the logical path of file to be uploaded (no wildcard is allowed)
    - **remote-file-path:** URI of file on the fileserver
- output (rpc-reply)
    - **status:** whether O-RU accepted or rejected the upload request
    - **reject-reason:** the human readable reason why O-RU rejects the request (only applicable if status is rejected)
- notification
    - **successful:** local-logical  file-path and remote-file-path
    - **failure:** the human readable reason is also replie

![](https://i.imgur.com/MrxiVcg.png)


## 9.3 File Management Operation: retrieve file list

O-RU Controller retrieves the file list from the O-RU

The following rpc is used for retrieve file list operation

**rpc: retrieve-file-list**

- input
    - logical path: the logical path of files to be retrieved (* is allowed as wild-card)
    - file-name-filter: the files which has the “file name filter” in the file name (* is allowed as wild-card)
- output (rpc-reply)
    - status: whether O-RU accepted or rejected the retrieve file list request
    - reject-reason: the human readable reason why O-RU rejects the request (only applicable if status is rejected) file list

![](https://i.imgur.com/LiHulrn.png)

## 9.4 File Management Operation: download

Simultaneous multiple file download operations can be supported under the same sFTP connection between the **O-RU** and **O-DU/SMO.**

The following rpc is used for download operation.

**rpc: file-download**

- input
    - **local-logical-file-path:** the logical path of file to be uploaded (no wildcard is allowed)
    - **remote-file-path:** URI of file on the fileserver
- output (rpc-reply)
    - **status:** whether O-RU accepted or rejected the upload request
    - **reject-reason:** the human readable reason why O-RU rejects the request (only applicable if status is rejected)
- notification
    - **successful:** local-logical  file-path and remote-file-path
    - **failure:** the human readable reason is also replie

![](https://i.imgur.com/vXW6Mcb.png)
