ESX/ESXi 中用于收集诊断信息的“vm-support”命令
search cancel

ESX/ESXi 中用于收集诊断信息的“vm-support”命令

book

Article ID: 343523

calendar_today

Updated On:

Products

VMware vSphere ESXi

Issue/Introduction

免责声明:本文为“vm-support” command in ESX/ESXi to collect diagnostic information (1010705) 的翻译版本。尽管我们会不断努力为本文提供最佳翻译版本,但本地化的内容可能会过时。有关最新内容,请参见英文版本。



VMware 技术支持会在处理支持请求时按惯例要求您提供诊断信息。此诊断信息包含产品特定的日志、配置文件和各种情况对应的数据。此信息通过适用于每个产品的特定脚本或工具进行收集,可能包含来自 ESXi 主机的主机支持包和 vCenter Server 支持包。在主机支持包中收集的数据可能被视为敏感数据。另外,从 vSphere 6.5 起,支持包中还会包含来自 ESXi 主机的加密信息。有关支持包中所包含信息的详细信息,请参见 Data collected when gathering diagnostic information from vSphere products (2147388)

本文提供使用 vm-support 命令行实用程序获取 VMware ESXi/ESX 主机的诊断信息的步骤。有关收集相同信息的其他方法,请参见 Collecting diagnostic information for VMware ESXi/ESX using the vSphere Client (653)Collecting diagnostic information for VMware ESXi/ESX using the vSphere PowerCLI (1027932)

按照本文所述获取的诊断信息将上载给 VMware 技术支持。为了唯一地标识您的信息,请使用在创建新的支持请求 (SR) 时收到的 SR 编号。



Symptoms:


Environment

VMware ESX 4.0.x
VMware vSphere ESXi 5.5
VMware ESX Server 2.5.x
VMware ESX 4.1.x
VMware ESXi 3.5.x Embedded
VMware vSphere ESXi 5.1
VMware vSphere ESXi 5.0
VMware ESXi 4.1.x Embedded
VMware ESXi 4.1.x Installable
VMware ESXi 3.5.x Installable
VMware vSphere ESXi 6.0
VMware ESXi 4.0.x Installable
VMware ESXi 4.0.x Embedded
VMware ESX Server 3.5.x
VMware vSphere ESXi 6.5
VMware ESX Server 3.0.x

Resolution

VMware ESXi/ESX 的所有版本中均提供了命令行vm-support实用程序,但该实用程序可用的某些选项因版本而异。

在 ESXi/ESX 主机上的控制台会话中运行 vm-support

使用vm-support命令行实用程序这一传统方法会在主机上本地生成用 gzip 压缩的原始码(.tgz文件)。可以使用 FTP、SCP 或其他方法从主机复制生成的文件。

  1. 将控制台打开到 ESX 或 ESXi 主机。有关详细信息,请参见 Unable to connect to an ESX host using Secure Shell (SSH) (1003807)Tech Support Mode for Emergency Support (1003677)Using Tech Support Mode in ESXi 4.1 (1017910)

  2. 运行以下命令:

    vm-support

    注意:可以指定其他选项自定义日志包收集。对于给定版本的 ESXi/ESX 上可用的选项列表,请使用vm-support -h命令。

  3. 生成压缩的日志包,并将其存储在扩展名为.tgz的文件中,放在以下位置之一:

    • /var/tmp/
    • /var/log/
    • 当前的工作目录
    • 要将日志包导出到共享 vmfs 数据存储,请使用此命令:

      vm-support -f -w /vmfs/volumes/DATASTORE_NAME

    注意:-f选项在 ESXi 5.x、ESXi/ESX 4.1 Update 3 及更高版本中不可用。

  4. 将日志包收集并下载到客户端后,将日志上载到 SFTP/FTP 站点。有关详细信息,请参见 Uploading diagnostic information to VMware (1008525)

通过流的方式传输 ESXi 5.x 和 6.0 主机中的 vm-support 输出

从 ESXi 5.0 开始,vm-support命令行实用程序支持通过流的方式将内容传输到标准输出。这允许通过 SSH 连接发送内容,而无需在 ESXi 主机上本地保存任何内容。

  1. 启用通过 SSH 访问 ESXi Shell。有关详细信息,请参见 vSphere Installation and Setup guide 中的“使用直接控制台用户界面启用 ESXi Shell 和SSH 访问”部分。

  2. 使用 Linux 或 Posix 客户端(如 vSphere Management Assistant 设备)登录到 ESXi 主机并运行启用了流选项的vm-support命令,指定新的本地文件。将在客户端上的以下指定位置生成压缩日志包。例如:

    ssh root@ESXHostnameOrIPAddressvm-support -s >vm-support-Hostname.tgz

    注意:这需要您输入 root 帐户的密码,但是无法用于锁定模式。

  3. 您还可以使用同一个命令将支持日志包定向到所需的数据存储位置(提到目标路径)。例如:

    ssh root@ESXHostnameOrIPAddress'vm-support -s >/vmfs/volumes/datastorexxx/vm-support-Hostname.tgz'

  4. 日志包已收集并下载到客户端后,将日志上载到 SFTP/FTP 站点。有关详细信息,请参见 Uploading diagnostic information to VMware (1008525)


