Skip to content

Commit 10b4c88

Browse files
committed
Updating notes for 1.0.0
1 parent e36d5aa commit 10b4c88

File tree

3 files changed

+13
-6
lines changed

3 files changed

+13
-6
lines changed

AUTHORS.md

+1-3
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,3 @@
1-
21
# Original Contribution:
3-
* Majec Systems
42

5-
# Other Key Contributions:
3+
* Majec Systems

CHANGELOG.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
1-
21
# Change Log
32

3+
## [1.0.0] - 2018-01-26
4+
- Initial release; conformant with version 1.0.0 of DSP0272

README.md

+10-2
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,17 @@
1-
Copyright 2017 Distributed Management Task Force, Inc. All rights reserved.
2-
# Redfish Interop Validator - Version 0.91
1+
Copyright 2017-2018 Distributed Management Task Force, Inc. All rights reserved.
2+
3+
# Redfish Interop Validator
34

45
## About
6+
57
The Redfish Interop Validator is a python3 tool that will validate a service based on an Interoperability profile given to the tool. The purpose of the tool is to guarantee that a specific service is compatible with vendor systems or system tools based on a vendor's specification in a profile.
68

79
## Introduction
10+
811
This tool is designed to accept a profile conformant to the schematics specified by the DMTF Redfish Profile schema, and run against any valid Redfish service for a given device. It is not biased to any specific hardware, only dependent on the current Redfish specification.
912

1013
## Pre-requisites
14+
1115
The Redfish Interop Validator is based on Python 3 and the client system is required to have the Python framework installed before the tool can be installed and executed on the system. Additionally, the following packages are required to be installed and accessible from the python environment:
1216
* beautifulsoup4 - https://pypi.python.org/pypi/beautifulsoup4/4.5.3 (must be <= 4.5.3)
1317
* requests - https://github.com/kennethreitz/requests (Documentation is available at http://docs.python-requests.org/)
@@ -25,9 +29,11 @@ pip3 install beautifulsoup4 --upgrade
2529
There is no dependency based on Windows or Linux OS. The result logs are generated in HTML format and an appropriate browser (Chrome, Firefox, IE, etc.) is required to view the logs on the client system.
2630

2731
## Installation
32+
2833
The RedfishInteropValidator.py into the desired tool root directory. Create the following subdirectories in the tool root directory: "config", "logs", "SchemaFiles". Place the example config.ini file in the "config" directory. Place the CSDL Schema files to be used by the tool in the root of the schema directory, or the directory given in config.ini.
2934

3035
## Execution Steps
36+
3137
The Redfish Interop Validator is designed to execute as a purely command line interface tool with no intermediate inputs expected during tool execution. However, the tool requires various inputs regarding system details, DMTF schema files etc. which are consumed by the tool during execution to generate the conformance report logs. Below are the step by step instructions on setting up the tool for execution on any identified Redfish device for conformance test:
3238

3339
Modify the config\config.ini file to enter the system details under below section
@@ -97,6 +103,7 @@ In order to run without a configuration file, the option --ip must be specified.
97103
python3 RedfishInteropValidator.py profileName --ip host:port [...]
98104

99105
## Execution flow
106+
100107
* 1. Redfish Interop Validator starts with the Service root Resource Schema by querying the service with the service root URI and getting all the device information, the resources supported and their links. Once the response of the Service root query is verified against a given profile (given the profile contains specifications for ServiceRoot), the tool traverses through all the collections and Navigation properties returned by the service.
101108
* 2. For each navigation property/Collection of resource returned, it does following operations:
102109
** i. Reads all the Navigation/collection of resources from the respective resource collection schema file.
@@ -126,6 +133,7 @@ Upon validation of a resource, the following types of tests may occur:
126133
* For collections, validate each property inside of itself, and expects a list rather than a single Property, otherwise validate normally:
127134

128135
## Conformance Logs – Summary and Detailed Conformance Report
136+
129137
The Redfish Interop Validator generates an html report under the “logs” folder, named as The report gives the detailed view of the individual properties checked, with the Pass/Fail/Skip/Warning status for each resource checked for conformance.
130138

131139
There is a verbose log file that may be referenced to diagnose tool or schema problems when the stdout print out is insufficient, located in logs/ConformanceLog_MM_DD_YYYY_HHMMSS.html

0 commit comments

Comments
 (0)