<?xml version="1.0" encoding="utf-8"?>

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd">

<book id="pkgmgr" label="fcs" lang="en"><title><trademark class="registered">Oracle</trademark> Solaris 11 Express Package Manager Online Help</title>

<bookinfo><authorgroup><author><firstname>Oracle</firstname>

<surname>Corporation</surname>

</author>

</authorgroup>

<pubsnumber>822-7173-11</pubsnumber>

<releaseinfo>Oracle Solaris 11 Express</releaseinfo>

<pubdate>November 2010</pubdate>

<publisher><publishername>Oracle Corporation</publishername>

<address><street>500 Oracle Parkway</street>

<city>Redwood City</city>

<state>CA</state>

<postcode>94065</postcode>

<country>U.S.A.</country>

</address>

</publisher>

<copyright><year>2008, 2010</year>

</copyright>

<legalnotice><para>This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.</para>

<para>The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.</para>

<para>If this is software or related software documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:</para>

<para>U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are &#8220;commercial computer software&#8221; or &#8220;commercial technical data&#8221; pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.</para>

<para>This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.</para>

<para>Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.</para>

<para>AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. UNIX is a registered trademark licensed through X/Open Company, Ltd.</para>

<para>This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.</para>

<para lang="fr"></para>

<para>Ce logiciel et la documentation qui l&#8217;accompagne sont prot&#233;g&#233;s par les lois sur la propri&#233;t&#233; intellectuelle. Ils sont conc&#233;d&#233;s sous licence et soumis &#224; des restrictions d&#8217;utilisation et de divulgation. Sauf disposition de votre contrat de licence ou de la loi, vous ne pouvez pas copier, reproduire, traduire, diffuser, modifier, breveter, transmettre, distribuer, exposer, ex&#233;cuter, publier ou afficher le logiciel, m&#234;me partiellement, sous quelque forme et par quelque proc&#233;d&#233; que ce soit. Par ailleurs, il est interdit de proc&#233;der &#224; toute ing&#233;nierie inverse du logiciel, de le d&#233;sassembler ou de le d&#233;compiler, except&#233; &#224; des fins d&#8217;interop&#233;rabilit&#233; avec des logiciels tiers ou tel que prescrit par la loi.</para>

<para>Les informations fournies dans ce document sont susceptibles de modification sans pr&#233;avis. Par ailleurs, Oracle Corporation ne garantit pas qu&#8217;elles soient exemptes d&#8217;erreurs et vous invite, le cas &#233;ch&#233;ant, &#224; lui en faire part par &#233;crit.</para>

<para>Si ce logiciel, ou la documentation qui l&#8217;accompagne, est conc&#233;d&#233; sous licence au Gouvernement des Etats-Unis, ou &#224; toute entit&#233; qui d&#233;livre la licence de ce logiciel ou l&#8217;utilise pour le compte du Gouvernement des Etats-Unis, la notice suivante s&#8217;applique :</para>

<para>U.S. GOVERNMENT RIGHTS. Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.</para>

<para>Ce logiciel ou mat&#233;riel a &#233;t&#233; d&#233;velopp&#233; pour un usage g&#233;n&#233;ral dans le cadre d&#8217;applications de gestion des informations. Ce logiciel ou mat&#233;riel n&#8217;est pas con&#231;u ni n&#8217;est destin&#233; &#224; &#234;tre utilis&#233; dans des applications &#224; risque, notamment dans des applications pouvant causer des dommages corporels. Si vous utilisez ce logiciel ou mat&#233;riel dans le cadre d&#8217;applications dangereuses, il est de votre responsabilit&#233; de prendre toutes les mesures de secours, de sauvegarde, de redondance et autres mesures n&#233;cessaires &#224; son utilisation dans des conditions optimales de s&#233;curit&#233;. Oracle Corporation et ses affili&#233;s d&#233;clinent toute responsabilit&#233; quant aux dommages caus&#233;s par l&#8217;utilisation de ce logiciel ou mat&#233;riel pour ce type d&#8217;applications.</para>

<para>Oracle et Java sont des marques d&#233;pos&#233;es d&#8217;Oracle Corporation et/ou de ses affili&#233;s.Tout autre nom mentionn&#233; peut correspondre &#224; des marques appartenant &#224; d&#8217;autres propri&#233;taires qu&#8217;Oracle.</para>

<para>AMD, Opteron, le logo AMD et le logo AMD Opteron sont des marques ou des marques d&#233;pos&#233;es d&#8217;Advanced Micro Devices. Intel et Intel Xeon sont des marques ou des marques d&#233;pos&#233;es d&#8217;Intel Corporation. Toutes les marques SPARC sont utilis&#233;es sous licence et sont des marques ou des marques d&#233;pos&#233;es de SPARC International, Inc. UNIX est une marque d&#233;pos&#233;e conc&#233;d&#233; sous license par X/Open Company, Ltd.</para>

</legalnotice>

</bookinfo>

<chapter id="about"><title>About Package Manager</title>

<para>Package Manager is a graphical user interface (GUI) for the Oracle Solaris Image Packaging System (IPS).</para>

<para>See the <xref linkend="glossary"/> for definitions of terms used in this document.</para>

