dellemc.openmanage.ome_firmware_catalog – Create, modify, or delete a firmware catalog on OpenManage Enterprise or OpenManage Enterprise Modular
Note
This plugin is part of the dellemc.openmanage collection (version 3.6.0).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install dellemc.openmanage
.
To use it in a playbook, specify: dellemc.openmanage.ome_firmware_catalog
.
New in version 2.0.0: of dellemc.openmanage
Synopsis
This module allows to create, modify, or delete a firmware catalog on OpenManage Enterprise or OpenManage Enterprise Modular.
Requirements
The below requirements are needed on the host that executes this module.
python >= 2.7.5
Parameters
Parameter |
Comments |
---|---|
Description for the catalog. |
|
ID of the catalog. This option is mutually exclusive with catalog_name. Provide the list of firmware catalog IDs that are supported when state is |
|
Name of the firmware catalog to be created. This is option is mutually exclusive with catalog_id. Provide the list of firmware catalog names that are supported when state is |
|
The certificate warnings are ignored when repository_type is HTTPS. If Choices:
|
|
Catalog file name associated with the source_path. This option is ignored when repository_type is |
|
OpenManage Enterprise or OpenManage Enterprise Modular IP address or hostname. |
|
Provides the option to wait for job completion. This option is applicable when state is Choices:
|
|
The maximum wait time of job_wait in seconds. The job is tracked only for this duration. This option is applicable when job_wait is Default: 600 |
|
New name of the firmware catalog. |
|
OpenManage Enterprise or OpenManage Enterprise Modular password. |
|
OpenManage Enterprise or OpenManage Enterprise Modular HTTPS port. Default: 443 |
|
Domain name of the repository. This option is ignored when repository_type is |
|
Password to access the repository. This option is mandatory when repository_type is CIFS. This option is ignored when repository_type is
|
|
Type of repository. The supported types are NFS, CIFS, HTTP, HTTPS,and DELL_ONLINE. Choices:
|
|
User name of the repository where the catalog is stored. This option is mandatory when repository_type is CIFS. This option is ignored when repository_type is |
|
The IP address of the system where the firmware catalog is stored on the local network. By default, this option is set to downloads.dell.com when repository_type is |
|
Specify the complete path of the catalog file location without the file name. This is option ignored when repository_type is |
|
Choices:
|
|
OpenManage Enterprise or OpenManage Enterprise Modular username. |
Notes
Note
If repository_password is provided, then the module always reports the changed status.
Run this module from a system that has direct access to DellEMC OpenManage Enterprise or OpenManage Enterprise Modular.
This module supports
check_mode
.
Examples
---
- name: Create a catalog from HTTPS repository
dellemc.openmanage.ome_firmware_catalog:
hostname: "192.168.0.1"
username: "username"
password: "password"
catalog_name: "catalog_name"
catalog_description: "catalog_description"
repository_type: "HTTPS"
source: "downloads.dell.com"
source_path: "catalog"
file_name: "catalog.gz"
check_certificate: True
- name: Create a catalog from HTTP repository
dellemc.openmanage.ome_firmware_catalog:
hostname: "192.168.0.1"
username: "username"
password: "password"
catalog_name: "catalog_name"
catalog_description: "catalog_description"
repository_type: "HTTP"
source: "downloads.dell.com"
source_path: "catalog"
file_name: "catalog.gz"
- name: Create a catalog using CIFS share
dellemc.openmanage.ome_firmware_catalog:
hostname: "192.168.0.1"
username: "username"
password: "password"
catalog_name: "catalog_name"
catalog_description: "catalog_description"
repository_type: "CIFS"
source: "192.167.0.1"
source_path: "cifs/R940"
file_name: "catalog.gz"
repository_username: "repository_username"
repository_password: "repository_password"
repository_domain: "repository_domain"
- name: Create a catalog using NFS share
dellemc.openmanage.ome_firmware_catalog:
hostname: "192.168.0.1"
username: "username"
password: "password"
catalog_name: "catalog_name"
catalog_description: "catalog_description"
repository_type: "NFS"
source: "192.166.0.2"
source_path: "/nfs/R940"
file_name: "catalog.xml"
- name: Create a catalog using repository from Dell.com
dellemc.openmanage.ome_firmware_catalog:
hostname: "192.168.0.1"
username: "username"
password: "password"
catalog_name: "catalog_name"
catalog_description: "catalog_description"
repository_type: "DELL_ONLINE"
check_certificate: True
- name: Modify a catalog using a repository from CIFS share
dellemc.openmanage.ome_firmware_catalog:
hostname: "192.168.0.1"
username: "username"
password: "password"
catalog_name: "catalog_name"
catalog_description: "new catalog_description"
repository_type: "CIFS"
source: "192.167.0.2"
source_path: "cifs/R941"
file_name: "catalog1.gz"
repository_username: "repository_username"
repository_password: "repository_password"
repository_domain: "repository_domain"
- name: Modify a catalog using a repository from Dell.com
dellemc.openmanage.ome_firmware_catalog:
hostname: "192.168.0.1"
username: "username"
password: "password"
catalog_id: 10
new_catalog_name: "new_catalog_name"
repository_type: "DELL_ONLINE"
catalog_description: "catalog_description"
- name: Delete catalog using catalog name
dellemc.openmanage.ome_firmware_catalog:
hostname: "192.168.0.1"
username: "username"
password: "password"
state: absent
catalog_name: ["catalog_name1", "catalog_name2"]
- name: Delete catalog using catalog id
dellemc.openmanage.ome_firmware_catalog:
hostname: "192.168.0.1"
username: "username"
password: "password"
state: absent
catalog_id: [11, 34]
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
IDs of the baselines associated with catalog. Returned: When state is Sample: [{“BaselineId”: 24, “BaselineName”: “new”}, {“BaselineId”: 25, “BaselineName”: “c7”}, {“BaselineId”: 27, “BaselineName”: “c4”}] |
|
IDs of the deleted catalog. Returned: When state is Sample: 10123 |
|
Details of the catalog operation. Returned: When state is Sample: {“AssociatedBaselines”: [], “BaseLocation”: null, “BundlesCount”: 0, “Filename”: “catalog.gz”, “Id”: 0, “LastUpdated”: null, “ManifestIdentifier”: null, “ManifestVersion”: null, “NextUpdate”: null, “PredecessorIdentifier”: null, “ReleaseDate”: null, “ReleaseIdentifier”: null, “Repository”: {“CheckCertificate”: true, “Description”: “HTTPS Desc”, “DomainName”: null, “Id”: null, “Name”: “catalog4”, “Password”: null, “RepositoryType”: “HTTPS”, “Source”: “company.com”, “Username”: null}, “Schedule”: null, “SourcePath”: “catalog”, “Status”: null, “TaskId”: 10094} |
|
Details of the http error. Returned: on http error Sample: {“error”: {“@Message.ExtendedInfo”: [{“Message”: “Unable to create or update the catalog because a repository with the same name already exists.”, “Resolution”: “Enter a different name and retry the operation.”, “Severity”: “Critical”}], “code”: “Base.1.0.GeneralError”, “message”: “A general error has occurred. See ExtendedInfo for more information.”}} |
|
Job ID of the catalog task. Returned: When catalog job is in a running state Sample: 10123 |
|
Overall status of the firmware catalog operation. Returned: always Sample: “Successfully triggered the job to create a catalog with Task ID : 10094” |
Authors
Sajna Shetty(@Sajna-Shetty)
Jagadeesh N V(@jagadeeshnv)