zfcp_disk_configure(8)

💅 zfcp_disk_configure(8) — the System Manager's Manual page, but make it make sense 💅

okay bestie, so this is zfcp_disk_configure, a page straight out of the System Manager's Manual, and it's literally about plugging zfcp-attached SCSI Logical Units in and out of your life. sit down, get a snack, we're doing this 🍓

---

✨ NAME ✨

zfcp_disk_configure — configures or deconfigures a zfcp-attached SCSI Logical Unit (LU). yes. that's the whole gig. slay 💅

---

🌸 SYNOPSIS 🌸

zfcp_disk_configure ccwid wwpn lun online

four arguments, in that exact order, no swapping, no vibes-based ordering 🙈

---

🦋 DESCRIPTION 🦋

so zfcp_disk_configure exists to make it easy to persistently add and remove zfcp-attached SCSI Logical Units. persistent is the main character word here — it's not just a "for now" kinda thing.

besides bringing the LU online or offline, it also creates or deletes the necessary udev rules for that LU. so it's doing the whole glow-up and writing down how to recreate it. iconic 🔥

---

🎀 PARAMETERS 🎀

• ccwid — the device number of the zFCP adapter. it's shaped like x.y.ssss, and here's the breakdown, no cap:
  • x is always 0 — like, until IBM creates something that actually uses that number. so… 0 for now 💀
  • y is the subchannel set ID (SSID). most often this is 0, but it could be non-zero. don't assume, bestie.
  • ssss is the four digit device address of the subchannel, in hexadecimal, with leading zeros. and if you type it in upper/mixed case, it gets automatically converted to lower case. the tool is doing your homework for you 🫶
• wwpn — the World Wide Port Number of the storage array in which the LUN resides. it's a 16 digit hexadecimal number of the form 0x0123456789abcdef. you must get this number from the administrator of the storage array. no guessing, no "I think it was…", go ask them 🙈
• lun — the Logical Unit Number of the specific disk in the storage array. also a 16 digit hexadecimal number of the form 0x0123456789abcdef. also must come from the administrator of the storage array. and here's the ⚠️ trap: some storage array administrator interfaces display the LUN in decimal, and you must convert it to hexadecimal to use it in this command. do not skip this step, bestie, it will not be cute.
• online — either a literal 1 to attach the LU or a literal 0 to detach the LU. literally one character. that's it. 1 or 0, nothing else 💀

---

💖 FILES 💖

please see the documentation of chzdev. that's the whole section, she's lowkey mysterious like that 🧚

---

🌈 ENVIRONMENT 🌈

• DEBUG — if set to "yes" some minimal debugging information is output during execution. minimal! don't expect a novel. 📖

---

👑 DIAGNOSTICS 👑

messages and return codes are determined by the chzdev command. and if the environment variable DEBUG is set to "yes," it shows you the command line of the invoked chzdev. so like, you can literally see what it ran. observed. 🔍

---

💀 BUGS 💀

gotta be some, I'm sure. and if you find one, please open a bug report. that's it, that's the whole section — the author kept it real fr fr 😭

---

⭐ SEE ALSO ⭐

zfcp_host_configure(8), zfcp_san_disc(8), chzdev(8)

---

and that's the page, bestie 🎀 this little number ships with s390-tools, dated February 2013 — vintage but still serving 💜 go configure some disks, you've got this ✨