dellemc.openmanage.idrac_lifecycle_controller_logs 模块 – 将生命周期控制器日志导出到网络共享或本地路径。

注意

此模块是 dellemc.openmanage 集合 (版本 9.9.0) 的一部分。

如果您使用的是 ansible 软件包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install dellemc.openmanage。您需要其他需求才能使用此模块，有关详细信息，请参阅 需求。

要在 playbook 中使用它，请指定： dellemc.openmanage.idrac_lifecycle_controller_logs。

dellemc.openmanage 2.1.0 中的新增功能

概要

  • 将生命周期控制器日志导出到指定的网络共享或本地路径。

需求

以下是执行此模块的主机所需的条件。

  • omsdk >= 1.2.488

  • python >= 3.9.6

参数

参数

注释

ca_path

路径

在 dellemc.openmanage 5.0.0 中添加

包含用于验证的 CA 证书的隐私增强邮件 (PEM) 文件。

idrac_ip

字符串 / 必需

iDRAC IP 地址。

idrac_password

别名：idrac_pwd

字符串 / 必需

iDRAC 用户密码。

如果未提供密码，则使用环境变量 IDRAC_PASSWORD。

示例：export IDRAC_PASSWORD=password

idrac_port

整数

iDRAC 端口。

默认值： 443

idrac_user

字符串 / 必需

iDRAC 用户名。

如果未提供用户名，则使用环境变量 IDRAC_USERNAME。

示例：export IDRAC_USERNAME=username

job_wait

布尔值

是否等待正在运行的作业完成。

选项

  • false

  • true ← (默认)

share_name

字符串 / 必需

网络共享或本地路径。

支持 CIFS、NFS 网络共享类型。

share_password

别名：share_pwd

字符串

网络共享用户密码。此选项对于 CIFS 网络共享是必需的。

share_user

字符串

网络共享用户，格式为 ‘user@domain’ 或 ‘domain\user’（如果用户是域的一部分），否则为 ‘user’。此选项对于 CIFS 网络共享是必需的。

timeout

整数

在 dellemc.openmanage 5.0.0 中添加

以秒为单位的套接字级别超时。

默认值： 30

validate_certs

布尔值

在 dellemc.openmanage 5.0.0 中添加

如果为 false，则不会验证 SSL 证书。

仅在使用自签名证书的个人控制站点上配置 false。

在集合版本 5.0.0 之前，validate_certs 默认值为 false。

选项

  • false

  • true ← (默认)

注释

注意

  • 此模块需要针对 idrac_user 的“管理员”权限。

  • 仅在基于 iDRAC9 的 PowerEdge 服务器及更高版本上支持将数据导出到本地共享。

  • 从可以直接访问 Dell iDRAC 的系统运行此模块。

  • 此模块支持 idrac_ip 的 IPv4 和 IPv6 地址。

  • 此模块不支持 check_mode。

示例

---
- name: Export lifecycle controller logs to NFS share.
  dellemc.openmanage.idrac_lifecycle_controller_logs:
    idrac_ip: "190.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    share_name: "192.168.0.0:/nfsfileshare"

- name: Export lifecycle controller logs to CIFS share.
  dellemc.openmanage.idrac_lifecycle_controller_logs:
    idrac_ip: "190.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    share_name: "\\\\192.168.0.2\\share"
    share_user: "share_user_name"
    share_password: "share_user_pwd"

- name: Export lifecycle controller logs to LOCAL path.
  dellemc.openmanage.idrac_lifecycle_controller_logs:
    idrac_ip: "190.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    share_name: "/example/export_lc"

返回值

常见的返回值已在 此处 记录，以下是此模块特有的字段

键

描述

error_info

字典

HTTP 错误的详细信息。

返回：HTTP 错误时

示例： {"error": {"@Message.ExtendedInfo": [{"Message": "由于发生错误，无法处理请求。", "MessageArgs": [], "MessageId": "GEN1234", "RelatedProperties": [], "Resolution": "重试操作。如果问题仍然存在，请联系系统管理员。", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "发生一般错误。查看ExtendedInfo以获取更多信息。"}

lc_logs_status

字典

导出操作的状态，以及作业详细信息和文件路径。

返回： success

示例： {"ElapsedTimeSinceCompletion": "0", "InstanceID": "JID_274774785395", "JobStartTime": "NA", "JobStatus": "Completed", "JobUntilTime": "NA", "Message": "LCL 导出成功", "MessageArguments": "NA", "MessageID": "LC022", "Name": "LC 导出", "PercentComplete": "100", "Status": "Success", "file": "192.168.0.0:/nfsfileshare/190.168.0.1_20210728_133437_LC_Log.log", "retval": true}

msg

字符串

导出生命周期控制器日志作业的状态。

返回： always

示例： "已成功导出生命周期控制器日志。"

作者

  • Rajeev Arakkal (@rajeevarakkal)

  • Anooja Vardhineni (@anooja-vardhineni)