xref: /openbmc/pldm/tools/visualize-pdr/README.md (revision 4d99c311)
1# Overview
2
3The `pldmtool` for `GetPDR` command lacks to display all PDRs at once. It
4fetches only one PDR at a time. With a lot of sensors/effecters & with a lot of
5Host FRU pdrs coming in due to concurrent maintenance of the system,where the
6fru's are added/ removed at runtime, it's really necessary to have a full system
7view.
8
9`pldm_visualise_pdrs.py` is a python script that can be used to fetch the PDR's
10from the BMC and can parse them to display a full view of available PDR's on
11system at any given point in time.
12
13# Requirements
14
15- Python 3.6+
16- graphviz
17  - Graphviz is open source graph visualization software. Graph visualization is
18    a way of representing structural information as diagrams of abstract graphs
19    and networks.
20  - There are standard package availabe for graphviz for both rpm based as well
21    as the debian based sytems, it can be installed using :
22
23```bash
24   RPM Distro : sudo dnf install graphviz
25   Debian Distro : sudo apt install graphviz
26   Mac Distro : brew install graphviz
27```
28
29- The `requirements.txt` file should list all Python libraries that the tool
30  depend on, and that can be installed using:
31
32```bash
33    sudo pip3 install -r requirements.txt
34              (or)
35    pip3 install -r requirements.txt --user
36```
37
38# Usage
39
40```ascii
41usage: pldm_visualise_pdrs.py [-h] --bmc BMC --user USER --password PASSWORD [--port PORT]
42
43optional arguments:
44  -h, --help           show this help message and exit
45  --bmc BMC            BMC IPAddress/BMC Hostname
46  --user USER          BMC username
47  --password PASSWORD  BMC Password
48  --port PORT          BMC SSH port
49
50```
51