You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+10-2
Original file line number
Diff line number
Diff 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
3
4
4
5
## About
6
+
5
7
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.
6
8
7
9
## Introduction
10
+
8
11
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.
9
12
10
13
## Pre-requisites
14
+
11
15
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:
12
16
* beautifulsoup4 - https://pypi.python.org/pypi/beautifulsoup4/4.5.3 (must be <= 4.5.3)
13
17
* requests - https://github.com/kennethreitz/requests (Documentation is available at http://docs.python-requests.org/)
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.
26
30
27
31
## Installation
32
+
28
33
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.
29
34
30
35
## Execution Steps
36
+
31
37
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:
32
38
33
39
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.
* 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.
101
108
* 2. For each navigation property/Collection of resource returned, it does following operations:
102
109
** 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:
126
133
* For collections, validate each property inside of itself, and expects a list rather than a single Property, otherwise validate normally:
127
134
128
135
## Conformance Logs – Summary and Detailed Conformance Report
136
+
129
137
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.
130
138
131
139
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