<sect1 id="gikcw"><title>Oracle Solaris Image Packaging System</title>

<para>Oracle Solaris Image Packaging System (IPS) is a software delivery system that interacts with a package repository on a network. IPS is a framework that provides software lifecycle management capabilities, including software installation, upgrade, and removal.</para>

<para>After you install the Oracle Solaris operating system, you might find that some of the software you want to use is not available. This software probably is available in an IPS package repository. You can use Package Manager or the <literal>pkg</literal>(1M) command to download and install packages from a package repository.</para>

<para>IPS also enables you to create your own IPS package repository, publish your own IPS packages, and create a mirror of an existing repository. For more information about IPS, see the <citetitle>Oracle Solaris 11 Express Image Packaging System Guide</citetitle>.</para>

</sect1>

<sect1 id="pm-win"><title>Package Manager</title>

<para>Package Manager provides a subset of the functionality offered by the IPS command-line interface.</para>

<para>Package Manager enables you to perform the following tasks:</para>

<itemizedlist><listitem><para>Find, install, update, and remove IPS packages. See <xref linkend="manage-pkg"/>.</para>

</listitem>

<listitem><para>Update your system (update all the packages on your system). See <xref linkend="update_all"/>.</para>

</listitem>

<listitem><para>Add, modify, and delete IPS package publishers. See <xref linkend="manage-publisher"/>.</para>

</listitem>

<listitem><para>List, rename, delete, and manage boot environments. See <xref linkend="manage-be"/>.</para>

</listitem>

<listitem><para>Create a WebInstall installation file (<filename>.p5i</filename>). See <xref linkend="webinstall"/>.</para>

</listitem>

</itemizedlist>

<para>This documentation refers to the following features of the Package Manager window:</para>

<itemizedlist><listitem><para>The large pane in the center of the window is the package list pane. Sometimes this pane shows informational messages, but usually this pane contains a list of packages.</para>

</listitem>

<listitem><para>The menu bar at the top of the window provides most Package Manager functionality.</para>

</listitem>

<listitem><para>The tool bar just below the menu bar has buttons on the left that provide some often-used operations. The buttons on the left of the separator have global functionality: Update all packages that have updates available or refresh the list of packages and package status. The buttons on the right of the separator only operate on selected packages.</para>

</listitem>

<listitem><para>The Search field on the right of the tool bar helps control the content of the package list pane. See <xref linkend="search-pkg"/>.</para>

</listitem>

<listitem><para>The <guimenu>Publisher</guimenu> drop-down menu below the buttons helps control the content of the package list pane and also enables you to add a new publisher. See <xref linkend="list-pkg"/> &#8220;By Publisher.&#8221;</para>

</listitem>

<listitem><para>The <guimenu>View</guimenu> drop-down menu below the Search field helps control the content of the package list pane. See Listing Packages &#8220;By Package Status.&#8221;</para>

</listitem>

<listitem><para>The category pane below the <guimenu>Publisher</guimenu> menu helps control the content of the package list pane. See Listing Packages &#8220;By Category.&#8221;</para>

</listitem>

<listitem><para>Below the list of software categories is a list of searches that you have performed in this session.</para>

</listitem>

<listitem><para>Below the package list pane is the package details pane. See <xref linkend="package-version"/>.</para>

</listitem>

</itemizedlist>

</sect1>

</chapter>

<chapter id="manage-pkg"><title>Managing Packages</title>

<para>You can list packages according to various criteria. You can install, update, and remove packages.</para>

<sect1 id="list-pkg"><title>Listing Packages</title>

<para>The list of packages in the Package Manager list pane is affected by the selections you make in the <guimenu>Publisher</guimenu> drop-down menu, the <guimenu>View</guimenu> drop-down menu, the categories pane, and the Search field.</para>

<para>You can reorder the package list by clicking the column headings.</para>

<para>You can use the <guibutton>Refresh</guibutton> button or the <menuchoice><guimenu>Package</guimenu><guimenuitem>Refresh</guimenuitem></menuchoice> menu option to reread repository catalogs and update the list of packages and package status. A refresh also is attempted whenever you open Package Manager.</para>

<subtopic id="gkihe"><title>By Publisher</title>

<para>The <guimenu>Publisher</guimenu> drop-down menu enables you to list packages according to publisher.</para>

<itemizedlist><listitem><para>The top of the menu lists the name of each publisher that you have added using the Add Publisher dialog or using the <literal>pkg</literal> command. When you select one of these publishers, the package list pane shows only packages that are available from that selected publisher. The package list pane shows only the Name, Status, and Summary columns because the publisher is the same for every package.</para>

</listitem>

<listitem><para><guimenuitem>All Publishers</guimenuitem> &#8212; Shows packages from all publishers in the package list pane. The package list pane shows columns Name, Status, Publisher, and Summary.</para>

<para>Example: To list all media device drivers that have updates available from all publishers, select <guimenuitem>All Publishers</guimenuitem> from the <guimenu>Publisher</guimenu> menu, select the <menuchoice><guimenu>Drivers</guimenu><guimenuitem>Media</guimenuitem></menuchoice> category, and select <guimenuitem>Updates</guimenuitem> from the <guimenu>View</guimenu> menu.</para>

