2 Functions and Concepts
File Management provides a management interface to a logical file system in the Managed Element (ME).
The logical file system exposes files produced by functions on the ME, for example, performance measurement report files and alarm logs. In addition, files can be imported to the logical file system. Such files are located in directories, which are exposed as file groups on the logical file system.
A file group can contain other file groups forming a file group subtree.
File Management enables a mapping between a Managed Object (MO) Distinguished Name (DN) and a path on the logical file system, for example, as follows:
DN:
ManagedElement=NODE06ST,SystemFunctions=1,FileM=1, LogicalFs=1,FileGroup=MyService
For example:
FileGroup=MyService [...] files=MyFile.log [...]
Corresponding path on the logical file system:
/MyService/MyFile.log
A preventive maintenance policy is a routine that can automatically delete files or raise alarms when limits are exceeded. A preventive maintenance policy can be associated with one or more file groups, it is applied recursively to all files and file groups within a file group. File deletion applies either to the newest or the oldest file.
There are three predefined file groups withsystem controlled preventive maintenance policies, and these file groups are:
AlarmLogs
Contains alarm log files. The log has a preventive maintenance policy in which the maximum number of alarm log files is 11 and the size of each alarm log file is restricted to 500 KB. The log is a wrap log where the oldest file is overwritten at log wrapping. This is controlled by the log service housekeeping policy. For more information on alarms, refer to Fault Management.
AlertLogs
Contains alert log files. The log has a preventive maintenance policy in which the maximum number of log files is 11 and the size of each alert log file is restricted to 500 KB. The alert log is a wrap log where the oldest file is overwritten at log wrapping. This is controlled by the log service housekeeping policy. For more information on alerts, refer to Fault Management.
PerformanceManagementReportFiles
Contains the Performance Management (PM) report files. The report file has a default preventive maintenance policy in which the maximum number of PM report files is 1000. If the preventive maintenance limit is exceeded, the oldest file is automatically deleted. This provided by PM internal housekeeping.
File Management policies are only to be applied to file groups that are not already subject to specific system controlled or user-defined preventive maintenance policies.
The files and file groups in the logical file system can be accessed through the Ericsson Command-Line Interface (ECLI), NETCONF, and the standard SSH File Transfer Protocol (SFTP).
| Note: |
Special characters, such as + in filenames, appear as ?? in the ECLI. For more information, refer to Interwork Description Ericsson Command-Line Interface. |
Types of Operation
File Management supports the following operations:
Access to a logical file system through the MOM, based on security rules
Depending on security rules, a user can create or delete file groups and manually delete files in the logical file system. For more information, see Security Management.
Access to a logical file system over SFTP, based on security rules
This operation can be used by Northbound Interface (NBI) clients (such as OSS, LCT, and CLI script), which must fetch files from the logical file system. The procedure in Fetch File in Logical File System provides further details on how to perform this operation. Depending on security management rules, all or part of the SFTP protocol operations can be allowed. For more information, see Security Management.
Definition, modification, and deletion of preventive maintenance file group policies
The following file group policies can be defined:
Automatic deletion, where files are deleted automatically when a limit is exceeded. Files can be deleted when the number of files in a file group subtree, or the size of a file group subtree reaches or exceeds a limit.
Automatic deletion, where each file in a file group subtree is kept a maximum specified time.
Automatic alarm reporting, where an alarm is raised when a limit defined in a configured monitoring threshold is exceeded. An alarm can be raised when the number of files in a file group subtree, or the size of a file group subtree exceeds a limit. The alarm informs the user that manual maintenance is required. The ME raises the alarms File Management, Number of Files in FileGroup Exceeded and File Management, Max Size in FileGroup Exceeded to indicate these conditions.
The procedures in Configure Preventive Maintenance Policy Deleting Files in Logical File System and Configure Preventive Maintenance Policy Reporting Alarms for Logical File System provide further details on how to perform these operations.
3 Managed Object Model
The File Management managed area is represented in the MOM as follows:
ManagedElement
+-SystemFunctions
+-FileM
+-FileGroupPolicy
+-ThresholdMonitoring
+-LogicalFs
+-FileGroup
+-FileGroup
For general information about the MOM, MOCs, MOs, cardinality, and related concepts, refer to Managed Object Model User Guide.
The File Management MOCs are described in Table 1.
|
Managed Object Class |
Description |
|---|---|
|
The root of the File Management model. |
|
|
Contains the preventive maintenance rules for file groups. |
|
|
Contains the configured monitoring thresholds. |
|
|
The root of the logical file system. |
|
|
Contains the file groups. A file group can contain another file group or a file. Represents a directory in the logical file system. |
4 Configuration Management
5 Fault Management
6 Security Management
Access to the logical file system is configured through security management rules.
The permission types in Table 3 can be applied by setting rules to FileGroup instances.
|
Permission Type |
Description |
|---|---|
|
NO_ACCESS |
The file group is invisible to the user. |
|
R (read) |
The file group and its contained FileInformation instances are visible to the user. The user can export files from the group. |
|
RW (read and write) |
The file group and its contained FileInformation instances are visible to the user. The user can set writable attributes of a FileGroup instance. The user can import and export files into/from the group. |
|
RWX (read, write, and execute) |
The file group and its contained FileInformation instances are visible to the user. The user can set writable attributes and execute actions of a FileGroup instance. The user can import and export files into/from the group. When using SFTP for transfer of files, all operations offered by the protocol are possible to execute without restrictions. |

Contents