community.network.ftd_install – Installs FTD pkg image on the firewall¶
Note
This plugin is part of the community.network collection (version 2.1.1).
To install it use: ansible-galaxy collection install community.network
.
To use it in a playbook, specify: community.network.ftd_install
.
Synopsis¶
Provisioning module for FTD devices that installs ROMMON image (if needed) and FTD pkg image on the firewall.
Can be used with httpapi and local connection types. The httpapi is preferred, the local connection should be used only when the device cannot be accessed via REST API.
Requirements¶
The below requirements are needed on the host that executes this module.
python >= 3.5
firepower-kickstart
Parameters¶
Notes¶
Note
Requires firepower-kickstart library that should be installed separately and requires Python >= 3.5.
On localhost, Ansible can be still run with Python >= 2.7, but the interpreter for this particular module must be Python >= 3.5.
Python interpreter for the module can overwritten in ansible_python_interpreter variable.
Examples¶
- name: Install image v6.3.0 on FTD 5516
community.network.ftd_install:
device_hostname: firepower
device_password: pass
device_ip: 192.168.0.1
device_netmask: 255.255.255.0
device_gateway: 192.168.0.254
dns_server: 8.8.8.8
console_ip: 10.89.0.0
console_port: 2004
console_username: console_user
console_password: console_pass
rommon_file_location: 'tftp://10.89.0.11/installers/ftd-boot-9.10.1.3.lfbff'
image_file_location: 'https://10.89.0.11/installers/ftd-6.3.0-83.pkg'
image_version: 6.3.0-83
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
msg
string
|
always |
The message saying whether the image was installed or explaining why the installation failed.
|
Authors¶
Cisco Systems, Inc. (@annikulin)