Docs4dev
Docs
ansible / latest / collections / community / general / pkgutil_module.html

community.general.pkgutil – OpenCSW package management on Solaris

Note

This plugin is part of the community.general collection (version 3.8.1).

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 community.general.

To use it in a playbook, specify: community.general.pkgutil.

Synopsis

  • This module installs, updates and removes packages from the OpenCSW project for Solaris.
  • Unlike the community.general.svr4pkg module, it will resolve and download dependencies.
  • See https://www.opencsw.org/ for more information about the project.

Parameters

Parameter Choices/Defaults Comments
force
boolean
added in 1.2.0 of community.general
    Choices:
  • no ←
  • yes
To allow the update process to downgrade packages to match what is present in the repository, set this to yes.
This is useful for rolling back to stable from testing, or similar operations.
name
list / elements=string / required
The name of the package.
When using state=latest, this can be '*', which updates all installed packages managed by pkgutil.

aliases: pkg
site
string
The repository path to install the package from.
Its global definition is in /etc/opt/csw/pkgutil.conf.
state
string / required
    Choices:
  • absent
  • installed
  • latest
  • present
  • removed
Whether to install (present/installed), or remove (absent/removed) packages.
The upgrade (latest) operation will update/install the packages to the latest version available.
update_catalog
boolean
    Choices:
  • no ←
  • yes
If you always want to refresh your catalog from the mirror, even when it's not stale, set this to yes.

Notes

Note

  • In order to check the availability of packages, the catalog cache under /var/opt/csw/pkgutil may be refreshed even in check mode.

Examples

- name: Install a package
  community.general.pkgutil:
    name: CSWcommon
    state: present

- name: Install a package from a specific repository
  community.general.pkgutil:
    name: CSWnrpe
    site: ftp://myinternal.repo/opencsw/kiel
    state: latest

- name: Remove a package
  community.general.pkgutil:
    name: CSWtop
    state: absent

- name: Install several packages
  community.general.pkgutil:
    name:
    - CSWsudo
    - CSWtop
    state: present

- name: Update all packages
  community.general.pkgutil:
    name: '*'
    state: latest

- name: Update all packages and force versions to match latest in catalog
  community.general.pkgutil:
    name: '*'
    state: latest
    force: yes

Authors

  • Alexander Winkler (@dermute)
  • David Ponessa (@scathatheworm)

© 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/community/general/pkgutil_module.html