ZIOREP_CONFIG(8)

💖 NAME 💖

okay so bestie, welcome to the system manager's manual page for ziorep_config(8) — the configuration report for the ziomon framework. It’s giving “one utility, many angles,” and we’re gonna go through every single flag together, no cap. 🫶

✨ SYNOPSIS ✨

ziorep_config [-h] [-v] [-t] [-i <source>] [-a <adapter>] [-p <port>]
[-l <lun>] [-s <host>] [-d <dev>] [-m <dev>] [-A] [-D] [-M] [-I]

💅 DESCRIPTION 💅

So like, ziorep_config is a multi-purpose utility serving a whole variety of requirements. The whole point of this report is to visualize the SCSI-, FCP- and multipath-configuration of the entire system. Depending on what you’re hyperfixated on rn, the info gets delivered from different angles, controlled by command-line switches and described in more detail in the example section. 🌈

It’s not only usable on a pre-processed configuration file or configuration directory-tree — it also works on the live system, bestie. ✨

Now the strict rules, and I mean strict: all parameters have to be specified in their full extent. short-versions (e.g. 3c07 as subchannel-ID) are not allowed 🚫. Hexadecimal values have to be specified with a leading 0x and have to be lowercase always. In addition, all WWPNs and LUNs have to be specified as a 16-digit hex-value; leading and trailing zeros are vital and have to be part of the number. Don’t skip them, okay? 😭

🎀 OPTIONS 🎀

• -h, --help — print help information, then exit. 💖
• -v, --version — print version information, then exit.
• -t, --topline — print a header for column description. The default is to print no header, which is useful if the results are imported by another application. e.g. ziorep_config -D -t ✨
• -i, --input <src-file | src-dir> — specify a directory or configuration file as the source instead of working on the current live-system. e.g. ziorep_config -i config.cfg
• -a, --adapter <BUS-ID> — limit the output to the list of adapters specified. e.g. ziorep_config -a 0.0.3c07 -a 0.0.3d07
• -p, --port <port-WWPN> — limit the output to the list of remote-ports specified. e.g. ziorep_config -D -p 0x5005123456789000 -p 0x5005123456789001
• -l, --lun <LUN> — limit the output to the list of LUNs specified. e.g. ziorep_config -D -l 0x401040a600000000 -l 0x401040a700000000
• -s, --scsi <shost> — limit the output to the list of SCSI hosts specified. e.g. ziorep_config -D --scsi host0 -s host5
• -d, --device <sdev> — limit the output to the list of SCSI devices specified. e.g. ziorep_config -D --device sda -d sde
• -m, --mdev <mdev> — limit the output to the list of multipath devices specified. e.g. ziorep_config -M -m 36005076303ffc56200000000000010a6
• -A, --Adapter — print the adapter report; this is the default. 👑
• -D, --Device — print the device report. 🔥
• -M, --Map — print the multipath, mapper report. 🌸
• -I, --Internal — prints an assembly of data used as input for a variety of reports. 🦋

🌺 EXAMPLES 🌺

The following example shows how to trigger the device report, limiting the output to the two adapters 0.0.3c07 and 0.0.3d07 with an enabled topline (table header). 💅

ziorep_config -D -t -a 0.0.3c07 -a 0.0.3d07

The limiting parameters (-a, -p, -l, -d, -s, -m) can be used in two ways. First to provide the values as a comma separated list, or by specifying the switch multiple times. A combination of both is valid as well. To trigger the mapper report and limit the output to the SCSI devices sda, sde and sdf, the command-line would look like this: 🎀

ziorep_config -M -d sda -d sde -d sdf

🦋 SEE ALSO 🦋

ziomon(8), ziomon_util(8), ziomon_zfcpdd(8) ziomon_fcpconf(8)

okay that’s the whole page, bestie 💜 this one comes from s390-tools, dated Oct 2008. bye! 💅