Skip Navigation Links | |
Exit Print View | |
Oracle Solaris 11 Express Image Packaging System Guide Oracle Solaris 11 Express 11/10 |
1. Introduction to the Image Packaging System
2. IPS Graphical User Interfaces
Installing and Managing Packages
How to Install or Update a Package
How to View an Installation Action Without Installing
How to Verify a Package Installation
How to Fix Package Installation Errors
How to Uninstall a Package From an Inactive Boot Environment
How to Show the Contents of a Package
How to Show Information About Packages
How to List Package State Information
How to View and Delete Operation History
Image Properties for Signed Packages
Publisher Properties for Signed Packages
Configure Package Signature Properties
IPS enables you to configure package publishers and repositories.
Example 3-22 Display All Publishers
If no options or arguments are specified, all publishers configured for this image are shown.
$ pkg publisher PUBLISHER TYPE STATUS URI solaris (preferred) origin online http://pkg.oracle.com/solaris/release example.com (non-sticky) origin online http://pkg.example.com/release
Example 3-23 Display Only the Preferred Publisher
$ pkg publisher -P PUBLISHER TYPE STATUS URI solaris (preferred) origin online http://pkg.oracle.com/solaris/release
Example 3-24 Display Information About a Specific Publisher
This example displays information about the solaris publisher.
$ pkg publisher solaris Publisher: solaris Alias: Origin URI: http://pkg.oracle.com/solaris/release SSL Key: None SSL Cert: None Client UUID: 99e58a54-1119-11df-98e6-00262236a2ae Catalog Updated: October 17, 2010 08:11:06 PM Enabled: Yes
Add a publisher. To remove a publisher, use the pkg unset-publisher command. The preferred publisher cannot be removed.
Specify the preferred publisher.
Enable or disable a publisher. The preferred publisher cannot be disabled. A newly-added publisher is enabled by default.
Set publisher stickiness. A newly-added publisher is sticky by default. If a publisher is non-sticky, then a package that was installed from this publisher could be updated from another publisher.
Set publisher search order. The preferred publisher is first in the search order. A newly-added publisher is last in the search order by default.
Add or remove a publisher mirror.
Specify SSL keys and certificates for a publisher.
Change a publisher URI.
Set and unset a publisher property, and add and remove a publisher property value. See Installing Signed Packages.
Example 3-25 Adding a Publisher
Use the -g option to specify the publisher origin URI.
# pkg set-publisher -g http://pkg.example.com/release example.com
Example 3-26 Specifying the Preferred Publisher
Use the -P option to specify a publisher as the preferred publisher. The specified publisher moves to the top of the search order. You can specify the -P option when you add a publisher or you can modify an existing publisher.
# pkg set-publisher -P example.com
Example 3-27 Enabling or Disabling a Publisher
Use the -d option to disable a publisher. The preferred publisher cannot be disabled. A disabled publisher is not used in package operations such as list and install. You can modify the properties of a disabled publishers.
Use the -e option to enable a publisher.
# pkg set-publisher -d example2.com
Example 3-28 Specifying Publisher Stickiness
Use the --non-sticky option to make a publisher not sticky. A newly-added publisher is sticky by default. If a publisher is not sticky, then a package that was installed from this publisher could be updated from another publisher.
Use the --sticky option to make a publisher sticky.
# pkg set-publisher --non-sticky example.com
Example 3-29 Changing the Publisher Search Order
The preferred publisher is first in the search order. A newly-added publisher is last in the search order by default. The publisher search order is used to find packages to install. The publisher search order is used to find packages to update if the publisher that the package was originally installed from is non-sticky.
In the following example, the example2.com publisher is set to be searched before the example1.com publisher. If the example1.com publisher is the current preferred publisher, the example2.com publisher becomes the preferred publisher.
# pkg set-publisher --search-before example1.com example2.com
In the following example, the example2.com publisher is set to be searched after the example1.com publisher. If the example2.com publisher is the current preferred publisher, the example1.com publisher becomes the preferred publisher.
# pkg set-publisher --search-after example1.com example2.com
Example 3-30 Adding and Removing a Publisher Mirror
Use the -m option to add a URI as a mirror for the specified publisher. See Repository Origins and Mirrors for an explanation of the difference between an origin and a mirror. Use the -M option to remove a URI as a mirror for the specified publisher.
# pkg set-publisher -m http://pkg.example.org/release example.com $ pkg publisher PUBLISHER TYPE STATUS URI example.com (preferred) origin online http://pkg.example.com/release example.com (non-sticky) mirror online http://pkg.example.org/release
Example 3-31 Specifying SSL Keys and Certificates
Use the -k option to specify the client SSL key. Use the -c option to specify the client SSL certificate.
# pkg set-publisher -k /root/creds/example.key \ -c /root/creds/example.cert example.com
Use the --approve-ca-cert option to add the specified certificate as a CA certificate that is trusted. The hashes of the user approved CA certificates are listed in the output of the publisher subcommand for this publisher. See Example 3-24.
# pkg set-publisher --approve-ca-cert /tmp/example_file.pem example.com
Use the --revoked-ca-cert option to treat the specified certificate as revoked. The hashes of the user revoked CA certificates are listed in the output of the publisher subcommand for this publisher.
# pkg set-publisher --revoked-ca-cert a12345 example.com
Use the --unset-ca-cert option to remove the specified certificate from the list of approved and the list of revoked certificates.
# pkg set-publisher --unset-ca-cert a12345 example.com
Example 3-32 Changing a Publisher Origin URI
To change the origin URI for a publisher, add the new URI and remove the old URI. Use the -g option to add a new origin URI. Use the -G option to remove the old origin URI.
# pkg set-publisher -g http://pkg.example.com/support \ -G http://pkg.example.com/release example.com