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:

$ pfexec pkg install -nv group/feature/amp
           Packages to install: 5
     Estimated space available: 112.19 GB
Estimated space to be consumed: 374.19 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.175.1.0.0.21.0:20120723T165236Z
  database/mysql-common
    None -> 0.5.11,5.11-0.175.1.0.0.21.0:20120723T165447Z 
  group/feature/amp
    None -> 0.5.11,5.11-0.175.1.0.0.21.0:20120723T182057Z
  web/server/apache-22/module/apache-dtrace
    None -> 0.3.1,5.11-0.175.1.0.0.21.0:20120723T174611Z
  web/server/apache-22/module/apache-fcgid
    None -> 2.3.6,5.11-0.175.1.0.0.21.0:20120723T174613Z
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.

$ pfexec 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.1 Software Packages Oracle Solaris 11.1 Information Library