src/gui/help/C/package-manager.xml.in
branchoi_151a
changeset 2546 2b1fa6a54b5e
parent 2094 dbf4ce9ada97
child 2556 5dfb1d0d1148
equal deleted inserted replaced
2545:eaf79153c8a3 2546:2b1fa6a54b5e
     1 <?xml version="1.0" encoding="utf-8"?>
     1 <?xml version="1.0" encoding="utf-8"?>
     2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd">
     2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3 <book id="pkgmgr" label="fcs" lang="en"><title><trademark class="registered">Oracle</trademark> Solaris 11 Express Package Manager Online Help</title>
     3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
       
     4 <book id="pkgmgr"><title><trademark class="registered">Oracle</trademark> Solaris 11 Package Manager Online Help</title>
     4 <bookinfo><authorgroup><author><firstname>Oracle</firstname>
     5 <bookinfo><authorgroup><author><firstname>Oracle</firstname>
     5 <surname>Corporation</surname>
     6 <surname>Corporation</surname>
     6 </author>
     7 </author>
     7 </authorgroup>
     8 </authorgroup>
     8 <pubsnumber>822-7173-11</pubsnumber>
     9 <releaseinfo>Oracle Solaris 11</releaseinfo>
     9 <releaseinfo>Oracle Solaris 11 Express</releaseinfo>
    10 <pubdate>June 2011</pubdate>
    10 <pubdate>November 2010</pubdate>
       
    11 <publisher><publishername>Oracle Corporation</publishername>
    11 <publisher><publishername>Oracle Corporation</publishername>
    12 <address><street>500 Oracle Parkway</street>
    12 <address><street>500 Oracle Parkway</street>
    13 <city>Redwood City</city>
    13 <city>Redwood City</city>
    14 <state>CA</state>
    14 <state>CA</state>
    15 <postcode>94065</postcode>
    15 <postcode>94065</postcode>
    16 <country>U.S.A.</country>
    16 <country>U.S.A.</country>
    17 </address>
    17 </address>
    18 </publisher>
    18 </publisher>
    19 <copyright><year>2008, 2010</year>
    19 <copyright><year>2008, 2011</year></copyright>
    20 </copyright>
       
    21 <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>
    20 <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>
    22 <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>
    21 <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>
    23 <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>
    22 <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>
    24 <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>
    23 <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>
    25 <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>
    24 <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>
    26 <para>Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.</para>
    25 <para>Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.</para>
    27 <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>
    26 <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>
    28 <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>
    27 <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>
    29 <para lang="fr"></para>
    28 <para lang="fr"/>
    30 <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>
    29 <para>Ce logiciel et la documentation qui l’accompagne sont protégés par les lois sur la propriété intellectuelle. Ils sont concédés sous licence et soumis à des restrictions d’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écuter, publier ou afficher le logiciel, même partiellement, sous quelque forme et par quelque procédé que ce soit. Par ailleurs, il est interdit de procéder à toute ingénierie inverse du logiciel, de le désassembler ou de le décompiler, excepté à des fins d’interopérabilité avec des logiciels tiers ou tel que prescrit par la loi.</para>
    31 <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>
    30 <para>Les informations fournies dans ce document sont susceptibles de modification sans préavis. Par ailleurs, Oracle Corporation ne garantit pas qu’elles soient exemptes d’erreurs et vous invite, le cas échéant, à lui en faire part par écrit.</para>
    32 <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>
    31 <para>Si ce logiciel, ou la documentation qui l’accompagne, est concédé sous licence au Gouvernement des Etats-Unis, ou à toute entité qui délivre la licence de ce logiciel ou l’utilise pour le compte du Gouvernement des Etats-Unis, la notice suivante s’applique :</para>
    33 <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>
    32 <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>
    34 <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>
    33 <para>Ce logiciel ou matériel a été développé pour un usage général dans le cadre d’applications de gestion des informations. Ce logiciel ou matériel n’est pas conçu ni n’est destiné à être utilisé dans des applications à risque, notamment dans des applications pouvant causer des dommages corporels. Si vous utilisez ce logiciel ou matériel dans le cadre d’applications dangereuses, il est de votre responsabilité de prendre toutes les mesures de secours, de sauvegarde, de redondance et autres mesures nécessaires à son utilisation dans des conditions optimales de sécurité. Oracle Corporation et ses affiliés déclinent toute responsabilité quant aux dommages causés par l’utilisation de ce logiciel ou matériel pour ce type d’applications.</para>
    35 <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>
    34 <para>Oracle et Java sont des marques déposées d’Oracle Corporation et/ou de ses affiliés.Tout autre nom mentionné peut correspondre à des marques appartenant à d’autres propriétaires qu’Oracle.</para>
    36 <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>
    35 <para>AMD, Opteron, le logo AMD et le logo AMD Opteron sont des marques ou des marques déposées d’Advanced Micro Devices. Intel et Intel Xeon sont des marques ou des marques déposées d’Intel Corporation. Toutes les marques SPARC sont utilisées sous licence et sont des marques ou des marques déposées de SPARC International, Inc. UNIX est une marque déposée concédé sous license par X/Open Company, Ltd.</para>
    37 </legalnotice>
    36 </legalnotice>
    38 </bookinfo>
    37 </bookinfo>
    39 <chapter id="about"><title>About Package Manager</title>
    38 <chapter id="about"><title>About Package Manager</title>
    40 <para>Package Manager is a graphical user interface (GUI) for the Oracle Solaris Image Packaging System (IPS).</para>
    39 <para>Package Manager is a graphical user interface (GUI) for the Oracle Solaris Image Packaging System (IPS).</para>
    41 <para>See the <xref linkend="glossary"/> for definitions of terms used in this document.</para>
    40 <para>See the <xref linkend="glossary"/> for definitions of terms used in this document.</para>
    42 <sect1 id="gikcw"><title>Oracle Solaris Image Packaging System</title>
    41 <sect1 id="gikcw"><title>Oracle Solaris Image Packaging System</title>
    43 <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>
    42 <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>
    44 <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>
    43 <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>
    45 <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>
    44 <para>IPS also enables you to create a copy of an existing IPS package repository, create your own IPS package repository, and publish your own IPS packages. For more information about IPS, see the Oracle Solaris 11 Information Library. Go to <literal>download.oracle.com</literal>, select Documentation Index on the left, select Systems Software, select Oracle Solaris 11, and select View Library. See especially <citetitle>Adding and Updating Oracle Solaris 11 Software Packages</citetitle>.</para>
    46 </sect1>
    45 </sect1>
    47 <sect1 id="pm-win"><title>Package Manager</title>
    46 <sect1 id="pm-win"><title>Package Manager</title>
    48 <para>Package Manager provides a subset of the functionality offered by the IPS command-line interface.</para>
    47 <para>Package Manager provides a subset of the functionality offered by the IPS command-line interface.</para>
    49 <para>Package Manager enables you to perform the following tasks:</para>
    48 <para>Package Manager enables you to perform the following tasks:</para>
    50 <itemizedlist><listitem><para>Find, install, update, and remove IPS packages. See <xref linkend="manage-pkg"/>.</para>
    49 <itemizedlist><listitem><para>Find, install, update, and remove IPS packages. See <xref linkend="manage-pkg"/>.</para>
    65 </listitem>
    64 </listitem>
    66 <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>
    65 <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>
    67 </listitem>
    66 </listitem>
    68 <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>
    67 <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>
    69 </listitem>
    68 </listitem>
    70 <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>
    69 <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"/> “By Publisher.”</para>
    71 </listitem>
    70 </listitem>
    72 <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>
    71 <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 “By Package Status.”</para>
    73 </listitem>
    72 </listitem>
    74 <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>
    73 <listitem><para>The category pane below the <guimenu>Publisher</guimenu> menu helps control the content of the package list pane. See Listing Packages “By Category.”</para>
    75 </listitem>
    74 </listitem>
    76 <listitem><para>Below the list of software categories is a list of searches that you have performed in this session.</para>
    75 <listitem><para>Below the list of software categories is a list of searches that you have performed in this session.</para>
    77 </listitem>
    76 </listitem>
    78 <listitem><para>Below the package list pane is the package details pane. See <xref linkend="package-version"/>.</para>
    77 <listitem><para>Below the package list pane is the package details pane. See <xref linkend="package-version"/>.</para>
    79 </listitem>
    78 </listitem>
    84 <para>You can list packages according to various criteria. You can install, update, and remove packages.</para>
    83 <para>You can list packages according to various criteria. You can install, update, and remove packages.</para>
    85 <sect1 id="list-pkg"><title>Listing Packages</title>
    84 <sect1 id="list-pkg"><title>Listing Packages</title>
    86 <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>
    85 <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>
    87 <para>You can reorder the package list by clicking the column headings.</para>
    86 <para>You can reorder the package list by clicking the column headings.</para>
    88 <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>
    87 <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>
    89 <subtopic id="gkihe"><title>By Publisher</title>
    88 <sect2 id="gkihe"><title>By Publisher</title>
    90 <para>The <guimenu>Publisher</guimenu> drop-down menu enables you to list packages according to publisher.</para>
    89 <para>The <guimenu>Publisher</guimenu> drop-down menu enables you to list packages according to publisher.</para>
    91 <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>
    90 <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>
    92 </listitem>
    91 </listitem>
    93 <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>
    92 <listitem><para><guimenuitem>All Publishers</guimenuitem> — Shows packages from all publishers in the package list pane. The package list pane shows columns Name, Status, Publisher, and Summary.</para>
    94 <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>
    93 <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>
    95 </listitem>
    94 </listitem>
    96 <listitem><para><guimenuitem>All Installed Packages</guimenuitem> &#8212; Shows all packages that are installed from all publishers.</para>
    95 <listitem><para><guimenuitem>All Installed Packages</guimenuitem> — Shows all packages that are installed from all publishers.</para>
    97 <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>
    96 <para>Example: To list all the font packages that are currently installed from the <literal>solaris</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>solaris</literal> entries.</para>
    98 </listitem>
    97 </listitem>
    99 <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>
    98 <listitem><para><guimenuitem>All Publishers (Search)</guimenuitem> — 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>
   100 </listitem>
    99 </listitem>
   101 <listitem><para><guimenuitem>Add...</guimenuitem> &#8212; Opens the Add Publisher window.</para>
   100 <listitem><para><guimenuitem>Add...</guimenuitem> — Opens the Add Publisher window.</para>
   102 </listitem>
   101 </listitem>
   103 </itemizedlist>
   102 </itemizedlist>
   104 </subtopic>
   103 </sect2>
   105 <subtopic id="gkihp"><title>By Package Status</title>
   104 <sect2 id="gkihp"><title>By Package Status</title>
   106 <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>
   105 <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>
   107 <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>
   106 <itemizedlist><listitem><para><guimenuitem>All Packages</guimenuitem> — Shows all packages available from the selected publisher in the selected category or matching the specified search string.</para>
   108 <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>
   107 <para>Example: To list all web services packages from the <literal>solaris</literal> publisher that are installed, not installed, or have updates available, select <literal>solaris</literal> from the <guimenu>Publisher</guimenu> menu, select the <menuchoice><guimenu>Web Services</guimenu></menuchoice> category, and
   109 </listitem>
   108 select <guimenuitem>All Packages</guimenuitem> from the <guimenu>View</guimenu> menu.</para>
   110 <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>
   109 </listitem>
   111 <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>
   110 <listitem><para><guimenuitem>Installed Packages</guimenuitem> — 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>
   112 </listitem>
   111 <para>Example: To list only the web server packages that are installed from the <literal>solaris</literal> publisher, select <literal>solaris</literal> from the <guimenu>Publisher</guimenu> menu, select the <menuchoice><guimenu>Web Services</guimenu></menuchoice> category, and select <guimenuitem>Installed Packages</guimenuitem> from the <guimenu>View</guimenu> menu.</para>
   113 <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>
   112 </listitem>
   114 <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>
   113 <listitem><para><guimenuitem>Updates</guimenuitem> — Shows all packages from the selected publisher in the selected category or matching the specified search string that have updates available.</para>
   115 </listitem>
   114 <para>Example: To list all device drivers that have updates available from all publishers, select <guimenuitem>All Publishers</guimenuitem> from the <guimenu>Publisher</guimenu> menu, select the <guimenu>Drivers</guimenu> category, and select <guimenuitem>Updates</guimenuitem> from the <guimenu>View</guimenu> menu.</para>
   116 <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>
   115 </listitem>
   117 <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>
   116 <listitem><para><guimenuitem>Not Installed Packages</guimenuitem> — Shows all packages from the selected publisher in the selected category or matching the specified search string that are not installed.</para>
   118 </listitem>
   117 <para>Example: To list all the font packages that are currently not installed from the <literal>solaris</literal> publisher, select <literal>solaris</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>
   119 <listitem><para><guimenuitem>Selected Packages</guimenuitem> &#8212; Lists all packages that are currently selected. See <xref linkend="select-pkg"/>.</para>
   118 </listitem>
   120 </listitem>
   119 <listitem><para><guimenuitem>Selected Packages</guimenuitem> — Lists all packages that are currently selected. See <xref linkend="select-pkg"/>.</para>
   121 </itemizedlist>
   120 </listitem>
   122 </subtopic>
   121 </itemizedlist>
   123 <subtopic id="gkigv"><title>By Category</title>
   122 </sect2>
       
   123 <sect2 id="gkigv"><title>By Category</title>
   124 <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>
   124 <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>
   125 <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>
   125 <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"/> “Repeat a Previous Search” for information about <guimenuitem>Recent Searches</guimenuitem>.</para>
   126 </subtopic>
   126 </sect2>
   127 </sect1>
   127 </sect1>
   128 <sect1 id="search-pkg"><title>Searching for Packages</title>
   128 <sect1 id="search-pkg"><title>Searching for Packages</title>
   129 <para>Use one of the following two methods to search for packages:</para>
   129 <para>Use one of the following two methods to search for packages:</para>
   130 <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>
   130 <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>
   131 </listitem>
   131 </listitem>
   132 <listitem><para>Use the Search field in the tool bar.</para>
   132 <listitem><para>Use the Search field in the tool bar.</para>
   133 </listitem>
   133 </listitem>
   134 </itemizedlist>
   134 </itemizedlist>
   135 <subtopic id="gkjbd"><title>Enter a Search String</title>
   135 <sect2 id="gkjbd"><title>Enter a Search String</title>
   136 <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>
   136 <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>
   137 <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>
   137 <itemizedlist><listitem><para><guimenu>Publisher</guimenu> menu selection — 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>
   138 <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>
   138 <para>Search results are the same whether you select <guimenuitem>All Publishers</guimenuitem> or <guimenuitem>All Publishers (Search)</guimenuitem>. The difference 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>
   139 </listitem>
   139 </listitem>
   140 <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>
   140 <listitem><para><guimenu>View</guimenu> menu selection — 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>
   141 </listitem>
   141 </listitem>
   142 </itemizedlist>
   142 </itemizedlist>
   143 <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>
   143 <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>
   144 <variablelist><varlistentry><term><literal>AND</literal></term>
   144 <variablelist><varlistentry><term><literal>AND</literal></term>
   145 <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>
   145 <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>
   146 <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>
   146 <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>
   147 </listitem>
   147 </listitem>
   148 </varlistentry>
   148 </varlistentry>
   149 <varlistentry><term>Double quotation marks</term>
   149 <varlistentry><term>Double quotation marks</term>
   150 <listitem><para>Enclose the search term in double quotation marks to match that search term exactly.</para>
   150 <listitem><para>Enclose the search term in double quotation marks to match that search term exactly.</para>
   151 <para>Example: <literal>"IDE"</literal> matches <literal>NetBeans IDE</literal> but does not match <literal>NetBeans cluster ide</literal>.</para>
   151 <para>Example: <literal>"ethernet driver"</literal> in double quotation marks matches <literal>Fast Ethernet Driver</literal> but does not match <literal>Ethernet Adapter Driver</literal>.</para>
   152 </listitem>
   152 </listitem>
   153 </varlistentry>
   153 </varlistentry>
   154 <varlistentry><term>Wild card</term>
   154 <varlistentry><term>Wild card</term>
   155 <listitem><para>You can use the <literal>*</literal> wild card in your search string. Using wild cards can be slower.</para>
   155 <listitem><para>You can use the <literal>*</literal> wild card in your search string. Using wild cards can be slower.</para>
   156 <para>Example: <literal>plug*in</literal> matches both <literal>plugin</literal> and <literal>plug-in</literal>.</para>
   156 <para>Example: <literal>802.11*</literal> matches <literal>802.11b/g</literal> and <literal>802.11a/b/g</literal>.</para>
       
   157 <para>Note that <literal>802.11*</literal> does not match <literal>IEEE802.11b/g</literal>. To match <literal>IEEE802.11b/g</literal>, use search string <literal>*802.11*</literal>.</para>
   157 </listitem>
   158 </listitem>
   158 </varlistentry>
   159 </varlistentry>
   159 <varlistentry><term><literal>OR</literal></term>
   160 <varlistentry><term><literal>OR</literal></term>
   160 <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>
   161 <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>
   161 <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>
   162 <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>
   162 </listitem>
   163 </listitem>
   163 </varlistentry>
   164 </varlistentry>
   164 </variablelist>
   165 </variablelist>
   165 <para>You can combine these search string modifiers. For example, you can perform the following search:</para>
   166 <para>You can combine these search string modifiers. You can use AND, OR, doublt quotation marks, and * all in one search string.</para>
   166 <programlisting>netbeans AND plug*in OR ide</programlisting>
   167 </sect2>
   167 </subtopic>
   168 <sect2 id="gkjao"><title>Clear the Search Field</title>
   168 <subtopic id="gkjao"><title>Clear the Search Field</title>
       
   169 <para>To clear both the search string and the list of search results, use the Search field or the Edit menu.</para>
   169 <para>To clear both the search string and the list of search results, use the Search field or the Edit menu.</para>
   170 <itemizedlist><listitem><para>In the Search field, click the <literal>X</literal> icon.</para>
   170 <itemizedlist><listitem><para>In the Search field, click the <literal>X</literal> icon.</para>
   171 </listitem>
   171 </listitem>
   172 <listitem><para>On the <guimenu>Edit</guimenu> menu, select the <guimenuitem>Clear Search</guimenuitem> option.</para>
   172 <listitem><para>On the <guimenu>Edit</guimenu> menu, select the <guimenuitem>Clear Search</guimenuitem> option.</para>
   173 </listitem>
   173 </listitem>
   174 </itemizedlist>
   174 </itemizedlist>
   175 </subtopic>
   175 </sect2>
   176 <subtopic id="gkjbe"><title>Cancel the Search</title>
   176 <sect2 id="gkjbe"><title>Cancel the Search</title>
   177 <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>
   177 <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>
   178 </subtopic>
   178 </sect2>
   179 <subtopic id="gkjbb"><title>Repeat a Previous Search</title>
   179 <sect2 id="gkjbb"><title>Redisplay Previous Search Results</title>
   180 <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>
   180 <para>Results from searches that you have already performed during the current Package Manager session are saved in <guimenuitem>Recent Searches</guimenuitem> in the categories pane.</para>
   181 <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>
   181 <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. Click a "results" link to redisplay those results.</para>
   182 <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>
   182 <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. Select an item in the list of recent searches to redisplay those search results.</para>
   183 <para>Select an item in the list of recent searches to redisplay those search results.</para>
       
   184 <para>A search that matched no packages does not appear in the recent searches list.</para>
   183 <para>A search that matched no packages does not appear in the recent searches list.</para>
   185 </subtopic>
   184 <para>Selecting the <guibutton>Refresh</guibutton> button or the <menuchoice><guimenu>Package</guimenu><guimenuitem>Refresh</guimenuitem></menuchoice> menu option deletes all recent searches results.</para>
       
   185 </sect2>
   186 </sect1>
   186 </sect1>
   187 <sect1 id="package-version"><title>Showing More Information</title>
   187 <sect1 id="package-version"><title>Showing More Information</title>
   188 <para>See more information about a package in the package details pane or on the Package Version Info dialog.</para>
   188 <para>See more information about a package in the package details pane or on the Package Version Info dialog.</para>
   189 <subtopic id="gkiti"><title>Package Details Pane</title>
   189 <sect2 id="gkiti"><title>Package Details Pane</title>
   190 <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>
   190 <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>
   191 <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>
   191 <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>
   192 <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>
   192 <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>
   193 <para>The package details pane is not displayed if the package list pane contains an informational message.</para>
   193 <para>The package details pane is not displayed if the package list pane contains an informational message.</para>
   194 </subtopic>
   194 </sect2>
   195 <subtopic id="gkitc"><title>Package Version Info Dialog</title>
   195 <sect2 id="gkitc"><title>Package Version Info Dialog</title>
   196 <para>Click your right mouse button on a package in the package list to pop up the <guimenu>Package</guimenu> menu.</para>
   196 <para>Click your right mouse button on a package in the package list to pop up the <guimenu>Package</guimenu> menu.</para>
   197 <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>
   197 <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>
   198 </subtopic>
   198 </sect2>
   199 </sect1>
   199 </sect1>
   200 <sect1 id="select-pkg"><title>Selecting Packages</title>
   200 <sect1 id="select-pkg"><title>Selecting Packages</title>
   201 <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>
   201 <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>
   202 <para>In the package list pane, do one of the following actions to select a package. You can select multiple packages.</para>
   202 <para>In the package list pane, do one of the following actions to select a package. You can select multiple packages.</para>
   203 <itemizedlist><listitem><para>Click the box to the left of the package name.</para>
   203 <itemizedlist><listitem><para>Click the box to the left of the package name. Click the box again to deselect the package.</para>
   204 </listitem>
   204 </listitem>
   205 <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>
   205 <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>
   206 </listitem>
   206 </listitem>
   207 <listitem><para>Click the checkbox icon in the column heading to select all packages that are currently listed in the package list pane.</para>
   207 <listitem><para>Click the checkbox icon in the column heading to select all packages that are currently listed in the package list pane. Click the checkbox icon again to deselect all packages currently listed in the package list pane.</para>
   208 </listitem>
   208 </listitem>
   209 </itemizedlist>
   209 </itemizedlist>
   210 <para>The <guimenu>Edit</guimenu> menu has the following options for selecting packages:</para>
   210 <para>The <guimenu>Edit</guimenu> menu has the following options for selecting packages:</para>
   211 <itemizedlist><listitem><para><guimenuitem>Select All</guimenuitem> &#8212; Selects all packages that are currently listed in the package list pane.</para>
   211 <itemizedlist><listitem><para><guimenuitem>Select All</guimenuitem> — Selects all packages that are currently listed in the package list pane.</para>
   212 </listitem>
   212 </listitem>
   213 <listitem><para><guimenuitem>Select Updates</guimenuitem> &#8212; Selects all packages that are currently listed in the package list pane that have updates available.</para>
   213 <listitem><para><guimenuitem>Select Updates</guimenuitem> — Selects all packages that are currently listed in the package list pane that have updates available.</para>
   214 </listitem>
   214 </listitem>
   215 <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>
   215 <listitem><para><guimenuitem>Deselect All</guimenuitem> — Deselects all packages that are currently listed in the package list pane.</para>
   216 </listitem>
   216 </listitem>
   217 </itemizedlist>
   217 </itemizedlist>
   218 <para>In all cases when you select a package, packages that were previously selected are still selected.</para>
   218 <para>In all cases when you select a package, packages that were previously selected are still selected.</para>
   219 <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>
   219 <para>The number of packages currently listed in the package list pane and the number of those packages that are selected are shown on the left side of the status bar at the bottom of the Package Manager window.</para>
   220 <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>
   220 <para>Select the <menuchoice><guimenu>Publisher</guimenu><guimenuitem>All Publishers</guimenuitem></menuchoice> option, the <guimenuitem>All Categories</guimenuitem> category, and the <menuchoice><guimenu>View</guimenu><guimenuitem>Selected Packages</guimenuitem></menuchoice> option to list all selected packages from all publishers in the package list pane.</para>
   221 <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>
   221 <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>
   222 </sect1>
   222 </sect1>
   223 <sect1 id="install-pkg"><title>Installing and Updating Packages</title>
   223 <sect1 id="install-pkg"><title>Installing and Updating Packages</title>
       
   224 <para>Before you install or update, check your Optional Components preference settings. Select the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> option. In the Preferences window, select the Optional Components tab. By default, Install all languages, Install all development files, and Install all documentation are selected. You can save space in your installation by selecting a subset of languages to install or deselecting development files, for example. Click the OK button to save your changes. These settings apply to all installed packages as well as future package installations and updates.</para>
   224 <para>Perform the following steps to install or update a package:</para>
   225 <para>Perform the following steps to install or update a package:</para>
   225 <orderedlist><listitem><para>Select the package. See <xref linkend="select-pkg"/>.</para>
   226 <orderedlist><listitem><para>Select the package. See <xref linkend="select-pkg"/>.</para>
   226 </listitem>
   227 </listitem>
   227 <listitem><para>Use one of the following methods to install or update the package:</para>
   228 <listitem><para>Use one of the following methods to install or update the package:</para>
   228 <itemizedlist><listitem><para>Select the <guibutton>Install/Update</guibutton> button in the tool bar.</para>
   229 <itemizedlist><listitem><para>Select the <guibutton>Install/Update</guibutton> button in the tool bar.</para>
   276 <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>
   277 <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>
   277 <para>The Updates window displays, and the update process starts:</para>
   278 <para>The Updates window displays, and the update process starts:</para>
   278 <orderedlist><listitem><para>The system refreshes all catalogs.</para>
   279 <orderedlist><listitem><para>The system refreshes all catalogs.</para>
   279 </listitem>
   280 </listitem>
   280 <listitem><para>The system evaluates all installed packages to determine which packages have updates available.</para>
   281 <listitem><para>The system evaluates all installed packages to determine which packages have updates available.</para>
   281 <itemizedlist><listitem><para>If no packages have updates available, the message &#8220;No Updates Available&#8221; is displayed and processing stops.</para>
   282 <itemizedlist><listitem><para>If no packages have updates available, the message “No Updates Available” is displayed and processing stops.</para>
   282 </listitem>
   283 </listitem>
   283 <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>
   284 <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>
   284 </listitem>
   285 </listitem>
   285 </itemizedlist>
   286 </itemizedlist>
   286 </listitem>
   287 </listitem>
   304 </listitem>
   305 </listitem>
   305 </orderedlist>
   306 </orderedlist>
   306 </sect1>
   307 </sect1>
   307 <sect1 id="using_um"><title>Using Update Manager</title>
   308 <sect1 id="using_um"><title>Using Update Manager</title>
   308 <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>
   309 <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>
   309 <subtopic id="gkiso"><title>Software Updates Notification</title>
   310 <sect2 id="gkiso"><title>Software Updates Notification</title>
   310 <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>
   311 <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>
   311 </subtopic>
   312 </sect2>
   312 <subtopic id="gkisz"><title>Desktop System Menu</title>
   313 <sect2 id="gkisz"><title>Desktop System Menu</title>
   313 <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>
   314 <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>
   314 </subtopic>
   315 </sect2>
   315 </sect1>
   316 </sect1>
   316 </chapter>
   317 </chapter>
   317 <chapter id="manage-publisher"><title>Managing Publishers</title>
   318 <chapter id="manage-publisher"><title>Managing Publishers</title>
   318 <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>
   319 <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 or remove a publisher origin, and add or remove a publisher mirror. You can manage keys, certificates, and signature policy.</para>
       
   320 <para>Note that system publishers are an exception. System publishers can only be viewed in the Manage Publishers window. System publishers cannot be removed or modified, and you cannot change their priority. See <xref linkend="glossary"/>. The Details pane indicates whether the selected publisher is a system publisher.</para>
   319 <sect1 id="add-publisher"><title>Adding Publishers</title>
   321 <sect1 id="add-publisher"><title>Adding Publishers</title>
   320 <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>
   322 <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>
   321 <itemizedlist><listitem><para>Select the <guimenuitem>Add</guimenuitem> option from the <guimenu>Publisher</guimenu> drop-down menu.</para>
   323 <itemizedlist><listitem><para>Select the <guimenuitem>Add</guimenuitem> option from the <guimenu>Publisher</guimenu> drop-down menu.</para>
   322 </listitem>
   324 </listitem>
   323 <listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Add Publisher</guimenuitem></menuchoice> menu option.</para>
   325 <listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Add Publisher</guimenuitem></menuchoice> menu option.</para>
   324 </listitem>
   326 </listitem>
   325 <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>
   327 <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>
   326 </listitem>
   328 </listitem>
   327 </itemizedlist>
   329 </itemizedlist>
   328 <para>In the Add Publisher window, perform the following steps to add an IPS package publisher:</para>
   330 <para>In the Add Publisher window, perform the following steps to add an IPS package publisher:</para>
   329 <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>
   331 <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/solaris/release/</literal> or <literal>http://localhost:5555</literal>.</para>
   330 </listitem>
   332 </listitem>
   331 <listitem><para>In the Alias field, you can enter an alternate name for this publisher.</para>
   333 <listitem><para>In the Alias field, you can enter an alternate name for this publisher.</para>
   332 </listitem>
   334 </listitem>
   333 <listitem><para>Click the <guibutton>Add</guibutton> button.</para>
   335 <listitem><para>Click the <guibutton>Add</guibutton> button.</para>
   334 </listitem>
   336 </listitem>
   339 </listitem>
   341 </listitem>
   340 </itemizedlist>
   342 </itemizedlist>
   341 </listitem>
   343 </listitem>
   342 </orderedlist>
   344 </orderedlist>
   343 <para>The new publisher is the last publisher listed in the Manage Publishers window and is enabled and sticky.</para>
   345 <para>The new publisher is the last publisher listed in the Manage Publishers window and is enabled and sticky.</para>
   344 <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>
   346 <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, adding a publisher mirror, and managing publisher certificates and signature policy.</para>
   345 </sect1>
   347 </sect1>
   346 <sect1 id="modify-publisher"><title>Modifying Publishers</title>
   348 <sect1 id="modify-publisher"><title>Modifying Publishers</title>
   347 <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>
   349 <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>
   348 <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>
   350 <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. See <xref linkend="priority-stickiness"/> and <xref linkend="remove-publisher"/>.</para>
   349 <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>
   351 <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, add or remove a publisher mirror, set an SSL key and certificate, and manage publisher certificates and signature policy. See <xref linkend="origin-mirror"/> and <xref linkend="pub-security"/>.</para>
   350 <subtopic id="set-pub-order"><title>Publisher Priority</title>
   352 <sect2 id="priority-stickiness"><title>Changing Priority and Stickiness</title>
       
   353 <para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to display the Manage Publishers window.</para>
       
   354 <sect3 id="set-pub-order"><title>Publisher Priority</title>
   351 <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>
   355 <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>
   352 <itemizedlist><listitem><para>The publisher at the top of the list is also known as the preferred publisher.</para>
   356 <itemizedlist><listitem><para>The publisher at the top of the list is also known as the preferred publisher.</para></listitem>
   353 </listitem>
   357 <listitem><para>The preferred publisher cannot be disabled or removed.</para></listitem>
   354 <listitem><para>The publisher at the top of the list cannot be disabled or removed.</para>
   358 <listitem><para>When you search for packages and do not specify a publisher, the catalogs of higher priority publishers are searched first.</para></listitem>
   355 </listitem>
   359 <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>
   356 <listitem><para>When you search for packages and do not specify a publisher, the catalogs of higher priority publishers are searched first.</para>
       
   357 </listitem>
       
   358 <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>
       
   359 </listitem>
       
   360 </itemizedlist>
   360 </itemizedlist>
   361 <para>To change the priority of a publisher, perform the following steps:</para>
   361 <para>To change the priority of a publisher, perform the following steps:</para>
   362 <orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>
   362 <orderedlist><listitem><para>Click to highlight a publisher row in the list in the Manage Publishers window.</para>
   363 </listitem>
       
   364 <listitem><para>Click to highlight a publisher row in the list in the Manage Publishers window.</para>
       
   365 </listitem>
   363 </listitem>
   366 <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>
   364 <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>
   367 </listitem>
   365 <para>If the selected publisher is a system publisher, then the <guibutton>Up</guibutton> and <guibutton>Down</guibutton> buttons are disabled. You cannot change the priority of a system publisher. Because you cannot change the priority of a system publisher, you cannot lower the priority of the publisher that is the next higher priority above a system publisher, and you cannot raise the priority of a publisher that is the next lower priority below a system publisher.</para></listitem>
   368 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>
   366 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>
   369 </listitem>
   367 </listitem>
   370 </orderedlist>
   368 </orderedlist>
   371 </subtopic>
   369 </sect3>
   372 <subtopic id="gjlab"><title>Enabled and Sticky</title>
   370 <sect3 id="gjlab"><title>Enabled and Sticky</title>
   373 <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>
   371 <para>When you add a publisher, the enabled and sticky attributes are set by default. The preferred publisher (see <xref linkend="set-pub-order"/> above) cannot be disabled. A system publisher cannot be disabled, and the sticky setting of a system publisher cannot be changed. All other enabled and sticky settings can be changed.</para>
   374 <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>
   372 <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>
   375 <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>
   373 <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>
   376 <para>To change the Enabled and Sticky settings for a publisher, perform the following steps:</para>
   374 <para>To change the Enabled and Sticky settings for a publisher, perform the following steps:</para>
   377 <orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>
   375 <orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>
   378 </listitem>
   376 </listitem>
   379 <listitem><para>Click an Enabled box or a Sticky box to toggle its setting.</para>
   377 <listitem><para>Click an Enabled box or a Sticky box to toggle its setting.</para>
   380 </listitem>
   378 </listitem>
   381 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>
   379 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>
   382 </listitem>
   380 </listitem>
   383 </orderedlist>
   381 </orderedlist>
   384 </subtopic>
   382 </sect3>
   385 <subtopic id="modify-publisher-alias"><title>Publisher Alias</title>
   383 </sect2>
       
   384 <sect2 id="origin-mirror"><title>Changing Alias, Origins, and Mirrors</title>
       
   385 <orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>
       
   386 </listitem>
       
   387 <listitem><para>Select the publisher 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>
       
   388 </listitem>
       
   389 <listitem><para>Click the <guibutton>Modify</guibutton> button to the right of the publisher list to open the Modify Publisher window.</para>
       
   390 <para>If the selected publisher is a system publisher, the <guibutton>Modify</guibutton> button is disabled. The Details pane indicates that the selected publisher is a system publisher and displays a message that this publisher cannot be modified or removed.</para>
       
   391 </listitem>
       
   392 <listitem><para>Select the General tab to modify the publisher alias, add and remove origins, and add and remove mirrors.</para></listitem>
       
   393 </orderedlist>
       
   394 <sect3 id="modify-publisher-alias"><title>Publisher Alias</title>
   386 <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>
   395 <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>
   387 <para>To change the alias of a publisher, perform the following steps:</para>
   396 <para>To change the alias of this publisher, perform the following steps:</para>
       
   397 <orderedlist><listitem><para>On the General tab of the Modify Publisher window, enter a new name in the Alias field.</para>
       
   398 </listitem>
       
   399 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para>
       
   400 </listitem>
       
   401 <listitem><para>The publisher alias has changed in the Manage Publishers window. Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>
       
   402 </listitem>
       
   403 </orderedlist>
       
   404 </sect3>
       
   405 <sect3 id="gjkza"><title>Publisher Origins</title>
       
   406 <para>An origin is the location of an IPS package repository or archive that contains both package metadata (package manifests and catalogs) and package content (package files).</para>
       
   407 <para>An origin value is the URI of an IPS package repository.</para>
       
   408 <para>To change, add, or remove an origin for this publisher, perform the following steps:</para>
       
   409 <orderedlist><listitem><para>Select the General tab of the Modify Publisher window.</para>
       
   410 <itemizedlist><listitem><para>Add an origin.</para>
       
   411 <orderedlist type="a"><listitem><para>In the Origin field, enter the URI of the new origin you want to associate with this publisher.</para></listitem>
       
   412 <listitem><para>Click the <guibutton>Add</guibutton> button. The new URI is added to the list below the Origin field.</para></listitem>
       
   413 </orderedlist>
       
   414 </listitem>
       
   415 <listitem><para>Remove an origin.</para>
       
   416 <orderedlist type="a"><listitem><para>In the list below the Origin field, select the URI you want to delete.</para></listitem>
       
   417 <listitem><para>Click the <guibutton>Remove</guibutton> button. The selected URI is removed from the list. If only one origin is defined for this publisher, you cannot remove that origin.</para></listitem>
       
   418 </orderedlist>
       
   419 </listitem>
       
   420 <listitem><para>Change an origin.</para>
       
   421 <orderedlist type="a"><listitem><para>Add the new origin.</para></listitem>
       
   422 <listitem><para>Delete the origin you want to change.</para></listitem>
       
   423 </orderedlist>
       
   424 </listitem>
       
   425 </itemizedlist>
       
   426 </listitem>
       
   427 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para>
       
   428 </listitem>
       
   429 <listitem><para>The origin changes are reflected in the Details pane in the Manage Publishers window. Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>
       
   430 </listitem>
       
   431 </orderedlist>
       
   432 </sect3>
       
   433 <sect3 id="gjkyr"><title>Publisher Mirrors</title>
       
   434 <para>A mirror is a location of an IPS package repository that contains only package content (package files). A mirror does not contain package metadata (package manifests and catalogs). Mirrors provide a subset of the data that origins provide. Mirrors can be used only for downloading package files. Package metadata is downloaded from the origin. IPS clients access the origin to obtain a publisher's catalog, even when the clients download package content from a mirror.</para>
       
   435 <para>To add, remove, or change a mirror for this publisher, perform the following steps:</para>
       
   436 <orderedlist><listitem><para>Select the General tab of the Modify Publisher window.</para></listitem>
       
   437 <listitem><para>Click the Mirrors label to display the Mirror field and the list of mirrors.</para>
       
   438 <itemizedlist><listitem><para>Add a mirror.</para>
       
   439 <orderedlist type="a"><listitem><para>In the Mirror field, enter the URI of the new mirror you want to associate with this publisher.</para></listitem>
       
   440 <listitem><para>Click the <guibutton>Add</guibutton> button. The new URI is added to the list below the Mirror field.</para></listitem>
       
   441 </orderedlist>
       
   442 </listitem>
       
   443 <listitem><para>Remove a mirror.</para>
       
   444 <orderedlist type="a"><listitem><para>In the list below the Mirror field, select the URI you want to delete.</para></listitem>
       
   445 <listitem><para>Click the <guibutton>Remove</guibutton> button. The selected URI is removed from the list.</para></listitem>
       
   446 </orderedlist>
       
   447 </listitem>
       
   448 <listitem><para>Change a mirror.</para>
       
   449 <orderedlist type="a"><listitem><para>Delete the mirror you want to change.</para></listitem>
       
   450 <listitem><para>Add a new mirror.</para></listitem>
       
   451 </orderedlist>
       
   452 </listitem>
       
   453 </itemizedlist>
       
   454 </listitem>
       
   455 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para>
       
   456 </listitem>
       
   457 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>
       
   458 </listitem>
       
   459 </orderedlist>
       
   460 </sect3>
       
   461 </sect2>
       
   462 <sect2 id="security"><title>Managing Publisher Security</title>
       
   463 <para>Certificates are used to verify that packages have been appropriately signed before being installed, depending on the signature policy of the image or the publisher, whichever is more restrictive.</para>
   388 <orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>
   464 <orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>
   389 </listitem>
   465 </listitem>
   390 <listitem><para>Select the publisher whose alias you want to modify.</para>
   466 <listitem><para>Select the publisher whose security you want to modify.</para>
   391 </listitem>
   467 </listitem>
   392 <listitem><para>Click the <guibutton>Modify</guibutton> button to the right of the publisher list to open the Modify Publisher window.</para>
   468 <listitem><para>Click the <guibutton>Modify</guibutton> button to the right of the publisher list to open the Modify Publisher window. The publisher that was selected in the Manage Publishers window is listed in the title of the Modify Publisher window.</para>
   393 </listitem>
   469 <itemizedlist><listitem><para>Select the General tab to add the SSL key and SSL certificate if a publisher has a secure origin.</para></listitem>
   394 <listitem><para>Enter a new name in the Alias field.</para>
   470 <listitem><para>Select the Certificates tab to manage certificates for this publisher.</para></listitem>
   395 </listitem>
   471 <listitem><para>Select the Signature Policy tab to manage signature policy for this publisher.</para></listitem>
   396 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para>
   472 </itemizedlist>
   397 </listitem>
   473 </listitem>
   398 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>
   474 </orderedlist>
   399 </listitem>
   475 <sect3 id="keys-certs"><title>Adding SSL Keys and Certificates</title>
   400 </orderedlist>
       
   401 </subtopic>
       
   402 <subtopic id="gjkza"><title>Publisher Origins</title>
       
   403 <para>An origin is an original source of packages, as opposed to a mirror.</para>
       
   404 <para>An origin value is the URI of a IPS package repository.</para>
       
   405 <para>To change, add, or remove a publisher origin, perform the following steps:</para>
       
   406 <orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>
       
   407 </listitem>
       
   408 <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>
       
   409 </listitem>
       
   410 <listitem><para>Click the <guibutton>Modify</guibutton> button to the right of the publisher list to open the Modify Publisher window.</para>
       
   411 </listitem>
       
   412 <listitem><para>You can change, add, or remove an origin for this publisher.</para>
       
   413 <itemizedlist><listitem><para>To change an origin, delete the origin you want to change and then add a new origin.</para>
       
   414 </listitem>
       
   415 <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>
       
   416 </listitem>
       
   417 <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>
       
   418 </listitem>
       
   419 </itemizedlist>
       
   420 </listitem>
       
   421 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para>
       
   422 </listitem>
       
   423 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>
       
   424 </listitem>
       
   425 </orderedlist>
       
   426 </subtopic>
       
   427 <subtopic id="gjkyy"><title>Publisher Security</title>
       
   428 <para>If a publisher has a secure origin, add the SSL key and SSL certificate for the publisher.</para>
   476 <para>If a publisher has a secure origin, add the SSL key and SSL certificate for the publisher.</para>
   429 <orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>
   477 <orderedlist><listitem><para>Click the General tab of the Modify Publisher window.</para></listitem>
   430 </listitem>
   478 <listitem><para>Click the SSL Key and Certificate label to display the SSL Key field and the SSL Certificate field.</para></listitem>
   431 <listitem><para>Select the publisher whose security you want to modify.</para>
   479 <listitem><para>Click the <guibutton>Browse</guibutton> button to the right of the SSL Key field to select the SSL Key file.</para></listitem>
   432 </listitem>
   480 <listitem><para>Click the <guibutton>Browse</guibutton> button to the right of the SSL Certificate field to select the SSL Certificate file.</para> </listitem>
   433 <listitem><para>Click the <guibutton>Modify</guibutton> button to the right of the publisher list to open the Modify Publisher window.</para>
   481 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para></listitem>
   434 </listitem>
   482 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para></listitem>
   435 <listitem><para>Click the SSL Key and Certificate label to display the SSL Key field and the SSL Certificate field.</para>
   483 </orderedlist>
   436 </listitem>
   484 </sect3>
   437 <listitem><para>Click the <guibutton>Browse</guibutton> button to the right of the SSL Key field to select the SSL Key file.</para>
   485 <sect3 id="manage-certs"><title>Managing Certificates</title>
   438 </listitem>
   486 <orderedlist><listitem><para>Click the Certificates tab of the Modify Publisher window.</para></listitem>
   439 <listitem><para>Click the <guibutton>Browse</guibutton> button to the right of the SSL Certificate field to select the SSL Certificate file.</para>
   487 <listitem><para>Use the buttons below the list of certificates to add a certificate or to remove, revoke, or reinstate the certificate that is currently selected in the list.</para>
   440 </listitem>
   488 <para>Note that any actions you take in the Modify Publisher window are applied to the selected publisher's certificates only after you click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window. If you click the <guibutton>Cancel</guibutton> button, no changes are applied.</para>
   441 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para>
   489 <itemizedlist><listitem><para><guibutton>Add</guibutton>. Add a new publisher certificate for the publisher listed in the Modify Publisher window title. In the Add Publisher Certificate window, browse to select the certificate (<tt>.pem</tt>) file. Click the <guibutton>OK</guibutton> button at the bottom of the Add Publisher Certificate window. The newly added certificate is selected in the certificates list in the Certificates tab of the Modify Publisher window. The details pane indicates that this certificate is "marked to be added." This certificate will be added after you click the <guibutton>OK</guibutton> button on the Modify Publisher window.</para></listitem>
   442 </listitem>
   490 </itemizedlist>
   443 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>
   491 </listitem>
   444 </listitem>
   492 <listitem><para>In the list of certificates for this publisher, select the certificate you want to modify or whose details you want to check. Details about the selected certificate are shown below the list of certificates and row of buttons. Note that an expired certificate can still be Approved and used to validate signed packages that were published (not necessarily installed) before the certificate expired.</para>
   445 </orderedlist>
   493 <para>Click the headings of the list of certificates to resort the list. The Organization and Name columns are resizable.</para>
   446 </subtopic>
   494 <itemizedlist><listitem><para><guibutton>Remove</guibutton>. Remove the certificate that is currently selected in the certificates list.</para></listitem>
   447 <subtopic id="gjkyr"><title>Publisher Mirrors</title>
   495 <listitem><para><guibutton>Revoke</guibutton>. If the certificate currently selected in the certificates list is Approved, click the <guibutton>Revoke</guibutton> button to treat this certificate as revoked. In the certificates list, the Status of this certificate changes to Revoked. This change is applied to the certificate after you click the <guibutton>OK</guibutton> button on the Modify Publisher window.</para></listitem>
   448 <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>
   496 <listitem><para><guibutton>Reinstate</guibutton>. If the certificate currently selected in the certificates list is Revoked, click the <guibutton>Reinstate</guibutton> button to treat this certificate as approved. The details pane indicates that this certificate is "marked to be reinstated." This certificate will be reinstated after you click the <guibutton>OK</guibutton> button on the Modify Publisher window.</para></listitem>
   449 <para>To change, add, or remove a publisher mirror, perform the following steps:</para>
   497 </itemizedlist>
   450 <orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>
   498 </listitem>
   451 </listitem>
   499 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para></listitem>
   452 <listitem><para>Select the publisher whose mirrors you want to modify.</para>
   500 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para></listitem>
   453 </listitem>
   501 </orderedlist>
   454 <listitem><para>Click the <guibutton>Modify</guibutton> button to the right of the publisher list to open the Modify Publisher window.</para>
   502 </sect3>
   455 </listitem>
   503 <sect3 id="pub-sig-policy"><title>Managing Signature Policy</title>
   456 <listitem><para>Click the Mirrors label to display the Mirror field and the list of mirrors.</para>
   504 <orderedlist><listitem><para>Click the Signature Policy tab of the Modify Publisher window.</para></listitem>
   457 </listitem>
   505 <listitem><para>Use the buttons on the Signature Policy tab to set the signature policy to use when installing packages from the publisher listed in the Modify Publisher window title.</para>
   458 <listitem><para>You can change, add, or remove a mirror for this publisher.</para>
   506 <para>To set the global signature policy, use the Signature Policy tab of the Preferences window (see <xref linkend="img-sig-policy"/>).</para>
   459 <itemizedlist><listitem><para>To change a mirror, delete the mirror you want to change and then add a new mirror.</para>
   507 <itemizedlist><listitem><para>Signatures are ignored: Ignore signatures for all packages.</para></listitem>
   460 </listitem>
   508 <listitem><para>Signatures are optional, but must be valid if provided: Verify that all packages with signatures are validly signed, but do not require all installed packages to be signed.</para></listitem>
   461 <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>
   509 <listitem><para>One or more valid signatures are required: Require that all newly installed packages have at least one valid signature.</para></listitem>
   462 </listitem>
   510 <listitem><para>Signatures are required and the certificate name must include the name or names specified in the text field when validating the signatures of a package. If more than one name is specified, the names must be comma-separated.</para></listitem></itemizedlist>
   463 <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>
   511 </listitem>
   464 </listitem>
   512 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para></listitem>
   465 </itemizedlist>
   513 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para></listitem>
   466 </listitem>
   514 </orderedlist>
   467 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para>
   515 </sect3>
   468 </listitem>
   516 </sect2>
   469 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>
       
   470 </listitem>
       
   471 </orderedlist>
       
   472 </subtopic>
       
   473 </sect1>
   517 </sect1>
   474 <sect1 id="remove-publisher"><title>Removing Publishers</title>
   518 <sect1 id="remove-publisher"><title>Removing Publishers</title>
   475 <para>Perform the following steps to remove a publisher:</para>
   519 <para>Perform the following steps to remove a publisher:</para>
   476 <orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>
   520 <orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>
   477 </listitem>
   521 </listitem>
   478 <listitem><para>Select the publisher that you want to remove.</para>
   522 <listitem><para>Select the publisher that you want to remove.</para>
   479 </listitem>
   523 </listitem>
   480 <listitem><para>Click the <guibutton>Remove</guibutton> button to the right of the publisher list to open the Modify Publisher window.</para>
   524 <listitem><para>Click the <guibutton>Remove</guibutton> button to the right of the publisher list.</para>
       
   525 <para>If the selected publisher is a system publisher, the <guibutton>Remove</guibutton> button is disabled. The Details pane indicates that the selected publisher is a system publisher and displays a message that this publisher cannot be modified or removed.</para>
   481 </listitem>
   526 </listitem>
   482 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>
   527 <listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>
   483 </listitem>
   528 </listitem>
   484 </orderedlist>
   529 </orderedlist>
   485 </sect1>
   530 </sect1>
   486 </chapter>
   531 </chapter>
   487 <chapter id="manage-be"><title>Managing Boot Environments</title>
   532 <chapter id="manage-be"><title>Managing Boot Environments</title>
   488 <para>A boot environment (BE) is a bootable image. You can maintain multiple BEs on your Oracle Solaris system. One BE is the default BE at startup or reboot. Other BEs are available as alternate boot selections. The BE you are booted into is the active BE.</para>
   533 <para>A boot environment (BE) is a bootable image. You can maintain multiple BEs on your Oracle Solaris system. One BE is the default BE at startup or reboot. Other BEs are available as alternate boot selections. The BE you are booted into is the active BE.</para>
   489 <para>You can use the <literal>beadm</literal>(1) command to create, rename, mount, unmount, activate, or destroy BEs. For complete information about BEs, see <citetitle>Managing Boot Environments With Oracle Solaris 11 Express</citetitle>.</para>
   534 <para>You can use the <literal>beadm</literal>(1) command to create, rename, mount, unmount, activate, or destroy BEs. For complete information about BEs, see <citetitle>Creating and Managing Boot Environments After Installation</citetitle>.</para>
   490 <para>Package Manager provides a subset of the functionality that the <literal>beadm</literal>(1) command provides. Use the Package Manager <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Boot Environments</guimenuitem></menuchoice> option to open the Manage Boot Environments window. The Manage Boot Environments window lists the BEs on this system and enables you to activate, rename, and delete those BEs as described below.</para>
   535 <para>Package Manager provides a subset of the functionality that the <literal>beadm</literal>(1) command provides. Use the Package Manager <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Boot Environments</guimenuitem></menuchoice> option to open the Manage Boot Environments window. The Manage Boot Environments window lists the BEs on this system and enables you to activate, rename, and delete those BEs as described below.</para>
   491 <sect1 id="create-be"><title>Creating a BE</title>
   536 <sect1 id="create-be"><title>Creating a BE</title>
   492 <para>A new BE is automatically created when you do one of the following actions:</para>
   537 <para>A new BE is automatically created when you do one of the following actions:</para>
   493 <itemizedlist><listitem><para>Install the Oracle Solaris OS.</para>
   538 <itemizedlist><listitem><para>Install the Oracle Solaris OS.</para>
   494 </listitem>
   539 </listitem>
   495 <listitem><para>Update particular key system packages such as some drivers and other kernel components.</para>
   540 <listitem><para>Install or update particular key system packages such as some drivers and other kernel components.</para>
   496 </listitem>
   541 </listitem>
   497 <listitem><para>Use the <literal>beadm create</literal> command.</para>
   542 <listitem><para>Use the <literal>beadm create</literal> command.</para>
   498 </listitem>
   543 </listitem>
   499 </itemizedlist>
   544 </itemizedlist>
   500 <para>Often a new BE is created when you execute the <literal>pkg image-update</literal> command or use the <guibutton>Updates</guibutton> button to update all packages that have updates available.</para>
   545 <para>Often a new BE is created when you execute the <literal>pkg update</literal> command or use the <guibutton>Updates</guibutton> button to update all packages that have updates available.</para>
   501 </sect1>
   546 </sect1>
   502 <sect1 id="activate-be"><title>Activating a BE</title>
   547 <sect1 id="activate-be"><title>Activating a BE</title>
   503 <para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Boot Environments</guimenuitem></menuchoice> menu option to open the Manage Boot Environments window. Each BE is listed in the window. The BE that you are currently booted into shows a check mark to the left of the BE name.</para>
   548 <para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Boot Environments</guimenuitem></menuchoice> menu option to open the Manage Boot Environments window. Each BE is listed in the window. The BE that you are currently booted into shows a check mark to the left of the BE name.</para>
   504 <para>To specify a different BE to be the default active BE after the next reboot, perform the following steps:</para>
   549 <para>To specify a different BE to be the default active BE after the next reboot, perform the following steps:</para>
   505 <orderedlist><listitem><para>Select the <guibutton>Active on Reboot</guibutton> button for the BE that you want to be the default active BE after the next reboot.</para>
   550 <orderedlist><listitem><para>Select the <guibutton>Active on Reboot</guibutton> button for the BE that you want to be the default active BE after the next reboot.</para>
   511 <sect1 id="rename-be"><title>Renaming a BE</title>
   556 <sect1 id="rename-be"><title>Renaming a BE</title>
   512 <para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Boot Environments</guimenuitem></menuchoice> menu option to open the Manage Boot Environments window. Each BE is listed in the window.</para>
   557 <para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Boot Environments</guimenuitem></menuchoice> menu option to open the Manage Boot Environments window. Each BE is listed in the window.</para>
   513 <para>You cannot rename the currently active BE.</para>
   558 <para>You cannot rename the currently active BE.</para>
   514 <para>You cannot rename a BE that you have marked for deletion.</para>
   559 <para>You cannot rename a BE that you have marked for deletion.</para>
   515 <para>To rename a BE, perform the following steps:</para>
   560 <para>To rename a BE, perform the following steps:</para>
   516 <orderedlist><listitem><para>Double-click the name of the BE that you want to rename.</para>
   561 <orderedlist><listitem><para>Double-click the name of the BE that you want to rename. The name field becomes editable.</para>
   517 </listitem>
   562 </listitem>
   518 <listitem><para>Enter the new name.</para>
   563 <listitem><para>Enter the new name.</para>
   519 </listitem>
   564 </listitem>
   520 <listitem><para>Select the <guibutton>OK</guibutton> button in the Manage Boot Environments window.</para>
   565 <listitem><para>Select the <guibutton>OK</guibutton> button in the Manage Boot Environments window.</para>
   521 </listitem>
   566 </listitem>
   558 <sect1 id="webinstall-add"><title>Using WebInstall to Add Publishers and Install Packages</title>
   603 <sect1 id="webinstall-add"><title>Using WebInstall to Add Publishers and Install Packages</title>
   559 <para>The WebInstall process enables you to install packages through a <filename>p5i</filename> file.</para>
   604 <para>The WebInstall process enables you to install packages through a <filename>p5i</filename> file.</para>
   560 <orderedlist><listitem><para>Locate the <filename>.p5i</filename> file. This file might be on your desktop or on a web site.</para>
   605 <orderedlist><listitem><para>Locate the <filename>.p5i</filename> file. This file might be on your desktop or on a web site.</para>
   561 </listitem>
   606 </listitem>
   562 <listitem><para>Use one of the following methods to start Package Manager in WebInstall mode:</para>
   607 <listitem><para>Use one of the following methods to start Package Manager in WebInstall mode:</para>
   563 <itemizedlist><listitem><para>Click on a <filename>.p5i</filename> file on your desktop. The associated application (Package Manager in WebInstall mode) is launched.</para>
   608 <itemizedlist><listitem><para>Click on a <filename>.p5i</filename> file on your desktop. The associated application (Package Manager Web Installer) is launched.</para>
   564 </listitem>
   609 </listitem>
   565 <listitem><para>Start Package Manager from the command line along with a path to the <filename>.p5i</filename> file. For example, enter the following command:</para>
   610 <listitem><para>Start Package Manager from the command line along with a path to the <filename>.p5i</filename> file. For example, enter the following command:</para>
   566 <screen># <userinput>packagemanager/<replaceable>path_to_p5i_file/file.p5i</replaceable></userinput></screen>
   611 <screen># <userinput>packagemanager/<replaceable>path_to_p5i_file/file.p5i</replaceable></userinput></screen>
   567 </listitem>
   612 </listitem>
   568 <listitem><para>Go to a URL location that contains a link to <filename>.p5i</filename> file. The <filename>.p5i</filename> file must be located on a web server that has registered this MIME type.</para>
   613 <listitem><para>Go to a URL location that contains a link to <filename>.p5i</filename> file. The <filename>.p5i</filename> file must be located on a web server that has registered this MIME type.</para>
   569 <para>If the <filename>.p5i</filename> is located on a web server that has not registered this MIME type, save the <filename>.p5i</filename> file to your desktop and then click on it to launch WebInstall.</para>
   614 <para>If the <filename>.p5i</filename> is located on a web server that has not registered this MIME type, save the <filename>.p5i</filename> file to your desktop and then click on it to launch WebInstall.</para>
   570 </listitem>
   615 </listitem>
   571 </itemizedlist>
   616 </itemizedlist>
   572 </listitem>
   617 </listitem>
   573 <listitem><para>The Install/Update window is displayed. The label at the top of the window is: &#8220;Package Manager Web Installer/The following will be added to your system:&#8221; Then the publishers and packages are listed. Click the <guibutton>Proceed</guibutton> button to continue with the installation.</para>
   618 <listitem><para>The Install/Update window is displayed. The label at the top of the window is: “Package Manager Web Installer/The following will be added to your system:” Then the publishers and packages are listed. Click the <guibutton>Proceed</guibutton> button to continue with the installation.</para>
   574 <itemizedlist><listitem><para>If the package publisher is not already configured on your system, the Add Publisher window is displayed. The name and URI of the publisher are already entered.</para>
   619 <itemizedlist><listitem><para>If the package publisher is not already configured on your system, the Add Publisher window is displayed. The name and URI of the publisher are already entered.</para>
   575 <para>If the publishers to be added are secure publishers, an SSL key and certificate are required. Browse to locate the SSL Key and SSL Certificate on your system.</para>
   620 <para>If the publishers to be added are secure publishers, an SSL key and certificate are required. Browse to locate the SSL Key and SSL Certificate on your system.</para>
   576 <para>The Adding Publisher Complete dialog displays if the publisher is added successfully. Click the <guibutton>OK</guibutton> button to continue with the installation.</para>
   621 <para>The Adding Publisher Complete dialog displays if the publisher is added successfully. Click the <guibutton>OK</guibutton> button to continue with the installation.</para>
   577 </listitem>
   622 </listitem>
   578 <listitem><para>If a <filename>.p5i</filename> file contains packages from a disabled publisher, WebInstall opens up an Enable Publisher dialog. Use this dialog to enable the publisher so that you can install the packages.</para>
   623 <listitem><para>If a <filename>.p5i</filename> file contains packages from a disabled publisher, WebInstall opens up an Enable Publisher dialog. Use this dialog to enable the publisher so that you can install the packages.</para>
   579 </listitem>
   624 </listitem>
   580 </itemizedlist>
   625 </itemizedlist>
   581 </listitem>
   626 </listitem>
   582 <listitem><para>The Install/Update window now looks the same as when you select <guibutton>Install/Update</guibutton> from within Package Manager.</para>
   627 <listitem><para>The Install/Update window now looks the same as when you select <guibutton>Install/Update</guibutton> from within Package Manager.</para>
   583 <para>The application closes when all packages are installed.</para>
       
   584 </listitem>
   628 </listitem>
   585 </orderedlist>
   629 </orderedlist>
   586 </sect1>
   630 </sect1>
   587 </chapter>
   631 </chapter>
   588 <chapter id="gkioy"><title>Troubleshooting</title>
   632 <chapter id="gkioy"><title>Troubleshooting</title>
   591 <para>Select the <menuchoice><guimenu>View</guimenu><guimenuitem>Logs</guimenuitem></menuchoice> menu option to open the Logs window. The Logs window displays error, warning, and informational messages from Package Manager and Update Manager.</para>
   635 <para>Select the <menuchoice><guimenu>View</guimenu><guimenuitem>Logs</guimenuitem></menuchoice> menu option to open the Logs window. The Logs window displays error, warning, and informational messages from Package Manager and Update Manager.</para>
   592 <para>Select the <guibutton>Clear</guibutton> button at the bottom of the Logs window to delete all the messages.</para>
   636 <para>Select the <guibutton>Clear</guibutton> button at the bottom of the Logs window to delete all the messages.</para>
   593 <para>If an error or warning is logged, a yellow triangle is displayed on the left side of the status bar. Click the yellow triangle to display the Logs window.</para>
   637 <para>If an error or warning is logged, a yellow triangle is displayed on the left side of the status bar. Click the yellow triangle to display the Logs window.</para>
   594 </sect1>
   638 </sect1>
   595 </chapter>
   639 </chapter>
   596 <chapter id="pkg-mgr-prefs"><title>Setting GUI Preferences</title>
   640 <chapter id="pkg-mgr-prefs"><title>Setting Preferences</title>
   597 <para>Use the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> menu option to change some of the Package Manager user interface settings.</para>
   641 <para>Use the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> menu option to change some of the Package Manager user interface settings.</para>
       
   642 <para>The Preferences window has three tabs:</para>
       
   643 <itemizedlist><listitem><para>The General tab enables you to set exit preferences and confirmation dialog preferences.</para></listitem>
       
   644 <listitem><para>The Optional Components tab enables you to set preferences for which optional package components to install when you install or update a package.</para></listitem>
       
   645 <listitem><para>The Signature Policy tab enables you to set signature policy for this image.</para></listitem>
       
   646 </itemizedlist>
   598 <sect1 id="gjktu"><title>Exit Preferences</title>
   647 <sect1 id="gjktu"><title>Exit Preferences</title>
   599 <para>If the &#8220;Remember current state on exit&#8221; box is checked, Package Manager saves the following settings and restores them the next time you start Package Manager:</para>
   648 <para>Select the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> option and select the General tab.</para>
   600 <itemizedlist><listitem><para><emphasis role="strong">Vertical and horizontal separators</emphasis> &#8212; Widths and heights of the panes in the window</para>
   649 <para>If the “Remember current state on exit” box is checked, Package Manager saves the following settings and restores them the next time you start Package Manager:</para>
   601 </listitem>
   650 <itemizedlist><listitem><para><emphasis role="strong">Vertical and horizontal separators</emphasis> — Widths and heights of the panes in the window</para>
   602 <listitem><para><emphasis role="strong">Window size</emphasis> &#8212; Overall size of the Package Manager window</para>
   651 </listitem>
   603 </listitem>
   652 <listitem><para><emphasis role="strong">Window size</emphasis> — Overall size of the Package Manager window</para>
   604 <listitem><para><emphasis role="strong">Publisher option</emphasis> &#8212; The publisher or other option that is selected in the <guimenu>Publisher</guimenu> drop-down menu when Package Manager is closed</para>
   653 </listitem>
   605 </listitem>
   654 <listitem><para><emphasis role="strong">Publisher option</emphasis> — The publisher or other option that is selected in the <guimenu>Publisher</guimenu> drop-down menu when Package Manager is closed</para>
   606 <listitem><para><emphasis role="strong">Categories</emphasis> &#8212; The selected category and the expanded and collapsed categories for each publisher</para>
   655 </listitem>
       
   656 <listitem><para><emphasis role="strong">Categories</emphasis> — The selected category and the expanded and collapsed categories for each publisher</para>
   607 </listitem>
   657 </listitem>
   608 </itemizedlist>
   658 </itemizedlist>
   609 </sect1>
   659 </sect1>
   610 <sect1 id="gjkug"><title>Confirmation Dialog Preferences</title>
   660 <sect1 id="gjkug"><title>Confirmation Dialog Preferences</title>
       
   661 <para>Select the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> option and select the General tab.</para>
   611 <para>When a package is installed, updated, or removed, a confirmation dialog is displayed that shows the list of packages and the action to be performed. If you do not want to see these confirmation dialogs, uncheck these selections in the Preferences window.</para>
   662 <para>When a package is installed, updated, or removed, a confirmation dialog is displayed that shows the list of packages and the action to be performed. If you do not want to see these confirmation dialogs, uncheck these selections in the Preferences window.</para>
   612 <para>Clicking the &#8220;Do not show this confirmation dialog again&#8221; check box in a particular confirmation dialog also unsets this preference for that dialog.</para>
   663 <para>Clicking the “Do not show this confirmation dialog again” check box in a particular confirmation dialog also unsets this preference for that dialog.</para>
       
   664 </sect1>
       
   665 <sect1 id="img-sig-policy"><title>Signature Policy Preferences</title>
       
   666 <para>Use the buttons on the Signature Policy tab to ignore or require signatures when installing packages in this image. To set signature policy for specific publishers, select the publisher in the Manage Publishers window, click the <guibutton>Modify</guibutton> button, and use the Signature Policy tab of the Modify Publisher window.</para>
       
   667 <para>The choices for image signature policy are the same as the choices for publisher signature policy except that the settings apply to all packages installed in the image, not just to packages installed from a particular publisher. See <xref linkend="pub-sig-policy"/>.</para>
       
   668 </sect1>
       
   669 <sect1 id="languages"><title>Optional Component Preferences Language Choices</title>
       
   670 <para>Select the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> option and select the Optional Components tab.</para>
       
   671 <para>By default, Install all languages is selected under Language choices for any package. You can save space in your installation by selecting a subset of languages to install.</para>
       
   672 <para>When Install only these languages is selected, you can click the checkbox icon in the left most column heading of the language list to select all languages. Click the column heading again to deselect all languages. Click the Language and Territory column headings to sort the list.</para>
       
   673 <para>Click the OK button to save your changes. These settings apply to currently installed packages as well as future package installations and updates. The image is updated as necessary to install or remove optional package components based on the new settings.</para>
       
   674 <para>If you have previously updated your image to include only a subset of languages, Install only these languages is the default selection in this window, and that language list is grayed out if you select the Install all languages option.</para>
       
   675 </sect1>
       
   676 <sect1 id="dev-doc"><title>Other Optional Component Preferences</title>
       
   677 <para>Select the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> option and select the Optional Components tab.</para>
       
   678 <para>By default, Install all development files and Install all documentation are selected under Other component choices. You can save space in your installation by deselecting development files or documentation.</para>
       
   679 <para>Click the OK button to save your changes. These settings apply to currently installed packages as well as future package installations and updates. The image is updated as necessary to install or remove optional package components based on the new settings.</para>
   613 </sect1>
   680 </sect1>
   614 </chapter>
   681 </chapter>
   615 <glossary id="glossary"><title>Glossary</title>
   682 <glossary id="glossary"><title>Glossary</title>
   616 <glossentry><glossterm>alias</glossterm>
   683 <glossentry><glossterm>alias</glossterm>
   617 <glossdef><para>Another name for a publisher.</para>
   684 <glossdef><para>Another name for a publisher.</para>
   643 <glossentry><glossterm>package</glossterm>
   710 <glossentry><glossterm>package</glossterm>
   644 <glossdef><para>A collection of files, directories, links, drivers, and dependencies in a defined format.</para>
   711 <glossdef><para>A collection of files, directories, links, drivers, and dependencies in a defined format.</para>
   645 </glossdef>
   712 </glossdef>
   646 </glossentry>
   713 </glossentry>
   647 <glossentry><glossterm>publisher</glossterm>
   714 <glossentry><glossterm>publisher</glossterm>
   648 <glossdef lang="en"><para>A person, group, or corporation that designs, creates, and publishes a package to a package server. The package server in turn serves the packages from the (default) publisher, for downloading purposes.</para>
   715 <glossdef><para>A person, group, or corporation that designs, creates, and publishes a package to a package server. The package server in turn serves the packages from the (default) publisher, for downloading purposes.</para>
       
   716 </glossdef>
       
   717 </glossentry>
       
   718 <glossentry><glossterm>system publisher</glossterm>
       
   719 <glossdef><para>System publishers are special publishers used in linked images and non-global zones in particular, to ensure that certain packages stay in sync with the global zone. The global zone constrains packages within the non-global zones by configuring these special system publishers in the non-global zone. They are special because the non-global zones cannot make certain changes to them including removing, disabling, modifying, or changing their priority.</para>
   649 </glossdef>
   720 </glossdef>
   650 </glossentry>
   721 </glossentry>
   651 </glossary>
   722 </glossary>
   652 </book>
   723 </book>