dellemc.openmanage.ome_profile – Create, modify, delete, assign, unassign and migrate a profile on OpenManage Enterprise

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

New in version 3.1.0: of dellemc.openmanage

Synopsis

  • This module allows to create, modify, delete, assign, unassign, and migrate a profile on OpenManage Enterprise.

Requirements

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

  • python >= 2.7.5

Parameters

Parameter Choices/Defaults Comments
attributes
dictionary
Attributes for modify and assign.
Attributes
list / elements=dictionary
List of attributes to be modified, when command is modify.
List of attributes to be overridden when command is assign.
Options
dictionary
Provides the different shut down options.
This is applicable when command is assign.
Schedule
dictionary
Schedule for profile deployment.
This is applicable when command is assign.
boot_to_network_iso
dictionary
Details of the Share iso.
Applicable when command is create, assign, and modify.
boot_to_network
boolean / required
    Choices:
  • no
  • yes
Enable or disable a network share.
iso_path
string
Specify the full ISO path including the share name.
iso_timeout
integer
    Choices:
  • 1
  • 2
  • 4
  • 8
  • 16
Default:
4
Set the number of hours that the network ISO file will remain mapped to the target device(s).
share_ip
string
IP address of the network share.
share_password
string
User password when share_type is CIFS.
share_type
string
    Choices:
  • NFS
  • CIFS
Type of network share.
share_user
string
User name when share_type is CIFS.
workgroup
string
User workgroup when share_type is CIFS.
command
string
    Choices:
  • create
  • modify
  • delete
  • assign
  • unassign
  • migrate
create creates new profiles.
modify modifies an existing profile. Only name, description, boot_to_network_iso, and attributes can be modified.
delete deletes an existing profile.
assign Deploys an existing profile on a target device and returns a task ID.
unassign unassigns a profile from a specified target and returns a task ID.
migrate migrates an existing profile and returns a task ID.
description
string
Description of the profile.
device_id
integer
ID of the target device.
This is applicable when command is assign and migrate.
This option is mutually exclusive with device_service_tag.
device_service_tag
string
Identifier of the target device.
This is typically 7 to 8 characters in length.
Applicable when command is assign, and migrate.
This option is mutually exclusive with device_id.
If the device does not exist when command is assign then the profile is auto-deployed.
filters
dictionary
Filters the profiles based on selected criteria.
This is applicable when command is delete or unassign.
This supports suboption ProfileIds which takes a list of profile IDs.
This also supports OData filter expressions with the suboption Filters.
See OpenManage Enterprise REST API guide for the filtering options available.
WARNING When this option is used in case of unassign, task ID is not returned for any of the profiles affected.
force
boolean
    Choices:
  • no
  • yes
Provides the option to force the migration of a profile even if the source device cannot be contacted.
This option is applicable when command is migrate.
hostname
string / required
OpenManage Enterprise or OpenManage Enterprise Modular IP address or hostname.
name
string
Name of the profile.
This is applicable for modify, delete, assign, unassign, and migrate operations.
This option is mutually exclusive with name_prefix and number_of_profiles.
name_prefix
string
Default:
"Profile"
The name provided when creating a profile is used a prefix followed by the number assigned to it by OpenManage Enterprise.
This is applicable only for a create operation.
This option is mutually exclusive with name.
new_name
string
New name of the profile.
Applicable when command is modify.
number_of_profiles
integer
Default:
1
Provide the number of profiles to be created.
This is applicable when name_prefix is used with create.
This option is mutually exclusive with name.
Openmanage Enterprise can create a maximum of 100 profiles.
password
string / required
OpenManage Enterprise or OpenManage Enterprise Modular password.
port
integer
Default:
443
OpenManage Enterprise or OpenManage Enterprise Modular HTTPS port.
template_id
integer
ID of the template.
This is applicable when command is create.
This option is mutually exclusive with template_name.
template_name
string
Name of the template for creating the profile(s).
This is applicable when command is create.
This option is mutually exclusive with template_id.
username
string / required
OpenManage Enterprise or OpenManage Enterprise Modular username.

Notes

Note

  • Run this module from a system that has direct access to DellEMC OpenManage Enterprise.
  • This module does not support check_mode.
  • assign operation on a already assigned profile will not redeploy.

Examples

---
- name: Create two profiles from a template
  dellemc.openmanage.ome_profile:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    template_name: "template 1"
    name_prefix: "omam_profile"
    number_of_profiles: 2

