如何向红帽支持提供文件 (vmcore、rhev logcollector、sosreport、堆转储、日志文件等)

Resolution

内容

1. 通过客户门户网站上传文件
2. 在归档创建过程中自动上传 sos 报告
3. 红帽支持工具
4. 安全 FTP
5. 将文件拆分为几部分进行上传
6. 计算文件摘要

通过客户门户网站上传文件

现在，您可以将最大为 250GB 的文件直接上传到客户门户网站。不再需要使用单独的机制来上传大的文件。请参阅通过门户网站 UI 附加文件，以便通过红帽客户门户网站附加文件。

IE 浏览器存在一个已知的问题，当上传时间超过 15 分钟时会出现超时的问题。这只有在上传非常大的文件时才会发生。如果您需要提供非常大的文件，请使用 Chrome/Firefox，或使用 FTP，直到相关的修复可用为止。

在归档创建过程中自动上传 sos 报告

从 sos-3.9 及之后的版本开始，sos 支持使用 --upload 选项以在生成存档后自动上传存档。请注意，存档的本地副本仍然存在。

当在 Red Hat Enterprise Linux 系统中运行时，使用 --upload 选项会提示用户输入其客户门户网站（Customer Portal）凭证：

# sosreport --upload

sosreport (version 4.2)

[...]

Please enter the case id that you are generating this report for []: 123456
Enter your Red Hat Customer Portal username (empty to use public dropbox): your-username
Please provide the upload password for your-username: 

[...]

Your sosreport has been generated and saved in:
    /var/tmp/sosreport-myhost-123456-2022-08-11-sgczqyo.tar.xz

Attempting upload to Red Hat Customer Portal
Uploaded archive successfully

通过提供一个问题单号和登录凭证（登陆凭证用于访问指定的问题单），sos 会在运行完成后将生成的存档直接上传到相应的问题单中。如果其中的任一信息没有提供或不正确（例如，提供的凭证单号和凭证不匹配），则 sos 会将存档上传到红帽的安全 FTP 服务器：

# sos report --upload

sosreport (version 4.2)

[...]

Please enter the case id that you are generating this report for []: 123456
Enter your Red Hat Customer Portal username (empty to use public dropbox): incorrect-user
Please provide the upload password for your-username: 

[...]

Your sosreport has been generated and saved in:
    /var/tmp/sosreport-myhost-123456-2022-08-11-hyrtzji.tar.xz

Attempting upload to Red Hat Customer Portal
Upload to Red Hat Customer Portal failed. Trying sftp://sftp.access.redhat.com
Attempting upload to Red Hat Secure FTP
Unable to retrieve Red Hat auth token using provided credentials. Will try anonymous.
User 'xAnrDdnP'used for anonymous upload. Please inform your support engineer so they may retrieve the data.
Uploaded archive successfully

备注：在以上实例中使用了一个匿名用户进行上传，它是一个不能重复使用的临时用户，您必须告知红帽的支持工程师这个匿名用户的具体用户名，以便支持工程师获取并检查您上传的存档。

可以使用以下方法之一提供 --upload 凭证：

1. 如上面的演示所示，使用 --upload，这会要求用户以互动方式提供凭证
2. 使用 --upload-user 和 --upload-pass 以在无需系统提示的情况下提供凭证信息。当在运行 sos report 时使用了 --batch 选项时，这个方法非常有用。但请注意，这会导致收集到的进程信息集合中可能会包括明文形式的密码，如 ps。
3. 使用 SOSUPLOADUSER 和/或 SOSUPLOADPASSWORD 环境变量。如果设置这这个环境变量，--upload 功能将不会要求用户输入凭证信息，这些环境变量的值也不会出现在存档中的任何集合中。

红帽支持工具

备注：对于有效的 RHEL 7 和 RHEL 8 版本，红帽支持工具的更新版本（从 redhat-support-tool >= 0.13.0 开始）已解决了对每个上传文件大小的 1GB 限制。现在，大于 1GB 的文件也可以直接上传到问题单中。这个问题记录在 RHBZ Bug 1765392 中，并已通过 RHBA-2022:0623 修复。

备注：对于 RHEL 6，上传的每个文件的大小仍有 1GB 的限制，RHEL 6 构建将很快停止工作。详情请查看此解决方案

备注：从 RHEL 9 开始，将不再提供 redhat-support-tool

• 直接上传到问题单 ：要直接从您的系统上传文件，您还可以使用 红帽支持工具 (redhat-support-tool)。它为您提供了相关的灵活性并提供脚本编写功能。上传文件（如 sosreport）的最简单方法是：

  $ redhat-support-tool addattachment -c CASE_NUMBER /path/to/sosreport
  

