community.network.netscaler_save_config – Save Netscaler configuration.

From Get docs
Ansible/docs/2.10/collections/community/network/netscaler save config module


community.network.netscaler_save_config – Save Netscaler configuration.

Note

This plugin is part of the community.network collection (version 1.3.0).

To install it use: ansible-galaxy collection install community.network.

To use it in a playbook, specify: community.network.netscaler_save_config.


Synopsis

  • This module unconditionally saves the configuration on the target netscaler node.
  • This module does not support check mode.
  • This module is intended to run either on the ansible control node or a bastion (jumpserver) with access to the actual netscaler instance.

Requirements

The below requirements are needed on the host that executes this module.

  • nitro python sdk

Parameters

Parameter Choices/Defaults Comments

nitro_pass

string / required

The password with which to authenticate to the netscaler node.

nitro_protocol

string

  • http

  • https

Which protocol to use when accessing the nitro API objects.

nitro_timeout

string

Default:

310

Time in seconds until a timeout error is thrown when establishing a new session with Netscaler.

nitro_user

string / required

The username with which to authenticate to the netscaler node.

nsip

string / required

The ip address of the netscaler appliance where the nitro API calls will be made.

The port can be specified with the colon (:). E.g. 192.168.1.1:555.

validate_certs

boolean

  • no
  • yes

If no, SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates.



Examples

---
- name: Save netscaler configuration
  delegate_to: localhost
  community.network.netscaler_save_config:
    nsip: 172.18.0.2
    nitro_user: nsroot
    nitro_pass: nsroot

- name: Setup server without saving  configuration
  delegate_to: localhost
  notify: Save configuration
  netscaler_server:
    nsip: 172.18.0.2
    nitro_user: nsroot
    nitro_pass: nsroot

    save_config: no

    name: server-1
    ipaddress: 192.168.1.1

# Under playbook's handlers

- name: Save configuration
  delegate_to: localhost
  community.network.netscaler_save_config:
    nsip: 172.18.0.2
    nitro_user: nsroot
    nitro_pass: nsroot

Return Values

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

Key Returned Description

loglines

list / elements=string

always

list of logged messages by the module


Sample:

['message 1', 'message 2']

msg

string

failure

Message detailing the failure reason


Sample:

Action does not exist




Authors

  • George Nikolopoulos (@giorgos-nikolopoulos)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/network/netscaler_save_config_module.html