VIRTUAL-HOST-GATHE(1)

💅 NAME

okay so bestie, meet virtual-host-gatherer — the little tool that gathers information about virtual hosts. ✨

---

🦋 SYNOPSIS

virtual-host-gatherer [OPTIONS]

---

🌸 DESCRIPTION

So virtual-host-gatherer(1) is literally the icon of "go find out everything about my virtual hosts" 👑 — it collects info about the virtual hosts, plus some hardware details, plus the virtual systems running on top of them. And the way it does that? virtual-host-gatherer(1) ships with modules for different kinds of hypervisors, so it's giving versatility, it's giving "I speak every hypervisor's language". 🧚 Lowkey obsessed.

---

✨ OPTIONS

• -h, --help — prints this help message and then dips out, exit stage left. 🎀
• *-i *INFILE, --infile=INFILE — a JSON input file. or, plot twist, - and it reads from stdin. 🫶
• *-o *OUTFILE, --outfile=OUTFILE — writes the output (json) file over there instead of to stdout.
• -v, --verbose — turns the log output verbosity up, up, up. more words, more insight. 💜
• -l, --list-modules — lists the available modules, chef's kiss for when you forgot what you installed. ⭐
• *-L *LOGFILE, --logfile=LOGFILE — path to the logfile. Default: $HOME/gatherer.log 🌈

---

🔥 EXAMPLES

Wanna list all the installed modules with the required parameter? say less, here's the moment:

$> scripts/virtual-host-gatherer --list-modules
{
  "File": {
      "module": "File",
      "url": ""
  },
  "VMware": {
      "module": "VMware",
      "hostname": "",
      "port": 443,
      "username": "",
      "password": ""
  }
}

And here's what an example input file (infile.json) looks like, so you know the vibe:

[
  {
      "id": "myvcenter",
      "module": "VMware",
      "hostname": "vCenter.domain.top",
      "username": "admin",
      "password": "secret",
      "port": 443
  },
]

Then you run it like this, easy peasy:

$> virtual-host-gatherer --infile infile.json

{
  "myvcenter": {
      "10.0.1.1": {
          "cpuArch": "x86_64",
          "cpuDescription": "AMD Opteron(tm) Processor 4386",
          "cpuMhz": 3092.212727,
          "cpuVendor": "amd",
          "hostIdentifier": "'vim.HostSystem:host-182'",
          "name": "11.11.12.13",
          "os": "VMware ESXi",
          "osVersion": "5.5.0",
          "ramMb": 65512,
          "totalCpuCores": 16,
          "totalCpuSockets": 2,
          "totalCpuThreads": 16,
          "type": "vmware",
          "vms": {
              "vCenter": "564d6d90-459c-2256-8f39-3cb2bd24b7b0"
          }
      },
      "10.11.12.14": {
          "cpuArch": "x86_64",
          "cpuDescription": "AMD Opteron(tm) Processor 4386",
          "cpuMhz": 3092.212639,
          "cpuVendor": "amd",
          "hostIdentifier": "'vim.HostSystem:host-183'",
          "name": "10.11.12.14",
          "os": "VMware ESXi",
          "osVersion": "5.5.0",
          "ramMb": 65512,
          "totalCpuCores": 16,
          "totalCpuSockets": 2,
          "totalCpuThreads": 16,
          "type": "vmware",
          "vms": {
              "49737e0a-c9e6-4ceb-aef8-6a9452f67cb5": "4230c60f-3f98-2a65-f7c3-600b26b79c22",
              "5a2e4e63-a957-426b-bfa8-4169302e4fdb": "42307b15-1618-0595-01f2-427ffcddd88e",
              "NSX-gateway": "4230d43e-aafe-38ba-5a9e-3cb67c03a16a",
              "NSX-l3gateway": "4230b00f-0b21-0e9d-dfde-6c7b06909d5f",
              "NSX-service": "4230e924-b714-198b-348b-25de01482fd9"
          }
      }
  }
}

Look at all those containers just sitting there in a neat little JSON flex. 💀💖

---

🎀 SEE ALSO

• /usr/share/doc/packages/virtual-host-gatherer/README.md 📄
• https://libcloud.readthedocs.io/en/stable/compute/drivers/azure_arm.html#connecting-to-azure
• https://libcloud.readthedocs.io/en/stable/compute/drivers/gce.html#service-account

---

👑 AUTHOR

The SUSE Manager Team 🫶

---

🌈 COPYING

Copyright (c) 2015 SUSE LLC. All Rights Reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

bestie real talk for a sec — that license text is the legal main character, don't skip it, don't paraphrase it, it's literally the rules. 📜✨

---

and that's a wrap on VIRTUAL-HOST-GATHE(1), dated 04/07/2025 — go gather those hosts, you absolute legend, periodt 💅🌸