.. _junos_install_os: junos_install_os - Install a Junos OS image. ++++++++++++++++++++++++++++++++++++++++++++ :Author: Jeremy Schulman, Juniper Networks .. contents:: :local: :depth: 1 Synopsis -------- .. versionadded:: 1.0.0 Install a Junos OS image on one or more Routing Engines. This module supports installations on single Routing Engine devices, MX Series routers with dual Routing Engines, and EX Series switches in a non-mixed Virtual Chassis. This action is equivalent to performing the Junos OS **request system software add** operational command. If the existing Junos OS version matches the desired version, no action is performed, and the "changed" attribute reports False. If the existing version does not match, then the module performs the following actions (1) Computes the MD5 checksum of the package located on the server. (2) Copies the Junos OS software package to the device running Junos OS. (3) Computes the MD5 checksum on the device running Junos OS and compares the two. (4) Installs the Junos OS software package. (5) Reboots the device (default). Running the module in check mode reports whether the current Junos OS version matches the desired version. Options ------- .. raw:: html
parameter | required | default | choices | comments |
---|---|---|---|---|
host | yes | Set to {{ inventory_hostname }} | ||
logfile | no | None | Path on the local server where the progress status is logged for debugging purposes | |
no_copy | no |
|
Installer need to be copied or not on the device. | |
package | yes | Absolute path on the local server to the Junos OS software package | ||
passwd | no | assumes ssh-key active | Login password | |
port | no | 830 | TCP port number to use when connecting to the device | |
reboot | no | True |
|
If set to yes, the device reboots after the installation completes. |
reboot_pause | no | 10 | Amount of time in seconds to wait after the reboot is issued | |
user | no | $USER | Login username | |
version | yes | Junos OS version string as it would be reported by the show version command |