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
|
.. _cpm_firmware_update_module:
cpm_firmware_update -- Set Serial port parameters in WTI OOB and PDU devices
============================================================================
.. contents::
:local:
:depth: 1
Synopsis
--------
Set Serial port parameters in WTI OOB and PDU devices
Parameters
----------
cpm_url (True, str, None)
This is the URL of the WTI device to send the module.
cpm_username (True, str, None)
This is the Username of the WTI device to send the module.
cpm_password (True, str, None)
This is the Password of the WTI device to send the module.
cpm_path (False, str, /tmp/)
This is the directory path to store the WTI device configuration file.
cpm_file (False, str, None)
If a file is defined, this file will be used to update the WTI device.
use_force (False, bool, False)
If set to True, the upgrade will happen even if the device doesnt need it.
use_https (False, bool, True)
Designates to use an https connection or http connection.
validate_certs (False, bool, True)
If false, SSL certificates will not be validated. This should only be used - on personally controlled sites using self-signed certificates.
use_proxy (False, bool, False)
Flag to control if the lookup will observe HTTP proxy environment variables when present.
family (False, int, 1)
Force the download to both either Console (1) or Power (0)
removefileonexit (False, int, 1)
After an upgrade, remove the upgrade OS image
Notes
-----
.. note::
- Use ``groups/cpm`` in ``module_defaults`` to set common options used between CPM modules.
Examples
--------
.. code-block:: yaml+jinja
# Upgrade the firmware of a WTI device
- name: Upgrade the firmware of a WTI device
cpm_firmware_update:
cpm_url: "nonexist.wti.com"
cpm_username: "super"
cpm_password: "super"
use_https: true
validate_certs: false
# Upgrade the firmware of a WTI device and keep the download OS image after exit
- name: Upgrade the firmware of a WTI device and keep the download OS image after exit
cpm_firmware_update:
cpm_url: "nonexist.wti.com"
cpm_username: "super"
cpm_password: "super"
use_https: true
validate_certs: false
removefileonexit: "0"
Return Values
-------------
data (always, complex, )
The output XML configuration of the WTI device being updated
filelength (success, int, [{'filelength': 329439}])
Length of the file uploaded in bytes
status (success, list, [{'code': 0}, {'text': 'ok'}, {'unittimestamp': '2020-02-14T00:18:57+00:00'}])
List of status returns from backup operation
Status
------
- This module is not guaranteed to have a backwards compatible interface. *[preview]*
- This module is maintained by community.
Authors
~~~~~~~
- Western Telematic Inc. (@wtinetworkgear)
|
