lenovo.lxca-config
Ansible Role: Lenovo LXCA Configuration
This is an Ansible Role that helps manage and configure Lenovo xClarity Administrator (LXCA). It allows you to perform various tasks such as managing devices, updating firmware, setting configuration policies, and deploying operating systems.
Requirements
Ansible version 2.4.2 or higher (Installation instructions here).
Python Client for Lenovo xClarity Administrator. (LXCA Python Client version 2.5.0)
You can install it using:pip install pylxca
Mandatory Variables
Here are some required variables you need to set:
| Variable | Description |
|---|---|
lxca_user |
Username to connect to LXCA |
lxca_password |
Password for the user |
lxca_url |
URL to connect to LXCA |
Role Variables
This is a list of other variables you can use:
| Variable | Description |
|---|---|
uuid |
UUID of a managed element |
id |
ID of a resource |
endpoint_ip |
IP address of the Endpoint |
user |
User name |
password |
User password |
force |
Flag to force configuration action |
policy_name |
Name of the policy to be applied |
repo_key |
Repository key for managing firmware updates |
mode |
Mode of operation (e.g. immediate, delayed) |
Supported Tags
You can use the following tags to perform specific actions:
| Tags | Description |
|---|---|
manage |
Manage a discovered device |
unmanage |
Unmanage a device |
update_firmware |
Update firmware for a specific device |
apply_configpatterns |
Apply configuration patterns to devices |
get_configstatus |
Get the configuration status of a device |
Dependencies
You need to have network access to Lenovo xClarity Administrator for this role to work.
Example Playbook
To run an Ansible playbook, select a tag mentioned above and provide the required variables. For example, for the manage operation:
ansible-playbook -e "lxca_user=USERID lxca_password=Passw0rd lxca_url=https://10.240.29.217 endpoint_ip=10.240.72.172 user=USERID password=CME44ibm force=True" test.yml --tags manage
Replace USERID, Passw0rd, and other parameters with your actual values.
Using Tags for Different Operations
- To
unmanage, provide:
ansible-playbook -e "lxca_user=USERID lxca_password=Passw0rd lxca_url=https://10.240.29.217 endpoint_ip=10.240.72.172;UUID;Chassis" test.yml --tags unmanage
- For updating the policy:
ansible-playbook -e "lxca_user=USERID lxca_password=Passw0rd lxca_url=https://10.240.29.217 subcmd=assign policy_name=policy_name uuid=UUID" test.yml --tags updatepolicy
- To get information about all available OS images:
ansible-playbook -e "lxca_user=USERID lxca_password=Passw0rd lxca_url=https://10.240.29.217 subcmd=list" test.yml --tags osimages
Make sure to use -vvvv if you want detailed output during the playbook execution to help identify issues.
This simplified version keeps the essential information intact while removing some technical jargon to enhance clarity.
The lxca-config ansible role facilitates configuration of managed endpoiints from Lenovo xClarity Adiministrator.
ansible-galaxy install lenovo.lxca-config