list-systems

Output a table of all systems managed by Cloudmin.

When run with no parameters, this command outputs a table of all virtual systems known to Cloudmin. You can limit the display to a subset of systems using the standard options like --host, --type and --owner, have it output all available information with the --multiline parameter, or just show hostnames with --name-only.

To limit the display to only systems that can host virtual systems, use the --host-type flag followed by a virtualization type like xen, openvz or zones. Or if you want to get all host systems, use --host-type all.

To select virtual systems based on their host system, use the --host-on flag followed by a hostname.

Systems can also be selected by their current status, using the --status flag followed by a code like virt (Virtualmin) or down (completely shut down). Special codes that cover a number of statuses are also supported, such as up (running and usable) wm (Webmin installed) and bad (down or in-accessible).

In mutiline mode, uptime, bandwidth, CPU and RAM usage is displayed for the current account period. To show the previous period instead, use the --last-period flag. Or to select any period in the past, use the --period-ago flag followed by a number of weeks or months.

To limit output to the unique IDs of selected systems, use the --id-only flag. To get just hostnames use --name-only,--address-only to print just IP addresses, or --address6-only to print only IPv6 addresses. You can also fetch only system details that can be displayed quickly (without needed to poll the host) with the --simple-multiline flag. To switch output from friendly units (like 10 MB) to just bytes (like 10485760), use the --bytes flag.

Example usage

  cloudmin list-systems --type xen
  Hostname                       Type            Description
  ------------------------------ --------------- ------------------------------
  xencentos.home                 Xen             CentOS 5 on Xen
  xencentos4.home                Xen             Test system with CentOS 4
  xengentoo.home                 Xen             Gentoo on Xen
  xenrails.home                  Xen             Test server for Rails on Xen
  xentemplatecentos.home         Xen             Xen Virtualmin template for Ce
  xentemplatecentos4.home        Xen             Xen template for CentOS 4.4
  xentemplatedebian.home         Xen             Xen Virtualmin template for De
  xentemplatefc6.home            Xen             Xen Virtualmin template for Fe
  xentemplateubuntu.home         Xen             Ubuntu on Xen

Command Line Help

Lists some or all registered managed systems.

cloudmin list-systems [--multiline | --name-only | --id-only |
                       --simple-multiline | --address-only]
                      [--all-hosts] | [--host name]*
                      [--group name]*
                      [--type real|kvm|gce|this]*
                      [--os oscode]*
                      [--owner name]*
                      [--status status-code|"up"|"wm"|"bad"]
                      [--host-type type|"all"]
                      [--host-on name]
                      [--last-period | --period-ago N]
                      [--bytes]