cl_img_install - Install a different Cumulus Linux version.
New in version 2.1.
DEPRECATED
Removed in Ansible: | |
---|---|
version: 2.5 | |
Why: | The image slot system no longer exists in Cumulus Linux. |
Alternative: | n/a |
Synopsis
- install a different version of Cumulus Linux in the inactive slot. For more details go the Image Management User Guide at http://docs.cumulusnetworks.com/.
Requirements
The below requirements are needed on the host that executes this module.
- Cumulus Linux OS
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
src required | The full path to the Cumulus Linux binary image. Can be a local path, http or https URL. If the code version is in the name of the file, the module will assume this is the version of code you wish to install. | |
switch_slot |
| Switch slots after installing the image. To run the installed code, reboot the switch. |
version | Default: None | Inform the module of the exact version one is installing. This overrides the automatic check of version in the file name. For example, if the binary file name is called CumulusLinux-2.2.3.bin, and version is set to '2.5.0', then the module will assume it is installing '2.5.0' not '2.2.3'. If version is not included, then the module will assume '2.2.3' is the version to install. |
Examples
## Download and install the image from a webserver. - name: Install image using using http url. Switch slots so the subsequent will load the new version cl_img_install: version: 2.0.1 src: http://10.1.1.1/CumulusLinux-2.0.1.bin switch_slot: yes ## Copy the software from the ansible server to the switch. ## The module will get the code version from the filename ## The code will be installed in the alternate slot but the slot will not be primary ## A subsequent reload will not run the new code - name: Download cumulus linux to local system get_url: src: ftp://cumuluslinux.bin dest: /root/CumulusLinux-2.0.1.bin - name: Install image from local filesystem. Get version from the filename. cl_img_install: src: /root/CumulusLinux-2.0.1.bin ## If the image name has been changed from the original name, use the `version` option ## to inform the module exactly what code version is been installed - name: Download cumulus linux to local system get_url: src: ftp://CumulusLinux-2.0.1.bin dest: /root/image.bin - name: install image and switch slots. Only reboot needed cl_img_install: version: 2.0.1 src: /root/image.bin switch_slot: yes
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
changed bool | changed | whether the interface was changed Sample: True |
msg string | always | human-readable report of success or failure Sample: interface bond0 config updated |
Status
This module is flagged as deprecated and will be removed in version 2.5. For more information see DEPRECATED.
Author
- Cumulus Networks (@CumulusNetworks)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/cl_img_install_module.html