1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
|
#!/usr/bin/python
# -*- coding:utf-8 -*-
# Copyright(C) 2023 Kaytus Inc. All Rights Reserved.
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
from __future__ import (absolute_import, division, print_function)
__metaclass__ = type
DOCUMENTATION = '''
---
module: update_fw
version_added: "1.0.0"
author:
- WangBaoshan (@ieisystem)
short_description: Update firmware
description:
- Update firmware on kaytus Server.
notes:
- Does not support C(check_mode).
options:
url:
description:
- Firmware image url.
required: true
type: str
mode:
description:
- Active mode, Manual or Auto(default).
default: Auto
choices: ['Auto', 'Manual']
type: str
type:
description:
- Firmware type.
choices: ['BMC', 'BIOS']
type: str
over_ride:
description:
- Reserve Configurations, 0-reserve, 1-override.
default: 0
choices: [0, 1]
type: int
has_me:
description:
- Update me or not when update bios, only work in INTEL platform, 0-no, 1-yes.
- Only the M5 model supports this parameter.
default: 1
choices: [0, 1]
type: int
dual_image:
description:
- Update dual image(default) or not.
- Only the M5 model supports this parameter.
default: dual
choices: ['single', 'dual']
type: str
extends_documentation_fragment:
- kaytus.ksmanage.ksmanage
'''
EXAMPLES = '''
- name: Update fw test
hosts: ksmanage
connection: local
gather_facts: false
vars:
ksmanage:
host: "{{ ansible_ssh_host }}"
username: "{{ username }}"
password: "{{ password }}"
tasks:
- name: "update bios"
kaytus.ksmanage.update_fw:
url: "/home/wbs/SA5112M5_BIOS_4.1.8_Standard_20200117.bin"
type: "BIOS"
provider: "{{ ksmanage }}"
- name: "update bmc"
kaytus.ksmanage.update_fw:
url: "/home/wbs/SA5112M5_BMC_4.17.7_Standard_20200430"
mode: "Auto"
type: "BMC"
dual_image: "dual"
provider: "{{ ksmanage }}"
'''
RETURN = '''
message:
description: Messages returned after module execution.
returned: always
type: str
state:
description: Status after module execution.
returned: always
type: str
changed:
description: Check to see if a change was made on the device.
returned: always
type: bool
'''
from ansible.module_utils.basic import AnsibleModule
from ansible_collections.kaytus.ksmanage.plugins.module_utils.ksmanage import (ksmanage_argument_spec, get_connection)
class Update(object):
def __init__(self, argument_spec):
self.spec = argument_spec
self.module = None
self.init_module()
self.results = dict()
def init_module(self):
"""Init module object"""
self.module = AnsibleModule(
argument_spec=self.spec, supports_check_mode=False)
def run_command(self):
self.module.params['subcommand'] = 'fwupdate'
self.results = get_connection(self.module)
if self.results['State'] == 'Success':
self.results['changed'] = True
def show_result(self):
"""Show result"""
self.module.exit_json(**self.results)
def work(self):
"""Worker"""
self.run_command()
self.show_result()
def main():
argument_spec = dict(
url=dict(type='str', required=True),
mode=dict(type='str', default='Auto', choices=['Auto', 'Manual']),
over_ride=dict(type='int', default=0, choices=[0, 1]),
type=dict(type='str', required=False, choices=['BMC', 'BIOS']),
has_me=dict(type='int', default=1, choices=[0, 1]),
dual_image=dict(type='str', default='dual', choices=['single', 'dual']),
)
argument_spec.update(ksmanage_argument_spec)
update_obj = Update(argument_spec)
update_obj.work()
if __name__ == '__main__':
main()
|
