community.network.ce_startup – Manages a system startup information on HUAWEI CloudEngine switches.

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.ce_startup.

Synopsis

  • Manages a system startup information on HUAWEI CloudEngine switches.

Parameters

Parameter Choices/Defaults Comments
action
string
    Choices:
  • display
Display the startup information.
cfg_file
string
Default:
"present"
Name of the configuration file that is applied for the next startup. The value is a string of 5 to 255 characters.
patch_file
string
Name of the patch file that is applied for the next startup.
slot
string
Position of the device.The value is a string of 1 to 32 characters. The possible value of slot is all, slave-board, or the specific slotID.
software_file
string
File name of the system software that is applied for the next startup. The value is a string of 5 to 255 characters.

Notes

Note

  • Recommended connection is network_cli.

  • This module also works with local connections for legacy playbooks.

Examples

- name: Startup module test
  hosts: cloudengine
  connection: local
  gather_facts: no
  vars:
    cli:
      host: "{{ inventory_hostname }}"
      port: "{{ ansible_ssh_port }}"
      username: "{{ username }}"
      password: "{{ password }}"
      transport: cli

  tasks:

  - name: Display startup information
    community.network.ce_startup:
      action: display
      provider: "{{ cli }}"

  - name: Set startup patch file
    community.network.ce_startup:
      patch_file: 2.PAT
      slot: all
      provider: "{{ cli }}"

  - name: Set startup software file
    community.network.ce_startup:
      software_file: aa.cc
      slot: 1
      provider: "{{ cli }}"

  - name: Set startup cfg file
    community.network.ce_startup:
      cfg_file: 2.cfg
      slot: 1
      provider: "{{ cli }}"

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
changed
boolean
always
check to see if a change was made on the device

Sample:
True
end_state
dictionary
always
k/v pairs of aaa params after module execution

Sample:
{'StartupInfos': None}
existing
dictionary
always
k/v pairs of existing aaa server

Sample:
{'configSysSoft': 'flash:/CE12800-V200R002C20_issuB071.cc', 'curentPatchFile': 'NULL', 'curentStartupFile': 'NULL', 'curentSysSoft': 'flash:/CE12800-V200R002C20_issuB071.cc', 'nextPatchFile': 'flash:/1.PAT', 'nextStartupFile': 'flash:/1.cfg', 'nextSysSoft': 'flash:/CE12800-V200R002C20_issuB071.cc', 'position': '5'}
proposed
dictionary
always
k/v pairs of parameters passed into module

Sample:
{'patch_file': '2.PAT', 'slot': 'all'}
updates
list / elements=string
always
command sent to the device

Sample:
{'startup patch 2.PAT all': None}


Authors

  • Li Yanfeng (@QijunPan)