1. Updating Systems and Adding Software in Oracle Solaris 11.4
  2. Troubleshooting Package Installation and Update
  3. Initial Troubleshooting Steps
  4. Retry Your Installation

Retry Your Installation

If you specify a package to install or update and you do not specify the publisher, the first publisher in the publisher search order that provides a package that matches that package FMRI or pattern is used as the installation source. If that publisher does not provide a version of the package that can be installed in this image, then the installation operation fails, even if another enabled publisher provides a version of the package that can be installed in this image. Take one of the following actions to address this issue:

  • Specify the publisher in the package FMRI. For example, specify pkg://solaris/ in front of the full package name.

  • Use the -P option of the pkg set-publisher command to set the publisher that provides the package version you want as the first publisher in the search order.

Two publishers should not provide packages with the same name. If this situation occurs, take one of the following actions:

  • If you no longer need any of the packages from one of the publishers, disable or unset that publisher. If packages from that publisher are currently installed, uninstall them before you disable or unset the publisher.

  • If you need both publishers, do one of the following:

    • Make sure the publisher that is not preferred is not sticky (--non-sticky), and set the publisher search order so that the publisher that provides the package you want to install is ahead of any other publisher that provides the same-named package.

    • Specify the full name of the package you want to install, including the publisher.

Use the pkg freeze and pkg facet commands to check whether a frozen or version-locked package is preventing installation or update.

Use the pkg verify -v command to check whether packaged content has been modified. Use the pkg fix command to fix any errors that were found.

Use the -nv options whenever you install or update to see what changes will be made, such as which versions of which packages will be installed or updated and whether a new BE will be created. The -v option also shows any release notes that apply to this particular install or update operation.

  • If you do not receive any error messages when you use the -nv options, run the command again without the -n option to actually perform the installation or update. Consider whether you should specify options to do the installation in a new BE or to create a backup BE if no new BE or backup BE will be created by default.

  • If you do receive error messages, take the following actions:

    • Specify more of the version you want in the package FMRI to get more information to help you diagnose and fix the problem.

    • Specify more -v options (for example, -nvv).

    • Use the pkg history command. The -l option provides complete FMRIs of changed packages. See Viewing Operation History.

If you specify multiple packages to install or update, or if you omit the package specification for an update operation, the installation or update operation fails if any of the packages cannot be installed in this image. If one package cannot be installed, no packages are installed. For more information, invoke the command again, specifying only the package that cannot be installed, specifying the full FMRI of that package, and providing one or more -v options.