Previewing an Operation

Many of the commands shown in this chapter and in Chapter 5, Configuring Installed Images have an -n option that enables you to see what the command will do without making any changes.

Tip - Best practice is to use the -n option whenever it is available. Use the -n option with one or more verbose options (-nv, -nvv) and review the effects of the command before you execute the command without the -n option.

The following example shows information about a package installation that is not actually performed:

# pkg install -nv group/feature/amp
           Packages to install: 8
     Estimated space available: 112.19 GB
Estimated space to be consumed: 452.42 MB
       Create boot environment: No
Create backup boot environment: No
            Services to change: 2
          Rebuild boot archive: No
Changed packages:
solaris
  database/mysql-51
    None -> 5.1.37,5.11-0.174.0.0.0.0.504:20110920T230125Z
  group/feature/amp
    None -> 0.5.11,5.11-0.174.0.0.0.0.2559:20110921T191255Z
  web/php-52
    None -> 5.2.17,5.11-0.174.0.0.0.0.504:20110921T041858Z
  web/php-52/extension/php-apc
    None -> 3.0.19,5.11-0.174.0.0.0.0.504:20110921T041245Z
  web/php-52/extension/php-mysql
    None -> 5.2.17,5.11-0.174.0.0.0.0.504:20110921T041411Z
  web/server/apache-22/module/apache-dtrace
    None -> 0.3.1,5.11-0.174.0.0.0.0.504:20110921T042357Z
  web/server/apache-22/module/apache-fcgid
    None -> 2.3.6,5.11-0.174.0.0.0.0.504:20110921T042430Z
  web/server/apache-22/module/apache-php5
    None -> 5.2.17,5.11-0.174.0.0.0.0.504:20110921T042738Z
Services:
  restart_fmri:
    svc:/system/manifest-import:default
    svc:/system/rbac:default

The following command produces a large amount of output since so many packages would be affected. Notice the amount of additional space that would be used is in gigabytes, not megabytes. This operation might require a large amount of time and cause a large amount of network traffic between this image and the package repository. Notice that a new BE would not be created by default, but a backup BE would be created. See Boot Environment Policy Image Properties for information about when BEs are created.

# pkg change-facet -nv facet.locale.*=true
            Packages to update:       831
     Variants/Facets to change:         1
     Estimated space available: 112.19 GB
Estimated space to be consumed:   2.96 GB
       Create boot environment:        No
Create backup boot environment:       Yes
          Rebuild boot archive:        No
Changed variants/facets:
    facet facet.locale.*: True
Changed packages:
solaris
  ...

Skip Navigation Links
Exit Print View
	Adding and Updating Oracle Solaris 11 Software Packages Oracle Solaris 11 Information Library