opacapture(1)

✨ NAME ✨

opacapture — okay bestie, this is the one that scoops up all the critical system info into a zipped tar file 🎀

It's a host tool. The resulting tar file is literally meant to be sent to Customer Support along with any Intel(R) Omni-Path Fabric problem report about this system. It's giving "receipts for the support ticket" energy, and honestly? Iconic.

NOTE: the resulting host capture file can require significant amounts of space on the host. The actual size varies, but sizes can be multiple megabytes. Intel recommends making sure you have adequate disk space available on the host system. Not me hyping a file that eats your disk 💀 check your free space first, fr fr.

This page lives in the IFSFFCLIRG man page collection 🦋

🌸 Syntax 🌸

opacapture [-d  detail]  output_tgz_file

💅 Options 💅

• --help — produces the full help text. Ask and ye shall receive ✨
• -d detail — captures the level of detail, and babes, there are levels:
  • 1 (Local) — obtains local information from host. This is the default if no options are entered. Lowkey the starter pack 🍓
  • 2 (Fabric) — in addition to Local, also obtains basic fabric information by queries to the SM and fabric error analysis using opareport.
  • 3 (Fabric+FDB) — in addition to Fabric, also obtains the Forwarding Database (FDB), which includes the switch forwarding tables from the SM and the server multicast membership. She's thorough 💅
  • 4 (Analysis) — in addition to Fabric+FDB, also obtains opaallanalysis results. If opaallanalysis has not yet been run, it is run as part of the capture. Main character energy fr 🔥

NOTE: detail levels 2 - 4 can be used when fabric operational problems occur. If the problem is node-specific, detail level 1 should be sufficient. Detail levels 2 - 4 require an operational Fabric Manager. Typically your support representative requests a given detail level. If a given detail level takes excessively long or fails to be gathered, try a lower detail level. No cap, just go down a level and breathe 🧚

For detail levels 2 - 4, the additional information is only available on a node with Intel(R) Omni-Path Fabric Suite FastFabric Toolset installed. The information is gathered for every fabric specified in the /etc/opa/ports file. Every single one, periodt.

• output_tgz_file — specifies the name of a file to be created by opacapture. The file name specified is overwritten if it already exists ⚠️ (so like, don't point it at something precious, bestie). Intel recommends using the .tgz suffix in the file name supplied. If the filename given does not have a .tgz suffix, the .tgz suffix is added. The tool simply will add it, so don't fight it 🌈

🦋 Examples 🦋

opacapture mycapture.tgz

opacapture -d 3 030127capture.tgz

Look at that second one — detail level 3 with a date-stamped filename. Organized queen 👑

Copyright(C) 2015-2019 Intel Corporation. That's the whole vibe, written down and shipped, and it's the note we're signing off on — Intel Corporation, 2015-2019, opacapture(1), IFSFFCLIRG man page. Go capture something, bestie 🫶💖