W3cubDocs

/Ansible

alternatives - Manages alternative programs for common commands

New in version 1.6.

Synopsis

Manages symbolic links using the ‘update-alternatives’ tool Useful when multiple programs are installed but provide similar functionality (e.g. different editors).

Requirements (on host that executes module)

  • update-alternatives

Options

parameter required default choices comments
link
no
The path to the symbolic link that should point to the real executable.
This option is required on RHEL-based distributions
name
yes
The generic name of the link.
path
yes
The path to the real executable that the link should point to.
priority
(added in 2.2)
no 50
The priority of the alternative

Examples

- name: correct java version selected
  alternatives: name=java path=/usr/lib/jvm/java-7-openjdk-amd64/jre/bin/java

- name: alternatives link created
  alternatives: name=hadoop-conf link=/etc/hadoop/conf path=/etc/hadoop/conf.ansible

- name: make java 32 bit an alternative with low priority
  alternatives: name=java path=/usr/lib/jvm/java-7-openjdk-i386/jre/bin/java priority=-10

This is an Extras Module

For more information on what this means please read Extras Modules

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, developing_test_pr and Developing Modules.

© 2012–2016 Michael DeHaan
© 2016 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/alternatives_module.html