vmware_vcenter_settings – Configures general settings on a vCenter server
New in version 2.8.
Synopsis
- This module can be used to configure the vCenter server general settings (except the statistics).
- The statistics can be configured with the module
vmware_vcenter_statistics.
Requirements
The below requirements are needed on the host that executes this module.
- python >= 2.6
- PyVmomi
Parameters
| Parameter | Choices/Defaults | Comments |
|---|---|---|
| database dictionary | Default: {"event_cleanup": true, "event_retention": 30, "max_connections": 50, "task_cleanup": true, "task_retention": 30} | The database settings for vCenter server. Valid attributes are: - max_connections (int): Maximum connections. (default: 50)- task_cleanup (bool): Task cleanup. (default: true)- task_retention (int): Task retention (days). (default: 30)- event_cleanup (bool): Event cleanup. (default: true)- event_retention (int): Event retention (days). (default: 30) |
| hostname string | The hostname or IP address of the vSphere vCenter or ESXi server. If the value is not specified in the task, the value of environment variable VMWARE_HOST will be used instead.Environment variable support added in Ansible 2.6. | |
| logging_options string |
| The level of detail that vCenter server usesfor log files. |
| mail dictionary | The settings vCenter server uses to send email alerts. Valid attributes are: - server (str): Mail server- sender (str): Mail sender address | |
| password string | The password of the vSphere vCenter or ESXi server. If the value is not specified in the task, the value of environment variable VMWARE_PASSWORD will be used instead.Environment variable support added in Ansible 2.6. aliases: pass, pwd | |
| port integer added in 2.5 | Default: 443 | The port number of the vSphere vCenter or ESXi server. If the value is not specified in the task, the value of environment variable VMWARE_PORT will be used instead.Environment variable support added in Ansible 2.6. |
| runtime_settings dictionary | The unique runtime settings for vCenter server. Valid attributes are: - unique_id (int): vCenter server unique ID.- managed_address (str): vCenter server managed address.- vcenter_server_name (str): vCenter server name. (default: FQDN) | |
| snmp_receivers dictionary | Default: {"snmp_receiver_1_community": "public", "snmp_receiver_1_enabled": true, "snmp_receiver_1_port": 162, "snmp_receiver_1_url": "localhost", "snmp_receiver_2_community": "", "snmp_receiver_2_enabled": false, "snmp_receiver_2_port": 162, "snmp_receiver_2_url": "", "snmp_receiver_3_community": "", "snmp_receiver_3_enabled": false, "snmp_receiver_3_port": 162, "snmp_receiver_3_url": "", "snmp_receiver_4_community": "", "snmp_receiver_4_enabled": false, "snmp_receiver_4_port": 162, "snmp_receiver_4_url": ""} | SNMP trap destinations for vCenter server alerts. Valid attributes are: - snmp_receiver_1_url (str): Primary Receiver ULR. (default: "localhost")- snmp_receiver_1_enabled (bool): Enable receiver. (default: True)- snmp_receiver_1_port (int): Receiver port. (default: 162)- snmp_receiver_1_community (str): Community string. (default: "public")- snmp_receiver_2_url (str): Receiver 2 ULR. (default: "")- snmp_receiver_2_enabled (bool): Enable receiver. (default: False)- snmp_receiver_2_port (int): Receiver port. (default: 162)- snmp_receiver_2_community (str): Community string. (default: "")- snmp_receiver_3_url (str): Receiver 3 ULR. (default: "")- snmp_receiver_3_enabled (bool): Enable receiver. (default: False)- snmp_receiver_3_port (int): Receiver port. (default: 162)- snmp_receiver_3_community (str): Community string. (default: "")- snmp_receiver_4_url (str): Receiver 4 ULR. (default: "")- snmp_receiver_4_enabled (bool): Enable receiver. (default: False)- snmp_receiver_4_port (int): Receiver port. (default: 162)- snmp_receiver_4_community (str): Community string. (default: "") |
| timeout_settings dictionary | Default: {"long_operations": 120, "normal_operations": 30} | The vCenter server connection timeout for normal and long operations. Valid attributes are: - normal_operations (int) (default: 30)- long_operations (int) (default: 120) |
| user_directory dictionary | Default: {"query_limit": true, "query_limit_size": 5000, "timeout": 60, "validation": true, "validation_period": 1440} | The user directory settings for the vCenter server installation. Valid attributes are: - timeout (int): User directory timeout. (default: 60)- query_limit (bool): Query limit. (default: true)- query_limit_size (int): Query limit size. (default: 5000)- validation (bool): Mail Validation. (default: true)- validation_period (int): Validation period. (default: 1440) |
| username string | The username of the vSphere vCenter or ESXi server. If the value is not specified in the task, the value of environment variable VMWARE_USER will be used instead.Environment variable support added in Ansible 2.6. aliases: admin, user | |
| validate_certs boolean |
| Allows connection when SSL certificates are not valid. Set to false when certificates are not trusted.If the value is not specified in the task, the value of environment variable VMWARE_VALIDATE_CERTS will be used instead.Environment variable support added in Ansible 2.6. If set to yes, please make sure Python >= 2.7.9 is installed on the given machine. |
Notes
Note
- Tested with vCenter Server Appliance (vCSA) 6.5 and 6.7
Examples
- name: Configure vCenter general settings
vmware_vcenter_settings:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
database:
max_connections: 50
task_cleanup: true
task_retention: 30
event_cleanup: true
event_retention: 30
runtime_settings:
unique_id: 1
managed_address: "{{ ansible_default_ipv4.address }}"
vcenter_server_name: "{{ inventory_hostname }}"
user_directory:
timeout: 60
query_limit: true
query_limit_size: 5000
validation: true
validation_period: 1440
mail:
server: mail.example.com
sender: vcenter@{{ inventory_hostname }}
snmp_receivers:
snmp_receiver_1_url: localhost
snmp_receiver_1_enabled: true
snmp_receiver_1_port: 162
snmp_receiver_1_community: public
timeout_settings:
normal_operations: 30
long_operations: 120
logging_options: info
validate_certs: no
delegate_to: localhost
Return Values
Common return values are documented here, the following are the fields unique to this module:
| Key | Returned | Description |
|---|---|---|
| results dictionary | always | metadata about vCenter settings Sample: {'changed': False, 'db_event_cleanup': True, 'db_event_retention': 30, 'db_max_connections': 50, 'db_task_cleanup': True, 'db_task_retention': 30, 'directory_query_limit': True, 'directory_query_limit_size': 5000, 'directory_timeout': 60, 'directory_validation': True, 'directory_validation_period': 1440, 'logging_options': 'info', 'mail_sender': '[email protected]', 'mail_server': 'mail.example.com', 'msg': 'vCenter settings already configured properly', 'runtime_managed_address': '192.168.1.10', 'runtime_server_name': 'vcenter01.example.com', 'runtime_unique_id': 1, 'timeout_long_operations': 120, 'timeout_normal_operations': 30} |
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Christian Kotte (@ckotte)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/vmware_vcenter_settings_module.html