# 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


## 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


## 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