dellemc.openmanage.idrac_timezone_ntp 模块 – 在 iDRAC 上配置时区和 NTP

注意

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

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

要安装它,请使用:ansible-galaxy collection install dellemc.openmanage。您需要进一步的要求才能使用此模块,请参阅 要求 了解详细信息。

要在 playbook 中使用它,请指定:dellemc.openmanage.idrac_timezone_ntp

dellemc.openmanage 2.1.0 中的新增功能

已弃用

在以下版本中删除:

2024-12-31 之后的 主要版本

原因:

已替换为 dellemc.openmanage.idrac_attributes

替代方案:

请改用 dellemc.openmanage.idrac_attributes

概要

  • 此模块允许在 iDRAC 上配置时区和 NTP。

要求

在执行此模块的主机上需要以下要求。

  • omsdk >= 1.2.488

  • python >= 3.9.6

参数

参数

注释

ca_path

路径

在 dellemc.openmanage 5.0.0 中添加

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

enable_ntp

字符串

允许在 iDRAC 上启用或禁用 NTP。

选项

  • "已启用"

  • "已禁用"

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

ntp_server_1

字符串

NTP 服务器 1 的 IP 地址。

ntp_server_2

字符串

NTP 服务器 2 的 IP 地址。

ntp_server_3

字符串

NTP 服务器 3 的 IP 地址。

setup_idrac_timezone

字符串

允许在 iDRAC 上配置时区。

share_mnt

字符串

(已弃用)具有 Ansible 用户读写权限的网络共享的本地挂载路径。此选项对于网络共享是强制性的。

此选项已弃用,将在以后的版本中删除。

share_name

字符串

(已弃用)网络共享或本地路径。

此选项已弃用,将在以后的版本中删除。

share_password

别名:share_pwd

字符串

(已弃用)网络共享用户密码。此选项对于 CIFS 共享是强制性的。

此选项已弃用,将在以后的版本中删除。

share_user

字符串

(已弃用)网络共享用户名。如果用户是域的一部分,请使用 ‘user@domain’ 或 ‘domain\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 具有“管理员”权限。

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

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

  • 此模块支持 check_mode

示例

---
- name: Configure time zone and NTP on iDRAC
  dellemc.openmanage.idrac_timezone_ntp:
       idrac_ip: "190.168.0.1"
       idrac_user: "user_name"
       idrac_password: "user_password"
       ca_path: "/path/to/ca_cert.pem"
       setup_idrac_timezone: "UTC"
       enable_ntp: Enabled
       ntp_server_1: "190.168.0.1"
       ntp_server_2: "190.168.0.2"
       ntp_server_3: "190.168.0.3"

返回值

通用返回值在此处记录 here,以下是此模块独有的字段

描述

error_info

字典

HTTP 错误的详细信息。

返回:在 HTTP 错误时

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

msg

字符串

时区和 NTP 配置的总体状态。

返回: 总是

示例: "已成功配置 iDRAC 时间设置。"

timezone_ntp_status

字典

时区设置操作的作业详细信息。

返回: 成功

示例: {"@odata.context": "/redfish/v1/$metadata#DellJob.DellJob", "@odata.id": "/redfish/v1/Managers/iDRAC.Embedded.1/Jobs/JID_861801613971", "@odata.type": "#DellJob.v1_0_0.DellJob", "CompletionTime": "2020-04-06T19:06:01", "Description": "作业实例", "EndTime": null, "Id": "JID_861801613971", "JobState": "已完成", "JobType": "导入配置", "Message": "已成功导入并应用服务器配置配置文件。", "MessageArgs": [], "MessageId": "SYS053", "Name": "导入配置", "PercentComplete": 100, "StartTime": "TIME_NOW", "Status": "成功", "TargetSettingsURI": null, "retval": true}

状态

  • 此模块将在 2024-12-31 之后的重大版本中移除。 [已弃用]

  • 有关更多信息,请参阅已弃用

作者

  • Felix Stephen (@felixs88)

  • Anooja Vardhineni (@anooja-vardhineni)