对于大型文件，您可以使用 -s 选项。这只有在您的带宽较窄，或您所在机构对文件传输有连接时间/连接超时的限制才需要这样做。

备注：请参阅 Red Hat Access：红帽支持工具，了解有关 redhat-support-tool 的完整信息，包括安装说明。

• 通过 Red Hat Secure FTP 将文件上传到问题单：

  • 这会将您的文件直接上传到客户门户网站。如果您希望要过 Red Hat Secure FTP 上传，请使用 "-f" 选项：

    $ redhat-support-tool addattachment -c CASE_NUMBER -f /path/to/sosreport
    

  • 分割文件并上传到安全 FTP ：这个方法已不再被支持。详情请查看 RHEL 8.5 发行注记。

安全 FTP

红帽提供了一个新的 Secure FTP 平台：sftp.access.redhat.com

新平台取代了传统的 dropbox.redhat.com 文件共享平台，它为客户提供了一个可持续的、跨平台、命令行可访问的端点，以便客户向红帽上传文件。新的安全 FTP 可用于将文件附加到支持问题单，并可以在支持问题单以外与红帽共享文件。"Red Hat Secure FTP - 用户指南"中包括了如何使用新的 Secure FTP 平台的信息。

将文件拆分为几部分进行上传

有些客户在向红帽上传 50GB vmcore 文件时没有出现问题，但其他客户可能会在上传文件超过 1-2GB 时有问题。文件大小、或网络拥塞、或其他问题可能会导致文件无法稳定上传，并最终导致上传无法成功完成。 对于上传失败，通常需要重新从文件的开头进行恢复。

如果过去因为文件大小、网络稳定性或其他问题，在将文件上传到门户或 redhat-support-tool （或 FTP）时遇到问题，，可以将文件分割为几个部分，并分别上传这些分割后的部分。当前，我们建议在将大文件（如 vmcore）拆分为几个部分时，分割文件的块大小可以从 1GB 作为起点。 如果仍然失败，则可以将其缩小到 512m，然后重试。

• split 命令可用于将大型文件分成较小的块，以便上传到 dropbox.redhat.com，或上传到红帽客户门户网站中的支持问题单中。 如果单个块上传失败，则只需要重新上传该块。

  • 例如，以下命令将一个大的 8.5GiB vmcore 文件分成 9 个较小的文件，以进行上传。 -b 1024m 命令行选项将分割文件大小限制为最大 1024MB (1GiB)。

    # ls -ltrh largefile.tar.xz
    -rw-rw-r--. 1 root    root    8.5G Feb 20 13:54 largefile.tar.xz
    # split -b 1024m -a 2 -d largefile.tar.xz largefile.tar.xz.part
    # ls -ltrh largefile.tar.xz.*
    -rw-rw-r--. 1 root root 1.0G Feb 21 10:01 largefile.tar.xz.part00
    -rw-rw-r--. 1 root root 1.0G Feb 21 10:01 largefile.tar.xz.part01
    -rw-rw-r--. 1 root root 1.0G Feb 21 10:01 largefile.tar.xz.part02
    -rw-rw-r--. 1 root root 1.0G Feb 21 10:01 largefile.tar.xz.part03
    -rw-rw-r--. 1 root root 1.0G Feb 21 10:01 largefile.tar.xz.part04
    -rw-rw-r--. 1 root root 1.0G Feb 21 10:01 largefile.tar.xz.part05
    -rw-rw-r--. 1 root root 1.0G Feb 21 10:01 largefile.tar.xz.part06
    -rw-rw-r--. 1 root root 1.0G Feb 21 10:02 largefile.tar.xz.part07
    -rw-rw-r--. 1 root root 508M Feb 21 10:02 largefile.tar.xz.part08
    

  • 可以使用 cat 命令重新组合这些部分。

    # ls -1c -v largefile.tar.xz.part* | xargs -I {} cat {} >> largefile.tar.xz
    

  • 详情请查看 man split。

计算文件摘要

• 要计算您上传的文件的 MD5 消息摘要，请运行

   $ md5sum [filename]
  

• 或者，要计算您上传的文件的 SHA1 消息摘要，请运行

   $ sha1sum [filename]
  

防火墙配置

如果您使用了防火墙，则可能需要防火墙允许访问以下内容：

• HTTP 方法 [适用于方法 - 通过客户门户网站上传文件，在归档创建过程中自动上传 sos 报告，以及红帽支持工具]

  • Host: api.access.redhat.com, rh-case-attachments.redhat.com
  • 协议:HTTP, HTTPS,
  • 端口:80, 443
  • HTTP 方法：GET, POST, PUT, DELETE

• FTP 方法

  • Host: sftp.access.redhat.com
  • 协议:SFTP
  • 端口:22 （默认）、80 （需要配置）

备注