Managing Package Publishers

IPS enables you to configure package publishers and repositories.

How to Display Publisher Information

• Use the pkg publisher command to display information about package publishers configured for this image.

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

How to Add, Modify, or Remove a Package Publisher

• Use the pkg set-publisher command to perform the following operations:

  • 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