</listitem>

<listitem><para><guimenuitem>All Installed Packages</guimenuitem> &#8212; Shows all packages that are installed from all publishers.</para>

<para>Example: To list all the font packages that are currently installed from the <literal>oracle.com</literal> publisher, select <guimenuitem>All Installed Packages</guimenuitem> from the <guimenu>Publisher</guimenu> menu, select the <menuchoice><guimenu>System</guimenu><guimenuitem>Fonts</guimenuitem></menuchoice> category, click on the Publisher column heading to sort the list by Publisher, and scroll down to the <literal>oracle.com</literal> entries.</para>

</listitem>

<listitem><para><guimenuitem>All Publishers (Search)</guimenuitem> &#8212; Shows an informational message in the package list pane instead of a list of packages. The message lists all publishers that you have configured and reminds you how to view all packages from those publishers. See <xref linkend="search-pkg"/> for information about searching with <guimenuitem>All Publishers (Search)</guimenuitem>.</para>

</listitem>

<listitem><para><guimenuitem>Add...</guimenuitem> &#8212; Opens the Add Publisher window.</para>

</listitem>

</itemizedlist>

</subtopic>

<subtopic id="gkihp"><title>By Package Status</title>

<para>The <guimenu>View</guimenu> drop-down menu enables you to list packages according to package status. Package status can be installed, not installed, or an update is available. The icons displayed on the <guimenu>View</guimenu> menu match the icons displayed in the Status column of the package list pane.</para>

<itemizedlist><listitem><para><guimenuitem>All Packages</guimenuitem> &#8212; Shows all packages available from the selected publisher in the selected category or matching the specified search string.</para>

<para>Example: To list all Oracle Solaris Studio packages that are available from the <literal>oracle.com</literal> publisher, select <literal>oracle.com</literal> from the <guimenu>Publisher</guimenu> menu, select <guimenuitem>All Packages</guimenuitem> from the <guimenu>View</guimenu> menu, and enter <literal>studio</literal> in the Search field.</para>

</listitem>

<listitem><para><guimenuitem>Installed Packages</guimenuitem> &#8212; Shows all installed packages from the selected publisher in the selected category or matching the specified search string. See also the <menuchoice><guimenu>Publisher</guimenu><guimenuitem>All Installed Packages</guimenuitem></menuchoice> option.</para>

<para>Example: To list all web server packages that are installed from the <literal>oracle.com</literal> publisher, select <guimenuitem>Installed Packages</guimenuitem> from the <guimenu>View</guimenu> menu, select <literal>oracle.com</literal> from the <guimenu>Publisher</guimenu> menu, and select the <menuchoice><guimenu>Web Services</guimenu><guimenuitem>Application and Web Servers</guimenuitem></menuchoice> category.</para>

</listitem>

<listitem><para><guimenuitem>Updates</guimenuitem> &#8212; Shows all packages from the selected publisher in the selected category or matching the specified search string that have updates available.</para>

<para>Example: To list all device drivers that have updates available from all publishers, select <guimenuitem>Updates</guimenuitem> from the <guimenu>View</guimenu> menu, select <guimenuitem>All Publishers</guimenuitem> from the <guimenu>Publisher</guimenu> menu, and select the <guimenu>Drivers</guimenu> category.</para>

</listitem>

<listitem><para><guimenuitem>Not Installed Packages</guimenuitem> &#8212; Shows all packages from the selected publisher in the selected category or matching the specified search string that are not installed.</para>

<para>Example: To list all the font packages that are currently not installed from the <literal>oracle.com</literal> publisher, select <literal>oracle.com</literal> from the <guimenu>Publisher</guimenu> menu, select the <menuchoice><guimenu>System</guimenu><guimenuitem>Fonts</guimenuitem></menuchoice> category, and then select <guimenuitem>Not Installed Packages</guimenuitem> from the <guimenu>View</guimenu> menu.</para>

</listitem>

<listitem><para><guimenuitem>Selected Packages</guimenuitem> &#8212; Lists all packages that are currently selected. See <xref linkend="select-pkg"/>.</para>

</listitem>

</itemizedlist>

</subtopic>

<subtopic id="gkigv"><title>By Category</title>

<para>You can browse the available packages by type of software in the category pane on the left side of the Package Manager window. Click a category name to show subcategories. Packages in the selected category or subcategory are listed in the package list pane according to the selected publisher and package status and the specified search criteria.</para>

<para>In addition to named types of software, the categories pane also enables you to select <guimenuitem>All Categories</guimenuitem> and <guimenuitem>Recent Searches</guimenuitem>. See <xref linkend="search-pkg"/> &#8220;Repeat a Previous Search&#8221;for information about <guimenuitem>Recent Searches</guimenuitem>.</para>

</subtopic>

</sect1>

<sect1 id="search-pkg"><title>Searching for Packages</title>

<para>Use one of the following two methods to search for packages:</para>

