Documentation

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.

        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
        

        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, Helping Testing PRs and Developing Modules.