This section shows the following example update scenarios for Oracle Solaris 11. If you do not have a support contract, only Example 2 is relevant.
This example shows a terminal session for upgrading a system from Oracle Solaris 11.1 to the latest SRU from the Oracle Solaris 11 support repository when you have an Oracle Solaris 11 support contract. The system's default publisher is already configured to point to the Oracle Solaris 11 support repository. See Example 3: Synchronizing sunpro-incorporation with the Latest SRU from the Oracle Solaris 11 Support Repository for details on how to do this.
The terminal session shows the following:
Lists the currently installed versions of the entire and sunpro-incorporation packages. The output reflects the versions originally delivered in Oracle Solaris 11.1.
Lists all available versions of both packages in the Oracle Solaris 11 support repository. The output shows that newer versions of both are available, reflecting the latest Oracle Solaris 11.2 SRU.
Updates the system to the latest Oracle Solaris 11.2 SRU. This is a lengthy update since it includes all SRUs delivered for Oracle Solaris 11.1 and Oracle Solaris 11.2 at the time of the update. The session shows that the system is updated in a named new boot environment, leaving the current boot environment unchanged.
Although it is not shown here, the system reports some recoverable errors during the installation of a package included in one of the Oracle S11.1 SRUs. The error messages can safely be ignored, as documented in the Oracle Solaris 11.2 Release Notes in the Oracle Solaris 11.2 Information Library.
root@x86box:~# beadm list
BE Active Mountpoint Space Policy Created
-- ------ ---------- ----- ------ -------
s11.1_example NR / 47.67G static 2014-09-15 09:14
root@x86box:~# pkg list entire
NAME (PUBLISHER) VERSION IFO
entire 0.5.11-0.175.1.0.0.24.2 i--
root@x86box:~# pkg list sunpro-incorporation
NAME (PUBLISHER) VERSION IFO
consolidation/sunpro/sunpro-incorporation 0.5.11-0.175.1.0.0.19.0 i--
root@x86box:~# pkg publisher
PUBLISHER TYPE STATUS P LOCATION
solaris origin online F https://pkg.oracle.com/solaris/support/
root@x86box:~# pkg list -af entire
NAME (PUBLISHER) VERSION IFO
entire 0.5.11-0.175.2.2.0.5.0 ---
entire 0.5.11-0.175.2.1.0.5.0 ---
entire 0.5.11-0.175.2.0.0.42.0 ---
entire 0.5.11-0.175.1.21.0.4.1 ---
entire 0.5.11-0.175.1.20.0.5.0 ---
...
entire 0.5.11-0.175.1.0.0.24.2 ---
...
root@x86box:~# pkg list -af sunpro-incorporation
NAME (PUBLISHER) VERSION IFO
consolidation/sunpro/sunpro-incorporation 0.5.11-0.175.2.1.0.4.0 ---
consolidation/sunpro/sunpro-incorporation 0.5.11-0.175.2.0.0.37.0 ---
consolidation/sunpro/sunpro-incorporation 0.5.11-0.175.1.19.0.4.0 ---
...
consolidation/sunpro/sunpro-incorporation 0.5.11-0.175.1.0.0.19.0 i--
...
root@x86box:~# pkg update --accept --be-name s11.1_example_s11.2sru02
------------------------------------------------------------
Package: pkg://solaris/consolidation/osnet/osnet-incorporation@0.5.11,5.11-0.175.2.2.0.5.2:20140904T200410Z
License: lic_OTN
...
Packages to remove: 7
Packages to install: 90
Packages to update: 498
Mediators to change: 2
Create boot environment: Yes
Create backup boot environment: No
DOWNLOAD PKGS FILES XFER (MB) SPEED
Completed 595/595 40141/40141 872.6/872.6 1.2M/s
PHASE ITEMS
Removing old actions 7707/7707
Installing new actions 29119/29119
...
Updating modified actions 30920/30920
Updating package state database Done
Updating package cache 505/505
Updating image state Done
Creating fast lookup database Done
A clone of s11.1_example exists and has been updated and activated.
On the next boot the Boot Environment s11.1_example_s11.2sru02 will be
mounted on '/'. Reboot when ready to switch to this updated BE.
---------------------------------------------------------------------------
NOTE: Please review release notes posted at:
http://www.oracle.com/pls/topic/lookup?ctx=E26502&id=SERNS
---------------------------------------------------------------------------
root@x86box:~# beadm list
BE Active Mountpoint Space Policy Created
-- ------ ---------- ----- ------ -------
s11.1_example N / 9.80M static 2014-09-15 09:14
s11.1_example_s11.2sru02 R - 53.74G static 2014-09-15 09:59
root@x86box:~# reboot
Connection to x86box.example.com closed by remote host.
Connection to x86box.example.com closed.
After the system is rebooted, log in as a normal user and verify that both the entire and sunpro-incorporation packages have been updated:
... Oracle Corporation SunOS 5.11 11.2 August 2014 (x86box)% beadm list BE Active Mountpoint Space Policy Created -- ------ ---------- ----- ------ ------- s11.1_example - - 12.35M static 2014-09-15 09:14 s11.1_example_s11.2sru02 NR / 53.99G static 2014-09-15 09:59 (x86box)% pkg list entire NAME (PUBLISHER) VERSION IFO entire 0.5.11-0.175.2.2.0.5.0 i-- (x86box)% pkg list sunpro-incorporation NAME (PUBLISHER) VERSION IFO consolidation/sunpro/sunpro-incorporation 0.5.11-0.175.2.1.0.4.0 i-- (x86box)%
root@x86box:~# pkg update --accept --be-name s11.1_example_s11.2sru01 entire@0.5.11,0.5.11-0.175.2.1
In this example, the system has been updated to Oracle Solaris 11.2 from the Oracle Solaris 11 release repository. The example shows that the release repository has a newer version of the sunpro-incorporation package than the version normally installed by pkg install from the release repository.
The terminal session shows the following tasks:
Verifies that:
System default publisher points at the Oracle Solaris 11 release repository
System entire package version is that of Oracle Solaris 11.2 build 42
System sunpro-incorporation package version is that of Oracle Solaris 11.2 build 37
Oracle Solaris 11 release repository contains a newer version of sunpro-incorporation.
Unlocks the sunpro-incorporation package. Unlocking the sunpro-incorporation package enables pkg update to install the newer version of the package.
Updates the sunpro-incorporation package from the Oracle Solaris 11 release repository to create a new boot image
Reboots the new boot image
root@x86box:~# pkg publisher
PUBLISHER TYPE STATUS P LOCATION
solaris origin online F http://pkg.oracle.com/solaris/release/
root@x86box:~# pkg list entire
NAME (PUBLISHER) VERSION IFO
entire 0.5.11-0.175.2.0.0.42.0 i--
root@x86box:~# pkg list sunpro-incorporation
NAME (PUBLISHER) VERSION IFO
consolidation/sunpro/sunpro-incorporation 0.5.11-0.175.2.0.0.37.0 i--
root@x86box:~# pkg list -af sunpro-incorporation
NAME (PUBLISHER) VERSION IFO
consolidation/sunpro/sunpro-incorporation 0.5.11-0.175.2.1.0.4.0 ---
consolidation/sunpro/sunpro-incorporation 0.5.11-0.175.2.0.0.37.0 i--
root@x86box:~# pkg facet
FACET VALUE SRC
root@x86box:~# pkg change-facet facet.version-lock.consolidation/sunpro/sunpro-incorporation=false
Packages to change: 1
Variants/Facets to change: 1
Create boot environment: No
Create backup boot environment: Yes
PHASE ITEMS
Removing old actions 1/1
Updating package state database Done
Updating package cache 0/0
Updating image state Done
Creating fast lookup database Done
Updating package cache 1/1
root@x86box:~# pkg update -nv sunpro-incorporation
Packages to update: 6
Estimated space available: 49.37 GB
Estimated space to be consumed: 57.27 MB
Create boot environment: No
Create backup boot environment: Yes
Rebuild boot archive: No
Changed packages:
solaris
consolidation/sunpro/sunpro-incorporation
0.5.11,5.11-0.175.2.0.0.37.0:20140414T130238Z -> 0.5.11,5.11-0.175.2.1.0.4.0:20140728T200719Z
developer/assembler
0.5.11,5.11-0.175.2.0.0.37.0:20140414T130241Z -> 0.5.11,5.11-0.175.2.1.0.4.0:20140728T200720Z
system/library/c++-runtime
0.5.11,5.11-0.175.2.0.0.37.0:20140414T130401Z -> 0.5.11,5.11-0.175.2.1.0.4.0:20140728T200722Z
system/library/math
0.5.11,5.11-0.175.2.0.0.37.0:20140414T130409Z -> 0.5.11,5.11-0.175.2.1.0.4.0:20140728T200728Z
system/library/mmheap
0.5.11,5.11-0.175.2.0.0.23.0:20130916T153150Z -> 0.5.11,5.11-0.175.2.1.0.4.0:20140728T200732Z
system/library/openmp
0.5.11,5.11-0.175.2.0.0.37.0:20140414T130412Z -> 0.5.11,5.11-0.175.2.1.0.4.0:20140728T200733Z
root@x86box:~# pkg update --be-name s11.2_plus_studio12.4_runtime -v sunpro-incorporation
Packages to update: 6
Estimated space available: 49.37 GB
Estimated space to be consumed: 57.27 MB
Create boot environment: Yes
Activate boot environment: Yes
Create backup boot environment: No
Rebuild boot archive: No
Changed packages:
solaris
consolidation/sunpro/sunpro-incorporation
0.5.11,5.11-0.175.2.0.0.37.0:20140414T130238Z -> 0.5.11,5.11-0.175.2.1.0.4.0:20140728T200719Z
developer/assembler
0.5.11,5.11-0.175.2.0.0.37.0:20140414T130241Z -> 0.5.11,5.11-0.175.2.1.0.4.0:20140728T200720Z
system/library/c++-runtime
0.5.11,5.11-0.175.2.0.0.37.0:20140414T130401Z -> 0.5.11,5.11-0.175.2.1.0.4.0:20140728T200722Z
system/library/math
0.5.11,5.11-0.175.2.0.0.37.0:20140414T130409Z -> 0.5.11,5.11-0.175.2.1.0.4.0:20140728T200728Z
system/library/mmheap
0.5.11,5.11-0.175.2.0.0.23.0:20130916T153150Z -> 0.5.11,5.11-0.175.2.1.0.4.0:20140728T200732Z
system/library/openmp
0.5.11,5.11-0.175.2.0.0.37.0:20140414T130412Z -> 0.5.11,5.11-0.175.2.1.0.4.0:20140728T200733Z
DOWNLOAD PKGS FILES XFER (MB) SPEED
Completed 6/6 46/46 3.1/3.1 6.5M/s
PHASE ITEMS
Removing old actions 21/21
Installing new actions 27/27
Updating modified actions 33/33
Updating package state database Done
Updating package cache 6/6
Updating image state Done
Creating fast lookup database Done
Updating package cache 1/1
A clone of s11.2_42 exists and has been updated and activated.
On the next boot the Boot Environment s11.2_plus_studio12.4_runtime will be
mounted on '/'. Reboot when ready to switch to this updated BE.
Updating package cache 1/1
root@x86box:~# reboot
Connection to x86box.example.com closed by remote host.
Connection to x86box.example.com closed.
The following commands are performed as a normal user to verify:
The sunpro-incorporation package is unlocked.
The sunpro-incorporation package and one of its incorporated packages have both been updated to version 0.5.11-0.175.2.1.0.4.0.
The rest of the system remains at version 0.5.11-0.175.2.0.0.42.0, same as in Oracle Solaris 11.2.
(x86box)% pkg facet FACET VALUE SRC facet.version-lock.consolidation/sunpro/sunpro-incorporation False local (x86box)% pkg list entire NAME (PUBLISHER) VERSION IFO entire 0.5.11-0.175.2.0.0.42.0 i-- (x86box)% pkg list -af sunpro-incorporation NAME (PUBLISHER) VERSION IFO consolidation/sunpro/sunpro-incorporation 0.5.11-0.175.2.1.0.4.0 i-- consolidation/sunpro/sunpro-incorporation 0.5.11-0.175.2.0.0.37.0 --- (x86box)% pkg list sunpro-incorporation NAME (PUBLISHER) VERSION IFO consolidation/sunpro/sunpro-incorporation 0.5.11-0.175.2.1.0.4.0 i-- (x86box)% pkg list system/library/openmp NAME (PUBLISHER) VERSION IFO system/library/openmp 0.5.11-0.175.2.1.0.4.0 i-- (x86box)%
This example shows how to synchronize the system that was used in Example 2: Updating the sunpro-incorporation Package from the Oracle Solaris 11 Release Repository with the latest SRU from the Oracle Solaris 11 support repository.
The example assumes that a key and certificate for the Oracle Solaris 11 support repository were already copied to the /var/pkg/ssl directory, as described in the article How to Update Oracle Solaris 11 Systems From Oracle Support Repositories on the Oracle Technology Network.
The terminal session shows how to do the following:
Use the key and certificate to configure the system's default publisher to point to the Oracle Solaris 11 support repository https://pkg.oracle.com/solaris/support, as explained in the article.
Update the system to the latest Oracle Solaris 11.2 SRU.
Relock the sunpro-incorporation package after the system has been updated to the latest Oracle Solaris 11 SRU.
Note that the system can still be updated to a Oracle Solaris 11.2 SRU if the sunpro-incorporation package has been unlocked and updated from the release repository, as described in the previous example.
The sunpro-incorporation package cannot be locked unless the package version is in sync with the rest of the system. In this example, the system is updated before the package is relocked.
(x86box)% beadm list
BE Active Mountpoint Space Policy Created
-- ------ ---------- ----- ------ -------
s11.2_42 - - 9.26M static 2014-09-02 18:10
s11.2_plus_ss12.4_rtlibs NR / 45.89G static 2014-09-09 17:09
(x86box)% pkg list entire
NAME (PUBLISHER) VERSION IFO
entire 0.5.11-0.175.2.0.0.42.0 i--
(x86box)% pkg list sunpro-incorporation
NAME (PUBLISHER) VERSION IFO
consolidation/sunpro/sunpro-incorporation 0.5.11-0.175.2.1.0.4.0 i--
(x86box)% su - root
Password:
...
root@x86box:~# pkg publisher
PUBLISHER TYPE STATUS P LOCATION
solaris origin online F http://pkg.oracle.com/solaris/release/
root@x86box:~# ls -l /var/pkg/ssl
total 6
-rw-r--r-- 1 root root 786 Sep 9 15:44 pkg.oracle.com.key.certificate.pem
-rw-r--r-- 1 root root 887 Sep 9 15:44 pkg.oracle.com.key.pem
root@x86box:~# pkg set-publisher \
> -k /var/pkg/ssl/pkg.oracle.com.key.pem \
> -c /var/pkg/ssl/pkg.oracle.com.key.certificate.pem \
> -g https://pkg.oracle.com/solaris/support/ \
> -G http://pkg.oracle.com/solaris/release/ solaris
root@x86box:~#
root@x86box:~# pkg publisher
PUBLISHER TYPE STATUS P LOCATION
solaris origin online F https://pkg.oracle.com/solaris/support/
root@x86box:~# beadm list
BE Active Mountpoint Space Policy Created
-- ------ ---------- ----- ------ -------
s11.2_42 - - 9.26M static 2014-09-02 18:10
s11.2_plus_ss12.4_rtlibs NR / 46.00G static 2014-09-09 17:09
root@x86box:~# pkg update --accept --be-name s11.2_sru01 entire
Packages to remove: 1
Packages to update: 63
Create boot environment: Yes
Create backup boot environment: No
DOWNLOAD PKGS FILES XFER (MB) SPEED
Completed 64/64 3548/3548 228.4/228.4 1.5M/s
PHASE ITEMS
Removing old actions 475/475
Installing new actions 522/522
Updating modified actions 4272/4272
Updating package state database Done
Updating package cache 64/64
Updating image state Done
Creating fast lookup database Done
Updating package cache 1/1
A clone of s11.2_plus_ss12.4_rtlibs exists and has been updated and activated.
On the next boot the Boot Environment s11.2_sru01 will be
mounted on '/'. Reboot when ready to switch to this updated BE.
Updating package cache 1/1
root@x86box:~# beadm list
BE Active Mountpoint Space Policy Created
-- ------ ---------- ----- ------ -------
s11.2_42 - - 9.26M static 2014-09-02 18:10
s11.2_plus_ss12.4_rtlibs N / 376.0K static 2014-09-09 17:09
s11.2_sru01 R - 47.72G static 2014-09-09 17:29
root@x86box:~# reboot
Connection to x86box.example.com closed by remote host.
Connection to x86box.example.com closed.
...
The terminal session shows how to verify the following as a normal user:
The system has been updated to Oracle Solaris 11.2 SRU 1.
The sunpro-incorporation package remains at the version previously updated from the Oracle Solaris 11 release repository.
(x86box)% beadm list BE Active Mountpoint Space Policy Created -- ------ ---------- ----- ------ ------- s11.2_42 - - 9.26M static 2014-09-02 18:10 s11.2_plus_ss12.4_rtlibs - - 10.15M static 2014-09-09 17:09 s11.2_sru01 NR / 47.83G static 2014-09-09 17:29 (x86box)% pkg list entire NAME (PUBLISHER) VERSION IFO entire 0.5.11-0.175.2.1.0.5.0 i-- (x86box)% pkg list sunpro-incorporation NAME (PUBLISHER) VERSION IFO consolidation/sunpro/sunpro-incorporation 0.5.11-0.175.2.1.0.4.0 i--
Now that the system entire package has been updated, the sunpro-incorporation package is in sync with the rest of the system.
The terminal session shows the root user locking the sunpro-incorporation package in sync with the rest of the system.
(x86box)% su - root
Password:
...
root@x86box:~# pkg facet
FACET VALUE SRC
facet.version-lock.consolidation/sunpro/sunpro-incorporation False local
root@x86box:~# pkg change-facet facet.version-lock.consolidation/sunpro/sunpro-incorporation=true
Packages to change: 1
Variants/Facets to change: 1
Create boot environment: No
Create backup boot environment: Yes
PHASE ITEMS
Installing new actions 1/1
Updating package state database Done
Updating package cache 0/0
Updating image state Done
Creating fast lookup database Done
Updating package cache 1/1
root@x86box:~# beadm list
BE Active Mountpoint Space Policy Created
-- ------ ---------- ----- ------ -------
s11.2_42 - - 9.26M static 2014-09-02 18:10
s11.2_plus_ss12.4_rtlibs - - 10.15M static 2014-09-09 17:09
s11.2_sru01 NR / 48.00G static 2014-09-09 17:29
s11.2_sru01-backup-1 - - 100.0K static 2014-09-10 12:41
root@x86box:~# pkg facet
FACET VALUE SRC
facet.version-lock.consolidation/sunpro/sunpro-incorporation True local
root@x86box:~#