<itemizedlist><listitem><para>Focus on the package list pane (for example, select <menuchoice><guimenu>Edit</guimenu><guimenuitem>Go to package list</guimenuitem></menuchoice> and start typing. As you type, matches are identified among the packages currently listed in the package list pane.</para>

</listitem>

<listitem><para>Use the Search field in the tool bar.</para>

</listitem>

</itemizedlist>

<subtopic id="gkjbd"><title>Enter a Search String</title>

<para>Enter a string in the Search field and then press the Enter key or click the magnifying glass icon to the right of the Search field.</para>

<itemizedlist><listitem><para><guimenu>Publisher</guimenu> menu selection &#8212; Package Manager searches for the search string in the information about each package from a particular publisher or from all publishers, according to what you have selected on the <guimenu> Publisher</guimenu> menu.</para>

<para>Search results are the same whether you select <guimenuitem>All Publishers</guimenuitem> or <guimenuitem>All Publishers (Search)</guimenuitem>. The diffrence is that using <guimenuitem>All Publishers (Search)</guimenuitem> is faster because you avoid the delay to load data from all publishers that you incur when you select <guimenuitem>All Publishers</guimenuitem>. With <guimenuitem>All Publishers (Search)</guimenuitem>, the search is performed on all publishers without loading data from all publishers in the package list pane.</para>

</listitem>

<listitem><para><guimenu>View</guimenu> menu selection &#8212; Search results are displayed in the package list pane according to the package status selected on the <guimenu>View</guimenu> menu. You can display different subsets of the same search results in the package list pane by changing the <guimenu>View</guimenu> menu selection without redoing the search.</para>

</listitem>

</itemizedlist>

<para>Package Manager searches package information including name, summary, description, category, and names of files contained within the package. Only exact matches are found if you do not use wild cards.</para>

<variablelist><varlistentry><term><literal>AND</literal></term>

<listitem><para>When search terms are separated by spaces or by <literal>AND</literal>, Package Manager searches for packages that contain <emphasis role="strong">all</emphasis> of the search terms. This is the default search behavior.</para>

<para>Example: If the search string is <literal>python book</literal> or <literal>python AND book</literal>, the search results include only packages that contain <emphasis>both</emphasis> <literal>python</literal> <emphasis>and</emphasis> <literal>book</literal> in their package information. For example, the package <literal>diveintopython</literal>, a book about Python programming, would appear in the search results, but the package <literal>python-26</literal> would not.</para>

</listitem>

</varlistentry>

<varlistentry><term>Double quotation marks</term>

<listitem><para>Enclose the search term in double quotation marks to match that search term exactly.</para>

<para>Example: <literal>"IDE"</literal> matches <literal>NetBeans IDE</literal> but does not match <literal>NetBeans cluster ide</literal>.</para>

</listitem>

</varlistentry>

<varlistentry><term>Wild card</term>

<listitem><para>You can use the <literal>*</literal> wild card in your search string. Using wild cards can be slower.</para>

<para>Example: <literal>plug*in</literal> matches both <literal>plugin</literal> and <literal>plug-in</literal>.</para>

</listitem>

</varlistentry>

<varlistentry><term><literal>OR</literal></term>

<listitem><para>When search terms are separated by <literal>OR</literal>, Package Manager searches for packages that contain <emphasis role="strong">any</emphasis> of the search terms.</para>

<para>Example: <literal>python OR book</literal> matches all packages that contain <literal>python</literal> in their package information and all packages that contain <literal>book</literal> in their package information.</para>

</listitem>

</varlistentry>

</variablelist>

<para>You can combine these search string modifiers. For example, you can perform the following search:</para>

<programlisting>netbeans AND plug*in OR ide</programlisting>

</subtopic>

<subtopic id="gkjao"><title>Clear the Search Field</title>

<para>To clear both the search string and the list of search results, use the Search field or the Edit menu.</para>

<itemizedlist><listitem><para>In the Search field, click the <literal>X</literal> icon.</para>

</listitem>

<listitem><para>On the <guimenu>Edit</guimenu> menu, select the <guimenuitem>Clear Search</guimenuitem> option.</para>

</listitem>

</itemizedlist>

</subtopic>

<subtopic id="gkjbe"><title>Cancel the Search</title>

<para>During a search operation, a busy bar displays at the right end of the status bar at the bottom of the Package Manager window. On the right end of the busy bar is an <literal>X</literal> icon. Click the <literal>X</literal> icon in the busy bar to cancel the search in progress.</para>

</subtopic>

<subtopic id="gkjbb"><title>Repeat a Previous Search</title>

<para>Searches that you have already performed during the current Package Manager session are saved in <guimenuitem>Recent Searches</guimenuitem> in the categories pane.</para>

<para>Select the <guimenuitem>Recent Searches</guimenuitem> label in the categories pane to display an informational message in the package list pane. The package list pane shows the list of previous search results.</para>

<para>Select the arrow to the left of the <guimenuitem>Recent Searches</guimenuitem> label to expand or hide the list of previous search results in the categories pane.</para>

<para>Select an item in the list of recent searches to redisplay those search results.</para>

<para>A search that matched no packages does not appear in the recent searches list.</para>

</subtopic>

</sect1>

<sect1 id="package-version"><title>Showing More Information</title>

<para>See more information about a package in the package details pane or on the Package Version Info dialog.</para>

<subtopic id="gkiti"><title>Package Details Pane</title>

<para>To show more information about a package, click your left mouse button to highlight the package in the package list. The package details pane below the package list pane shows information such as the latest version available from this publisher, the size of the package, the files in the package, dependencies, and license terms.</para>

<para>If a package has been renamed since it was installed, the Renamed To field on the General tab shows the new name of the package.</para>

<para>The Versions tab shows a list of versions of this package that are available for you to install. Select a version from the list and click the <guibutton>Install/Update</guibutton> button to the right of the list to install that version. See <xref linkend="install-pkg"/>.</para>

<para>The package details pane is not displayed if the package list pane contains an informational message.</para>

</subtopic>

<subtopic id="gkitc"><title>Package Version Info Dialog</title>

<para>Click your right mouse button on a package in the package list to pop up the <guimenu>Package</guimenu> menu.</para>

<para>Select the <menuchoice><guimenu>Package</guimenu><guimenuitem>Package Version Info</guimenuitem></menuchoice> menu option either from the pop-up menu or from the menu bar to display a separate window that shows the version of the package that is installed and the latest version that you can install or upgrade to if applicable.</para>

</subtopic>

</sect1>

<sect1 id="select-pkg"><title>Selecting Packages</title>

<para>Selected packages can be installed, updated, or removed. To select a package, use the package list pane or the <guimenu>Edit</guimenu> menu.</para>

<para>In the package list pane, do one of the following actions to select a package. You can select multiple packages.</para>

<itemizedlist><listitem><para>Click the box to the left of the package name.</para>

</listitem>

<listitem><para>Click the package name one time to highlight the package. Then double-click the highlighted package to select the package. Double-click again to deselect the package.</para>

</listitem>

<listitem><para>Click the checkbox icon in the column heading to select all packages that are currently listed in the package list pane.</para>

</listitem>

</itemizedlist>

<para>The <guimenu>Edit</guimenu> menu has the following options for selecting packages:</para>

<itemizedlist><listitem><para><guimenuitem>Select All</guimenuitem> &#8212; Selects all packages that are currently listed in the package list pane.</para>

</listitem>

<listitem><para><guimenuitem>Select Updates</guimenuitem> &#8212; Selects all packages that are currently listed in the package list pane that have updates available.</para>

</listitem>

<listitem><para><guimenuitem>Deselect All</guimenuitem> &#8212; Deselects all selected packages. Packages do not need to be listed in the package list pane to be deselected.</para>

</listitem>

</itemizedlist>

<para>In all cases when you select a package, packages that were previously selected are still selected.</para>

<para>The number of packages in the currently selected category and the number of packages that are selected in the current category are shown on the left side of the status bar at the bottom of the Package Manager window.</para>

<para>Use the <menuchoice><guimenu>View</guimenu><guimenuitem>Selected Packages</guimenuitem></menuchoice> option to list all selected packages from all categories in the package list pane.</para>

<para>A package can be highlighted but not selected. When a package is highlighted, detailed information about that package is displayed in the package details pane below the package list pane. When a package is selected, a check mark displays in the box to the left of the package name. If you want to install, update, or delete a package, make sure a check mark appears in the selection box for that package.</para>

</sect1>

<sect1 id="install-pkg"><title>Installing and Updating Packages</title>

<para>Perform the following steps to install or update a package:</para>

<orderedlist><listitem><para>Select the package. See <xref linkend="select-pkg"/>.</para>

</listitem>

<listitem><para>Use one of the following methods to install or update the package:</para>

<itemizedlist><listitem><para>Select the <guibutton>Install/Update</guibutton> button in the tool bar.</para>

</listitem>

<listitem><para>Select the <menuchoice><guimenu>Package</guimenu><guimenuitem>Install/Update</guimenuitem></menuchoice> option from the menu bar.</para>

</listitem>

<listitem><para>Click your right mouse button on the name of a package to display the pop-up <guimenu>Package</guimenu> menu. Then select the <guimenuitem>Install/Update</guimenuitem> option.</para>

</listitem>

<listitem><para>On the Versions tab in the package details pane below the package list pane, select a version from the Version to Install list and click the <guibutton>Install/Update</guibutton> button to the right of the list. The packages in the Version to Install list are available in the repository; they might not be installable. A particular version might not be compatible with other packages that you have installed. If the version that you select is not installable on your system, Package Manager warns you and does not install the package.</para>

</listitem>

</itemizedlist>

<para>If the package is already installed and does not have an update available (see the Status column or the <menuchoice><guimenu>Package</guimenu><guimenuitem>Package Version Info</guimenuitem></menuchoice> option), the <guibutton>Install/Update</guibutton> option is grayed out and not selectable.</para>

</listitem>

<listitem><para>The Install/Update Confirmation window is displayed. Packages that are not yet installed are listed in the Install Details pane, and packages that are installed are listed in the Update Details pane for you to review. Select the <guibutton>Proceed</guibutton> button to install or update the listed packages.</para>

<para>In some cases a license dialog is displayed and you must accept the license to install the package.</para>

<para>If an error occurs during package installation, an error dialog is displayed. Messages explain why the install or update failed.</para>

</listitem>

</orderedlist>

</sect1>

<sect1 id="remove-pkg"><title>Removing Packages</title>

<para>Perform the following steps to remove a package:</para>

<orderedlist><listitem><para>Select the package. See <xref linkend="select-pkg"/>.</para>

</listitem>

<listitem><para>Use one of the following methods to remove the package:</para>

<itemizedlist><listitem><para>Select the <guibutton>Remove</guibutton> button in the tool bar.</para>

</listitem>

<listitem><para>Select the <menuchoice><guimenu>Package</guimenu><guimenuitem>Remove</guimenuitem></menuchoice> option from the menu bar.</para>

</listitem>

<listitem><para>Click your right mouse button on the name of a package to display the pop-up <guimenu>Package</guimenu> menu. Then select the <guimenuitem>Remove</guimenuitem> option.</para>

</listitem>

</itemizedlist>

<para>If the package is not installed, the Remove option is grayed out and not selectable.</para>

</listitem>

<listitem><para>The Remove Confirmation window is displayed. Packages to be removed are listed in the Remove Details pane for you to review. Select the <guibutton>Proceed</guibutton> button to remove the listed packages.</para>

<para>If a package cannot be removed because other packages depend on it, you can select the <guibutton>Remove Continue</guibutton> option to attempt to remove any remaining packages that you originally selected for removal.</para>

</listitem>

</orderedlist>

</sect1>

</chapter>

<chapter id="update_all"><title>Updating Your System</title>

<para>When certain key packages such as some drivers and other kernel components are updated, the system performs the following actions:</para>

<orderedlist><listitem><para>Creates a clone of the current boot environment (BE).</para>

</listitem>

<listitem><para>Updates the packages in the clone, and does not update any packages in the current BE.</para>

</listitem>

<listitem><para>Sets the new BE to be the default boot choice the next time the system is rebooted. The current BE remains as an alternate boot choice.</para>

</listitem>

</orderedlist>

<sect1 id="um_info"><title>Updating All Packages</title>

<para>When you select the <guibutton>Updates</guibutton> button in the tool bar or the <menuchoice><guimenu>Package</guimenu><guimenuitem>Updates</guimenuitem></menuchoice> menu option, Package Manager updates all installed packages that have updates available.</para>

<para>All packages that have updates available from their current publisher are updated. If a package has an update available from a different publisher in your publisher list, that package is updated only if its current publisher is configured as non-sticky. If its current publisher is configured as sticky, then that package is not updated.</para>

<para>The Updates window displays, and the update process starts:</para>

<orderedlist><listitem><para>The system refreshes all catalogs.</para>

</listitem>

<listitem><para>The system evaluates all installed packages to determine which packages have updates available.</para>

<itemizedlist><listitem><para>If no packages have updates available, the message &#8220;No Updates Available&#8221; is displayed and processing stops.</para>

</listitem>

<listitem><para>If package updates are available, the packages to be updated are listed for your review. This is your last chance to click the <guibutton>Cancel</guibutton> button to abort the update.</para>

</listitem>

</itemizedlist>

</listitem>

<listitem><para>Click the <guibutton>Proceed</guibutton> button to continue with the update.</para>

<para>The system might create a new boot environment (BE), as described in <xref linkend="update_all"/> above, depending on which packages are being updated.</para>

<para>If the system determined that a new BE is required but was not able to create a new BE, an error message is displayed. If the problem is not enough disk space, perform the following steps:</para>

<orderedlist><listitem><para>Click <guibutton>Close</guibutton> to cancel the Updates process.</para>

</listitem>

<listitem><para>Follow the instructions in <xref linkend="remove-be"/> to remove a BE that is no longer needed.</para>

</listitem>

<listitem><para>Select <guibutton>Updates</guibutton> again to restart the Updates process.</para>

</listitem>

</orderedlist>

</listitem>

<listitem><para>The system downloads all package updates.</para>

</listitem>

<listitem><para>The system installs the package updates. If a cloned BE was created, the updates are installed in the clone. If no clone was created, the updates are installed in the current BE.</para>

<para>If an error occurs at any time during the update process, the Details panel is expanded and the details of the error are displayed. An error status indicator is shown next to the failed stage.</para>

</listitem>

<listitem><para>If the system created a new BE for the update, you can edit the default BE name. When you are satisfied with the BE name, click the <guibutton>Restart Now</guibutton> button to reboot your system immediately. Click the <guibutton>Restart Later</guibutton> button to restart your system at a later time. You must restart to boot into the new BE. The new BE will be your default boot choice. Your current BE will be available as an alternate boot choice.</para>

</listitem>

</orderedlist>

</sect1>

<sect1 id="using_um"><title>Using Update Manager</title>

<para>You can open Update Manager from a system notification or from the desktop menu bar. Update Manager executes the same process as described above in <xref linkend="um_info"/>.</para>

<subtopic id="gkiso"><title>Software Updates Notification</title>

<para>The system periodically checks whether updates are available for any of your installed packages. If the system detects that updates are available, an Updates Available notification icon and popup are displayed in the system notification tray. Click the notification icon to open Update Manager.</para>

</subtopic>

<subtopic id="gkisz"><title>Desktop System Menu</title>

<para>Select <menuchoice><guimenu>System</guimenu><guisubmenu>Administration</guisubmenu><guimenuitem>Update Manager</guimenuitem></menuchoice> from the menu bar on the desktop to open Update Manager.</para>

</subtopic>

</sect1>

</chapter>

<chapter id="manage-publisher"><title>Managing Publishers</title>

<para>You can add, modify, and remove IPS package publishers. You can change the priority of a publisher, change the enabled and sticky settings, change the publisher alias, add a publisher origin, set an SSL key and certificate, and add a publisher mirror.</para>

<sect1 id="add-publisher"><title>Adding Publishers</title>

<para>To add an IPS package publisher, use the Add Publisher window. To open the Add Publisher window, do one of the following actions:</para>

<itemizedlist><listitem><para>Select the <guimenuitem>Add</guimenuitem> option from the <guimenu>Publisher</guimenu> drop-down menu.</para>

</listitem>

<listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Add Publisher</guimenuitem></menuchoice> menu option.</para>

</listitem>

<listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option. In the Manage Publishers window, select the <guibutton>Add</guibutton> button.</para>

</listitem>

</itemizedlist>

<para>In the Add Publisher window, perform the following steps to add an IPS package publisher:</para>

<orderedlist><listitem><para>In the URI field, enter the URI of the publisher. The URI is a network location such as <literal>http://pkg.oracle.com/solaris11/release</literal> or <literal>http://localhost:5555</literal>.</para>

</listitem>

<listitem><para>In the Alias field, you can enter an alternate name for this publisher.</para>

</listitem>

<listitem><para>Click the <guibutton>Add</guibutton> button.</para>

</listitem>

<listitem><para>The Adding Publisher dialog is displayed. Click <guibutton>Cancel</guibutton> to cancel the process. Click Details to view verbose information.</para>

<itemizedlist><listitem><para>If the new publisher is added successfully, the Adding Publisher Complete dialog is displayed and shows the new publisher name, alias, and URI.</para>

</listitem>

<listitem><para>If the new publisher is not added, the Publisher Error dialog is displayed with information about the problem.</para>

</listitem>

</itemizedlist>

</listitem>

</orderedlist>

<para>The new publisher is the last publisher listed in the Manage Publishers window and is enabled and sticky.</para>

<para>See <xref linkend="modify-publisher"/> for information about changing the priority of the new publisher, changing the enabled and sticky settings, changing the publisher alias, adding a publisher origin, setting an SSL key and certificate, and adding a publisher mirror.</para>

</sect1>

<sect1 id="modify-publisher"><title>Modifying Publishers</title>

<para>To modify the attributes of a publisher, select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option. Currently configured publishers are listed in the Manage Publishers window.</para>

<para>In the Manage Publishers window you can change the priority of a publisher, enable or disable a publisher, set the publisher to be sticky or non-sticky, and remove a publisher.</para>

<para>Click the <guibutton>Modify</guibutton> button to open the Modify Publisher window. In the Modify Publisher window you can change the publisher alias, add or remove a publisher origin, set an SSL key and certificate, and add or remove a publisher mirror.</para>

<subtopic id="set-pub-order"><title>Publisher Priority</title>

<para>Publishers are listed in priority order in the Manage Publishers window. The publisher at the top of the list is the highest priority publisher. The publisher at the bottom of the list is the lowest priority publisher.</para>

<itemizedlist><listitem><para>The publisher at the top of the list is also known as the preferred publisher.</para>

</listitem>

<listitem><para>The publisher at the top of the list cannot be disabled or removed.</para>

</listitem>

<listitem><para>When you search for packages and do not specify a publisher, the catalogs of higher priority publishers are searched first.</para>

</listitem>

<listitem><para>When you update a package that was installed from a non-sticky publisher, the catalogs of higher priority publishers are searched first for updates.</para>

</listitem>

</itemizedlist>

<para>To change the priority of a publisher, perform the following steps:</para>

<orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>

</listitem>

<listitem><para>Click to highlight a publisher row in the list in the Manage Publishers window.</para>

</listitem>

<listitem><para>Click the <guibutton>Up</guibutton> and <guibutton>Down</guibutton> buttons to the right of the publisher list to increase or reduce the priority of the selected publisher. The selected publisher listing moves up and down in the list to show its new priority.</para>

</listitem>

<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>

</listitem>

</orderedlist>

</subtopic>

<subtopic id="gjlab"><title>Enabled and Sticky</title>

<para>When you add a publisher, the enabled and sticky attributes are set by default. The preferred publisher (see &#8220;Publisher Priority&#8221; above) cannot be disabled. All other enabled and sticky settings can be changed.</para>

<para>If the sticky attribute is set for a publisher, then a package that was installed from that publisher cannot be updated from a different publisher. If the sticky attribute is not set for a publisher, then that publisher is non-sticky. If a publisher is non-sticky, then a package that originally came from that publisher can be updated from another publisher. A different publisher might have a newer version of a package than the original publisher of the package. If you want to update to that newer version, the original publisher needs to be non-sticky. Also, if a lower priority publisher is non-sticky, then higher-priority publishers will be searched first for updates for packages installed from that non-sticky publisher.</para>

<para>A publisher that is disabled is not searched for updates or for packages to install. Catalogs of a disabled publisher are not refreshed. A disabled publisher is not shown on the <guimenu>Publisher</guimenu> drop-down menu.</para>

<para>To change the Enabled and Sticky settings for a publisher, perform the following steps:</para>

<orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>

</listitem>

<listitem><para>Click an Enabled box or a Sticky box to toggle its setting.</para>

</listitem>

<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>

</listitem>

</orderedlist>

</subtopic>

<subtopic id="modify-publisher-alias"><title>Publisher Alias</title>

<para>The publisher alias is another name for the publisher. The alias name is used in the <guimenu>Publisher</guimenu> drop-down menu and in the package list pane.</para>

<para>To change the alias of a publisher, perform the following steps:</para>

<orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>

</listitem>

<listitem><para>Select the publisher whose alias you want to modify.</para>

</listitem>

<listitem><para>Click the <guibutton>Modify</guibutton> button to the right of the publisher list to open the Modify Publisher window.</para>

</listitem>

<listitem><para>Enter a new name in the Alias field.</para>

</listitem>

<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para>

</listitem>

<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>

</listitem>

</orderedlist>

</subtopic>

<subtopic id="gjkza"><title>Publisher Origins</title>

<para>An origin is an original source of packages, as opposed to a mirror.</para>

<para>An origin value is the URI of a IPS package repository.</para>

<para>To change, add, or remove a publisher origin, perform the following steps:</para>

<orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>

</listitem>

<listitem><para>Select the publisher whose origin you want to modify. The Details pane below the publisher list in the Manage Publishers window displays the current origins for the selected publisher.</para>

</listitem>

<listitem><para>Click the <guibutton>Modify</guibutton> button to the right of the publisher list to open the Modify Publisher window.</para>

</listitem>

<listitem><para>You can change, add, or remove an origin for this publisher.</para>

<itemizedlist><listitem><para>To change an origin, delete the origin you want to change and then add a new origin.</para>

</listitem>

<listitem><para>To add an origin, enter the URI of the new origin you want to associate with the publisher in the Origin field and click the <guibutton>Add</guibutton> button. The new URI is added to the list below the Origin field.</para>

</listitem>

<listitem><para>To remove an origin, select the URI you want to delete from the list below the Origin field and click the <guibutton>Remove</guibutton> button. The selected URI is removed from the list.</para>

</listitem>

</itemizedlist>

</listitem>

<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para>

</listitem>

<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>

</listitem>

</orderedlist>

</subtopic>

<subtopic id="gjkyy"><title>Publisher Security</title>

<para>If a publisher has a secure origin, add the SSL key and SSL certificate for the publisher.</para>

<orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>

</listitem>

<listitem><para>Select the publisher whose security you want to modify.</para>

</listitem>

<listitem><para>Click the <guibutton>Modify</guibutton> button to the right of the publisher list to open the Modify Publisher window.</para>

</listitem>

<listitem><para>Click the SSL Key and Certificate label to display the SSL Key field and the SSL Certificate field.</para>

</listitem>

<listitem><para>Click the <guibutton>Browse</guibutton> button to the right of the SSL Key field to select the SSL Key file.</para>

</listitem>

<listitem><para>Click the <guibutton>Browse</guibutton> button to the right of the SSL Certificate field to select the SSL Certificate file.</para>

</listitem>

<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para>

</listitem>

<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>

</listitem>

</orderedlist>

</subtopic>

<subtopic id="gjkyr"><title>Publisher Mirrors</title>

<para>A mirror repository is an identical copy of data in an origin repository. A repository can be copied and the data synchronized to maintain identical repositories in separate locations.</para>

<para>To change, add, or remove a publisher mirror, perform the following steps:</para>

<orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>

</listitem>

<listitem><para>Select the publisher whose mirrors you want to modify.</para>

</listitem>

<listitem><para>Click the <guibutton>Modify</guibutton> button to the right of the publisher list to open the Modify Publisher window.</para>

</listitem>

<listitem><para>Click the Mirrors label to display the Mirror field and the list of mirrors.</para>

</listitem>

<listitem><para>You can change, add, or remove a mirror for this publisher.</para>

<itemizedlist><listitem><para>To change a mirror, delete the mirror you want to change and then add a new mirror.</para>

</listitem>

<listitem><para>To add a mirror, enter the URI of the new mirror you want to associate with the publisher in the Mirror field and click the <guibutton>Add</guibutton> button. The new URI is added to the list below the Mirror field.</para>

</listitem>

<listitem><para>To remove a mirror, select the URI you want to delete from the list below the Mirror field and click the <guibutton>Remove</guibutton> button. The selected URI is removed from the list.</para>

</listitem>

</itemizedlist>

</listitem>

<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para>

</listitem>

<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>

</listitem>

</orderedlist>

</subtopic>

</sect1>

<sect1 id="remove-publisher"><title>Removing Publishers</title>

<para>Perform the following steps to remove a publisher:</para>

<orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>

</listitem>

<listitem><para>Select the publisher that you want to remove.</para>

</listitem>

<listitem><para>Click the <guibutton>Remove</guibutton> button to the right of the publisher list to open the Modify Publisher window.</para>

</listitem>

<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>

</listitem>