README-automountmap.md

Automountmap module

Description

The automountmap module allows the addition and removal of maps within automount locations.

It is desgined to follow the IPA api as closely as possible while ensuring ease of use.

Features

• Automount map management

Supported FreeIPA Versions

FreeIPA versions 4.4.0 and up are supported by the ipaautomountmap module.

Requirements

Controller

• Ansible version: 2.8+

Node

• Supported FreeIPA version (see above)

Usage

Example inventory file

[ipaserver]
ipaserver.test.local

Example playbook to ensure presence of an automount map:

---
- name: Playbook to add an automount map
  hosts: ipaserver
  become: no

  tasks:
  - name: ensure map named auto.DMZ in location DMZ is created
    ipaautomountmap:
      ipaadmin_password: SomeADMINpassword
      name: auto.DMZ
      location: DMZ
      desc: "this is a map for servers in the DMZ"

Example playbook to ensure auto.DMZi is absent:

---
- name: Playbook to remove an automount map
  hosts: ipaserver
  become: no

  tasks:
  - name: ensure map auto.DMZ has been removed
    ipaautomountmap:
      ipaadmin_password: SomeADMINpassword
      name: auto.DMZ
      location: DMZ
      state: absent

Variables

Variable	Description	Required
ipaadmin_principal	The admin principal is a string and defaults to admin	no
ipaadmin_password	The admin password is a string and is required if there is no admin ticket available on the node	no
name | mapname | map | automountmapname	Name of the map to manage	yes
location | automountlocation | automountlocationcn	Location name.	yes
desc | description	Description of the map	yes
state	The state to ensure. It can be one of present, or absent, default: present.	no

Notes

Creation of indirect mount points are not supported.

Authors

Chris Procter