- name: Create profile with NFS share
  dellemc.openmanage.ome_profile:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    command: create
    template_name: "template 1"
    name_prefix: "omam_profile"
    number_of_profiles: 1
    boot_to_network_iso:
      boot_to_network: True
      share_type: NFS
      share_ip: "192.168.0.1"
      iso_path: "path/to/my_iso.iso"
      iso_timeout: 8

- name: Create profile with CIFS share
  dellemc.openmanage.ome_profile:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    command: create
    template_name: "template 1"
    name_prefix: "omam_profile"
    number_of_profiles: 1
    boot_to_network_iso:
      boot_to_network: True
      share_type: CIFS
      share_ip: "192.168.0.2"
      share_user: "username"
      share_password: "password"
      workgroup: "workgroup"
      iso_path: "\\path\\to\\my_iso.iso"
      iso_timeout: 8

- name: Modify profile name with NFS share and attributes
  dellemc.openmanage.ome_profile:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    command: modify
    name: "Profile 00001"
    new_name: "modified profile"
    description: "new description"
    boot_to_network_iso:
      boot_to_network: True
      share_type: NFS
      share_ip: "192.168.0.3"
      iso_path: "path/to/my_iso.iso"
      iso_timeout: 8
    attributes:
      Attributes:
        - Id: 4506
          Value: "server attr 1"
          IsIgnored: true
        - Id: 4507
          Value: "server attr 2"
          IsIgnored: true

- name: Delete a profile using profile name
  dellemc.openmanage.ome_profile:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    command: "delete"
    name: "Profile 00001"

- name: Delete profiles using filters
  dellemc.openmanage.ome_profile:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    command: "delete"
    filters:
      SelectAll: True
      Filters: =contains(ProfileName,'Profile 00002')

- name: Delete profiles using profile list filter
  dellemc.openmanage.ome_profile:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    command: "delete"
    filters:
      ProfileIds:
        - 17123
        - 16124

- name: Assign a profile to target along with network share
  dellemc.openmanage.ome_profile:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    command: assign
    name: "Profile 00001"
    device_id: 12456
    boot_to_network_iso:
      boot_to_network: True
      share_type: NFS
      share_ip: "192.168.0.1"
      iso_path: "path/to/my_iso.iso"
      iso_timeout: 8
    attributes:
      Attributes:
        - Id: 4506
          Value: "server attr 1"
          IsIgnored: true
      Options:
        ShutdownType: 0
        TimeToWaitBeforeShutdown: 300
        EndHostPowerState: 1
        StrictCheckingVlan: True
      Schedule:
        RunNow: True
        RunLater: False

- name: Unassign a profile using profile name
  dellemc.openmanage.ome_profile:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    command: "unassign"
    name: "Profile 00003"

- name: Unassign profiles using filters
  dellemc.openmanage.ome_profile:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    command: "unassign"
    filters:
      SelectAll: True
      Filters: =contains(ProfileName,'Profile 00003')

- name: Unassign profiles using profile list filter
  dellemc.openmanage.ome_profile:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    command: "unassign"
    filters:
      ProfileIds:
        - 17123
        - 16123

- name: Migrate a profile
  dellemc.openmanage.ome_profile:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    command: "migrate"
    name: "Profile 00001"
    device_id: 12456

Return Values

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

Key Returned Description
error_info
dictionary
on HTTP error
Details of the HTTP Error.

Sample:
{'error': {'@Message.ExtendedInfo': [{'Message': 'Unable to process the request because an error occurred.', 'MessageArgs': [], 'MessageId': 'GEN1234', 'RelatedProperties': [], 'Resolution': 'Retry the operation. If the issue persists, contact your system administrator.', 'Severity': 'Critical'}], 'code': 'Base.1.0.GeneralError', 'message': 'A general error has occurred. See ExtendedInfo for more information.'}}
job_id
integer
when command is assign, migrate or unassign
Task ID created when command is assign, migrate or unassign.
assign and unassign operations do not trigger a task if a profile is auto-deployed.

Sample:
14123
msg
string
always
Overall status of the profile operation.

Sample:
Successfully created 2 profile(s).
profile_ids
list / elements=string
when command is create
IDs of the profiles created.

Sample:
[1234, 5678]


Authors

  • Jagadeesh N V (@jagadeeshnv)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/dellemc/openmanage/ome_profile_module.html