# salt.modules.aixpkg

Package support for AIX

Important

If you feel that Salt should be using this module to manage filesets or rpm packages on a minion, and it is using a different module (or gives an error similar to 'pkg.install' is not available), see here.

salt.modules.aixpkg.available_version(*names, **kwargs)

  This function is an alias of `latest_version`.

  Return the latest available version of the named fileset/rpm package available for upgrade or installation. If more than one fileset/rpm package name is specified, a dict of name/version pairs is returned.

  If the latest version of a given fileset/rpm package is already installed, an empty string will be returned for that package.

  Changed in version 3005.

  CLI Example:

      salt '*' pkg.latest_version <package name>
      salt '*' pkg.latest_version <package1> <package2> <package3> ...

  Note: currently only functional for rpm packages due to filesets do not have a specific location to check

    Requires yum of dnf available in order to query a repository

  This function will always return an empty string for unfound fileset/rpm package.

salt.modules.aixpkg.install(name=None, refresh=False, pkgs=None, version=None, test=False, **kwargs)

  Install the named fileset(s)/rpm package(s).

  Changed in version 3005:

  preference to install rpm packages are to use in the following order:

    /opt/freeware/bin/dnf /opt/freeware/bin/yum /usr/bin/yum /usr/bin/rpm

  name

    The name of the fileset or rpm package to be installed.

  refresh

    Whether or not to update the yum database before executing.

  pkgs

    A list of filesets and/or rpm packages to install. Must be passed as a python list. The `name` parameter will be ignored if this option is passed.

  version

    Install a specific version of a fileset/rpm package. (Unused at present).

    Note

    Remember that versions that contain a single . will be interpreted as numbers and must be double-quoted. For example, version `3006.10` will be rendered as `3006.1`. To pass `3006.10` you'll need to use double-quotes. `version="'3006.10'"`

  test

    Verify that command functions correctly.

  Returns a dict containing the new fileset(s)/rpm package(s) names and versions:

  > {'<package>': {'old': '<old-version>',

  >   'new': '<new-version>'}}

  CLI Example:

      salt '*' pkg.install /stage/middleware/AIX/bash-4.2-3.aix6.1.ppc.rpm
      salt '*' pkg.install /stage/middleware/AIX/bash-4.2-3.aix6.1.ppc.rpm refresh=True
      salt '*' pkg.install /stage/middleware/AIX/VIOS2211_update/tpc_4.1.1.85.bff
      salt '*' pkg.install /cecc/repos/aix72/TL3/BASE/installp/ppc/bos.rte.printers_7.2.2.0.bff
      salt '*' pkg.install /stage/middleware/AIX/Xlc/usr/sys/inst.images/xlC.rte
      salt '*' pkg.install /stage/middleware/AIX/Firefox/ppc-AIX53/Firefox.base
      salt '*' pkg.install /cecc/repos/aix72/TL3/BASE/installp/ppc/bos.net
      salt '*' pkg.install pkgs='["foo", "bar"]'
      salt '*' pkg.install libxml2

salt.modules.aixpkg.latest_version(*names, **kwargs)

  Return the latest available version of the named fileset/rpm package available for upgrade or installation. If more than one fileset/rpm package name is specified, a dict of name/version pairs is returned.

  If the latest version of a given fileset/rpm package is already installed, an empty string will be returned for that package.

  Changed in version 3005.

  CLI Example:

      salt '*' pkg.latest_version <package name>
      salt '*' pkg.latest_version <package1> <package2> <package3> ...

  Note: currently only functional for rpm packages due to filesets do not have a specific location to check

    Requires yum of dnf available in order to query a repository

  This function will always return an empty string for unfound fileset/rpm package.

salt.modules.aixpkg.list_pkgs(versions_as_list=False, **kwargs)

  List the filesets/rpm packages currently installed as a dict:

      {'<package_name>': '<version>'}

  CLI Example:

      salt '*' pkg.list_pkgs

salt.modules.aixpkg.remove(name=None, pkgs=None, **kwargs)

  Remove specified fileset(s)/rpm package(s).

  name

    The name of the fileset or rpm package to be deleted.

  Changed in version 3005:

  preference to install rpm packages are to use in the following order:

    /opt/freeware/bin/dnf /opt/freeware/bin/yum /usr/bin/yum /usr/bin/rpm

  pkgs

    A list of filesets and/or rpm packages to delete. Must be passed as a python list. The `name` parameter will be ignored if this option is passed.

  Returns a list containing the removed packages.

  CLI Example:

      salt '*' pkg.remove <fileset/rpm package name>
      salt '*' pkg.remove tcsh
      salt '*' pkg.remove xlC.rte
      salt '*' pkg.remove Firefox.base.adt
      salt '*' pkg.remove pkgs='["foo", "bar"]'

salt.modules.aixpkg.upgrade_available(name, **kwargs)

  Check whether or not an upgrade is available for a given package

  Changed in version 3005.

  CLI Example:

      salt '*' pkg.upgrade_available <package name>

  Note: currently only functional for rpm packages due to filesets do not have a specific location to check

    Requires yum of dnf available in order to query a repository

salt.modules.aixpkg.version(*names, **kwargs)

  Return the current installed version of the named fileset/rpm package If more than one fileset/rpm package name is specified a dict of name/version pairs is returned.

  Changed in version 3005.

  CLI Example:

      salt '*' pkg.latest_version <package name>
      salt '*' pkg.latest_version <package1> <package2> <package3> ...