Merge pull request #177 from DMTF/Fix176-SEL-Tool

Added 'rf_sel.py' script to simplify the ability for a user to find the SEL on a service

Author: mraineri

README.md

@@ -61,13 +61,15 @@ You may install the external modules by running:
 * [Sensor List (rf_sensor_list.py)](https://github.com/DMTF/Redfish-Tacklebox/blob/main/docs/rf_sensor_list.md)
 * [System Inventory (rf_sys_inventory.py)](https://github.com/DMTF/Redfish-Tacklebox/blob/main/docs/rf_sys_inventory.md)
 * [Logs (rf_logs.py)](https://github.com/DMTF/Redfish-Tacklebox/blob/main/docs/rf_logs.md)
+* [SEL (rf_sel.py)](https://github.com/DMTF/Redfish-Tacklebox/blob/main/docs/rf_sel.md)
 * [Power/Reset (rf_power_reset.py)](https://github.com/DMTF/Redfish-Tacklebox/blob/main/docs/rf_power_reset.md)
 * [Boot Override (rf_boot_override.py)](https://github.com/DMTF/Redfish-Tacklebox/blob/main/docs/rf_boot_override.md)
 * [Virtual Media (rf_virtual_media.py)](https://github.com/DMTF/Redfish-Tacklebox/blob/main/docs/rf_virtual_media.md)
 * [BIOS Settings (rf_bios_settings.py)](https://github.com/DMTF/Redfish-Tacklebox/blob/main/docs/rf_bios_settings.md)
 * [Manager Configuration (rf_manager_config.py)](https://github.com/DMTF/Redfish-Tacklebox/blob/main/docs/rf_manager_config.md)
 * [Accounts (rf_accounts.py)](https://github.com/DMTF/Redfish-Tacklebox/blob/main/docs/rf_accounts.md)
 * [Update (rf_update.py)](https://github.com/DMTF/Redfish-Tacklebox/blob/main/docs/rf_update.md)
+* [Firmware Inventory (rf_firmware_inventory.py)](https://github.com/DMTF/Redfish-Tacklebox/blob/main/docs/rf_firmware_inventory.md)
 * [Event Service (rf_event_service.py)](https://github.com/DMTF/Redfish-Tacklebox/blob/main/docs/rf_event_service.md)
 * [Licenses (rf_licenses.py)](https://github.com/DMTF/Redfish-Tacklebox/blob/main/docs/rf_licenses.md)
 * [Certificates (rf_certificates.py)](https://github.com/DMTF/Redfish-Tacklebox/blob/main/docs/rf_certificates.md)

docs/rf_sel.md

@@ -0,0 +1,45 @@
+# SEL (rf_sel.py)
+
+Copyright 2019-2025 DMTF.  All rights reserved.
+
+## About
+
+A tool to manage the SEL on a Redfish service.
+
+## Usage
+
+```
+usage: rf_sel.py [-h] --user USER --password PASSWORD --rhost RHOST
+                 [--details] [--clear] [--debug]
+
+A tool to manage the SEL on a Redfish service
+
+required arguments:
+  --user USER, -u USER  The user name for authentication
+  --password PASSWORD, -p PASSWORD
+                        The password for authentication
+  --rhost RHOST, -r RHOST
+                        The address of the Redfish service (with scheme)
+
+optional arguments:
+  -h, --help            show this help message and exit
+  --details, -details   Indicates details to be shown for each log entry
+  --clear, -clear       Indicates if the log should be cleared
+  --debug               Creates debug file showing HTTP traces and exceptions
+```
+
+The tool will log into the service specified by the *rhost* argument using the credentials provided by the *user* and *password* arguments.
+It will then attempt to locate the SEL via the following logic:
+
+* It will iterate through each log service found in each manager and each system.
+* The first log service found where `LogEntryType` contains `SEL` is considered the SEL for the service.
+
+Once the SEL is found, the tool will either perform the `ClearLog` action if *clear* is provided, or read and display the log entries.
+
+Example:
+
+```
+$ rf_sel.py -u root -p root -r https://192.168.1.100
+  Id    | Timestamp                 | Message
+  1     | 2012-03-07T14:44:00Z      | System May be Melting
+```

redfish_utilities/__init__.py

@@ -33,6 +33,8 @@
 from .licenses import delete_license
 from .logs import log_container
 from .logs import diagnostic_data_types
+from .logs import get_log_service_ids
+from .logs import get_log_service
 from .logs import get_log_entries
 from .logs import print_log_entries
 from .logs import clear_log_entries
@@ -138,6 +140,8 @@
     "delete_license",
     "log_container",
     "diagnostic_data_types",
+    "get_log_service_ids",
+    "get_log_service",
     "get_log_entries",
     "print_log_entries",
     "clear_log_entries",