从 ESXi 5.x 和 6.0 主机中基于 HTTP 下载 vm-support 输出

从 ESXi 5.0 开始,可通过 HTTP 调用vm-support命令行实用程序。这允许使用 Web 浏览器或命令行工具(如wgetcurl)下载内容。
  1. 使用任何 HTTP 客户端,从以下位置下载资源:

    https://ESXHostnameOrIPAddress/cgi-bin/vm-support.cgi

    例如,在 Linux 或其他 Posix 客户端(如 vSphere Management Assistant 设备)上使用wget实用程序下载资源。将在客户端上的以下指定位置生成压缩日志包:

    wget https://10.11.12.13/cgi-bin/vm-support.cgi

  2. 在收集日志包并将其下载到客户端后,将日志上载到 SFTP/FTP 站点。有关详细信息,请参见 Uploading diagnostic information to VMware (1008525)


Additional Information

某些版本的 VMware ESX 2.x 和 3.x 有vm-support命令行实用程序的更新。确保每个 ESX 主机上的vm-support版本是最新的。列出的最低版本提供了在向 VMware 提供支持信息时为保护数据安全所需的改进。有关这些安全改进的详细信息,请参见 Data Security Best Practices - SSL keys for communicating with Virtual Center and other applications (1008166)

确认 vm-support 实用程序的版本确认您的vm-support版本至少是针对您的 ESXi/ESX 版本列出的版本:

  • ESX Server 2.5.5 需要 1.15 或更高版本
  • ESX Server 3.0.x 需要 1.29 或更高版本
  • ESXi/ESX Server 3.5 需要 1.30 或更高版本
  • ESXi/ESX Server 4.x 需要 1.29 或更高版本
  • ESXi Server 5.x 需要 2.0 或更高版本

要查看您的系统上所安装的版本,请运行不带选项的vm-support命令,然后取消收集,或运行命令vm-support --version。例如:

  • [user@esxhost]$ cd /tmp
    [user@esxhost]$ vm-support

    VMware ESX Server Support Script0.94

    Preparing Files: |

    [Ctrl+C to cancel]


  • [user@esxhost]$ vm-support --version
    vm-support v2.0


更新 ESX 上的 vm-support 实用程序的版本要更新 ESX 主机上的vm-support实用程序,请执行以下操作:

  1. 打开 ESX 主机的控制台。有关详细信息,请参见 Unable to connect to an ESX host using Secure Shell (SSH) (1003807)
  2. 确认安装的vm-support实用程序的版本。
  3. 使用以下命令备份现有的vm-support实用程序:

    cp /usr/bin/vm-support /usr/bin/vm-support.old

  4. 下载适合您的 VMware ESX 版本的文件并将其放在 ESX 系统的服务控制台中的/tmp/目录内。

    注意:运行该下载之前,请阅读 接受条款通知

    软件版本版本下载位置md5sum
    ESX 2.5.51.15http://download3.vmware.com/software/vi/
    ESX255-vm-support.tar
    5f148445d3f02caa5e5946c389dc41ed
    ESX 3.0.11.29http://download3.vmware.com/software/vi/
    ESX301-vm-support.tgz
    bbb5e11ee6166775c81ab152d01068a8
    ESX 3.0.21.29http://download3.vmware.com/software/vi/
    ESX302-vm-support.tar
    395184ab520cbf8f8d8de5fd9b5920e4
    ESX 3.0.31.29http://download3.vmware.com/software/vi/
    ESX303-vm-support.tar
    798e0185ba86b49d0ed1e90deff84e6a
    ESX 3.51.30http://download3.vmware.com/software/vi/
    ESX35Classic-vm-support.tar
    11af1759471892c240376cdf1e7a4ad0
    ESXi/ESX 4.x1.29ESXi/ESX 4 的 vm-support 为最新版本,没有可用更新。
    ESXi 5.x2.0ESXi/ESX 5 的 vm-support 为最新版本,没有可用更新。

  5. 运行以下命令解压缩存档文件:

    tar xvzffilename.tgz

  6. 确认附件中vm-support文件的 MD5 总和与上表中列出的软件版本的值匹配。例如:

    md5sum vm-support

    11af1759471892c240376cdf1e7a4ad0 vm-support

  7. vm-support 实用程序复制到 /usr/bin/ 目录,替换原始 vm-support 脚本。

    注意:如果在较早版本的 ESX 上运行,更新后的脚本可能报告有关缺少命令的错误。

接受条款通知注意事项:下载、安装、复制或以其他任何方式使用这些内核模块(包括驱动程序、插件或更新)即表示您将遵照 VMWARE ESX 最终用户许可协议 (“EULA”) 的条款理解并同意将这些模块视为软件相关的组件,且您对这些内核模块的使用受 EULA 条款的制约。如果您不同意这些条款,则不能下载、安装、复制或使用这些内核模块。“您”是指同意受这些条款约束的自然人或者实体及其员工,以及为您提供服务的第三方签约者。若这些员工和第三方签约者存在任何不遵守本协议条款的情况,您需为此承担责任。


有关详细信息,请参见 Collecting performance snapshots using vm-support in ESX and ESXi (1967)

“vm-support” command in ESX/ESXi to collect diagnostic information
在 ESX 和 ESXi 中使用 vm-support 收集性能快照