# salt.states.nxos_upgrade

Manage NX-OS System Image Upgrades.

Added in version 3001.

maturity:

  new

platform:

  nxos

codeauthor:

  Michael G Wiebe

For documentation on setting up the nxos proxy minion look in the documentation for `salt.proxy.nxos`.

salt.states.nxos_upgrade.image_running(name, system_image, kickstart_image=None, issu=True, **kwargs)

  Ensure the NX-OS system image is running on the device.

  name

    Name of the salt state task

  system_image

    Name of the system image file on bootflash:

  kickstart_image

    Name of the kickstart image file on bootflash: This is not needed if the system_image is a combined system and kickstart image Default: None

  issu

    Ensure the correct system is running on the device using an in service software upgrade, or force a disruptive upgrade by setting the option to False. Default: False

  timeout

    Timeout in seconds for long running 'install all' upgrade command. Default: 900

  Examples:

      upgrade_software_image_n9k:
        nxos.image_running:
          - name: Ensure nxos.7.0.3.I7.5a.bin is running
          - system_image: nxos.7.0.3.I7.5a.bin
          - issu: True

      upgrade_software_image_n7k:
        nxos.image_running:
          - name: Ensure n7000-s2-kickstart.8.0.1.bin is running
          - kickstart_image: n7000-s2-kickstart.8.0.1.bin
          - system_image: n7000-s2-dk9.8.0.1.bin
          - issu: False