src/gui/help/C/package-manager.xml.in
author Jon Tibble <meths@btinternet.com>
Sat, 25 Feb 2012 15:16:48 +0000
branchoi_151a
changeset 2546 2b1fa6a54b5e
parent 2094 dbf4ce9ada97
child 2556 5dfb1d0d1148
permissions -rw-r--r--
Apply Shawn Walker's backport - breaking some branding
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
     1
<?xml version="1.0" encoding="utf-8"?>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
     2
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
     3
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
     4
<book id="pkgmgr"><title><trademark class="registered">Oracle</trademark> Solaris 11 Package Manager Online Help</title>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
     5
<bookinfo><authorgroup><author><firstname>Oracle</firstname>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
     6
<surname>Corporation</surname>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
     7
</author>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
     8
</authorgroup>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
     9
<releaseinfo>Oracle Solaris 11</releaseinfo>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    10
<pubdate>June 2011</pubdate>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    11
<publisher><publishername>Oracle Corporation</publishername>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    12
<address><street>500 Oracle Parkway</street>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    13
<city>Redwood City</city>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    14
<state>CA</state>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    15
<postcode>94065</postcode>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    16
<country>U.S.A.</country>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    17
</address>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
    18
</publisher>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    19
<copyright><year>2008, 2011</year></copyright>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    25
<para>Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    28
<para lang="fr"/>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    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>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
    36
</legalnotice>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
    37
</bookinfo>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    38
<chapter id="about"><title>About Package Manager</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    39
<para>Package Manager is a graphical user interface (GUI) for the Oracle Solaris Image Packaging System (IPS).</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    40
<para>See the <xref linkend="glossary"/> for definitions of terms used in this document.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    41
<sect1 id="gikcw"><title>Oracle Solaris Image Packaging System</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    45
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    46
<sect1 id="pm-win"><title>Package Manager</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    47
<para>Package Manager provides a subset of the functionality offered by the IPS command-line interface.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    48
<para>Package Manager enables you to perform the following tasks:</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    49
<itemizedlist><listitem><para>Find, install, update, and remove IPS packages. See <xref linkend="manage-pkg"/>.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
    50
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    51
<listitem><para>Update your system (update all the packages on your system). See <xref linkend="update_all"/>.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    52
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    53
<listitem><para>Add, modify, and delete IPS package publishers. See <xref linkend="manage-publisher"/>.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
    54
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    55
<listitem><para>List, rename, delete, and manage boot environments. See <xref linkend="manage-be"/>.</para>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
    56
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    57
<listitem><para>Create a WebInstall installation file (<filename>.p5i</filename>). See <xref linkend="webinstall"/>.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
    58
</listitem>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
    59
</itemizedlist>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    60
<para>This documentation refers to the following features of the Package Manager window:</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    61
<itemizedlist><listitem><para>The large pane in the center of the window is the package list pane. Sometimes this pane shows informational messages, but usually this pane contains a list of packages.</para>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
    62
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    63
<listitem><para>The menu bar at the top of the window provides most Package Manager functionality.</para>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
    64
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    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>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
    66
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    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>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
    68
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    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>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
    70
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    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>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
    72
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    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>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
    74
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    75
<listitem><para>Below the list of software categories is a list of searches that you have performed in this session.</para>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
    76
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    77
<listitem><para>Below the package list pane is the package details pane. See <xref linkend="package-version"/>.</para>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
    78
</listitem>
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
    79
</itemizedlist>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    80
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    81
</chapter>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    82
<chapter id="manage-pkg"><title>Managing Packages</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    83
<para>You can list packages according to various criteria. You can install, update, and remove packages.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    84
<sect1 id="list-pkg"><title>Listing Packages</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    86
<para>You can reorder the package list by clicking the column headings.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    88
<sect2 id="gkihe"><title>By Publisher</title>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    89
<para>The <guimenu>Publisher</guimenu> drop-down menu enables you to list packages according to publisher.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    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>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
    91
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
    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>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
    94
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    95
<listitem><para><guimenuitem>All Installed Packages</guimenuitem> — Shows all packages that are installed from all publishers.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    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>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
    97
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
    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>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
    99
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   100
<listitem><para><guimenuitem>Add...</guimenuitem> — Opens the Add Publisher window.</para>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   101
</listitem>
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   102
</itemizedlist>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   103
</sect2>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   104
<sect2 id="gkihp"><title>By Package Status</title>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   108
select <guimenuitem>All Packages</guimenuitem> from the <guimenu>View</guimenu> menu.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   109
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   112
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   115
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   118
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   119
<listitem><para><guimenuitem>Selected Packages</guimenuitem> — Lists all packages that are currently selected. See <xref linkend="select-pkg"/>.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   120
</listitem>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   121
</itemizedlist>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   122
</sect2>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   123
<sect2 id="gkigv"><title>By Category</title>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   126
</sect2>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   127
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   128
<sect1 id="search-pkg"><title>Searching for Packages</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   129
<para>Use one of the following two methods to search for packages:</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   131
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   132
<listitem><para>Use the Search field in the tool bar.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   133
</listitem>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   134
</itemizedlist>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   135
<sect2 id="gkjbd"><title>Enter a Search String</title>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   139
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
   141
</listitem>
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
   142
</itemizedlist>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   144
<variablelist><varlistentry><term><literal>AND</literal></term>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   147
</listitem>
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   148
</varlistentry>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   149
<varlistentry><term>Double quotation marks</term>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   150
<listitem><para>Enclose the search term in double quotation marks to match that search term exactly.</para>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   152
</listitem>
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   153
</varlistentry>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   154
<varlistentry><term>Wild card</term>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   155
<listitem><para>You can use the <literal>*</literal> wild card in your search string. Using wild cards can be slower.</para>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   156
<para>Example: <literal>802.11*</literal> matches <literal>802.11b/g</literal> and <literal>802.11a/b/g</literal>.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
   158
</listitem>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   159
</varlistentry>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   160
<varlistentry><term><literal>OR</literal></term>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   163
</listitem>
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   164
</varlistentry>
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   165
</variablelist>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   166
<para>You can combine these search string modifiers. You can use AND, OR, doublt quotation marks, and * all in one search string.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   167
</sect2>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   168
<sect2 id="gkjao"><title>Clear the Search Field</title>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   169
<para>To clear both the search string and the list of search results, use the Search field or the Edit menu.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   170
<itemizedlist><listitem><para>In the Search field, click the <literal>X</literal> icon.</para>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   171
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   172
<listitem><para>On the <guimenu>Edit</guimenu> menu, select the <guimenuitem>Clear Search</guimenuitem> option.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   173
</listitem>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   174
</itemizedlist>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   175
</sect2>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   176
<sect2 id="gkjbe"><title>Cancel the Search</title>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   178
</sect2>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   179
<sect2 id="gkjbb"><title>Redisplay Previous Search Results</title>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   183
<para>A search that matched no packages does not appear in the recent searches list.</para>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   185
</sect2>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   186
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   187
<sect1 id="package-version"><title>Showing More Information</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   188
<para>See more information about a package in the package details pane or on the Package Version Info dialog.</para>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   189
<sect2 id="gkiti"><title>Package Details Pane</title>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   193
<para>The package details pane is not displayed if the package list pane contains an informational message.</para>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   194
</sect2>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   195
<sect2 id="gkitc"><title>Package Version Info Dialog</title>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   196
<para>Click your right mouse button on a package in the package list to pop up the <guimenu>Package</guimenu> menu.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   198
</sect2>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   199
</sect1>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   200
<sect1 id="select-pkg"><title>Selecting Packages</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   202
<para>In the package list pane, do one of the following actions to select a package. You can select multiple packages.</para>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   203
<itemizedlist><listitem><para>Click the box to the left of the package name. Click the box again to deselect the package.</para>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   204
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   206
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   208
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   209
</itemizedlist>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   210
<para>The <guimenu>Edit</guimenu> menu has the following options for selecting packages:</para>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   211
<itemizedlist><listitem><para><guimenuitem>Select All</guimenuitem> — Selects all packages that are currently listed in the package list pane.</para>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   212
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   213
<listitem><para><guimenuitem>Select Updates</guimenuitem> — Selects all packages that are currently listed in the package list pane that have updates available.</para>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   214
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   215
<listitem><para><guimenuitem>Deselect All</guimenuitem> — Deselects all packages that are currently listed in the package list pane.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   216
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   217
</itemizedlist>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   218
<para>In all cases when you select a package, packages that were previously selected are still selected.</para>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   222
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   223
<sect1 id="install-pkg"><title>Installing and Updating Packages</title>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   225
<para>Perform the following steps to install or update a package:</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   226
<orderedlist><listitem><para>Select the package. See <xref linkend="select-pkg"/>.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   227
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   228
<listitem><para>Use one of the following methods to install or update the package:</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   229
<itemizedlist><listitem><para>Select the <guibutton>Install/Update</guibutton> button in the tool bar.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   230
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   231
<listitem><para>Select the <menuchoice><guimenu>Package</guimenu><guimenuitem>Install/Update</guimenuitem></menuchoice> option from the menu bar.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   232
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   233
<listitem><para>Click your right mouse button on the name of a package to display the pop-up <guimenu>Package</guimenu> menu. Then select the <guimenuitem>Install/Update</guimenuitem> option.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   234
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   235
<listitem><para>On the Versions tab in the package details pane below the package list pane, select a version from the Version to Install list and click the <guibutton>Install/Update</guibutton> button to the right of the list. The packages in the Version to Install list are available in the repository; they might not be installable. A particular version might not be compatible with other packages that you have installed. If the version that you select is not installable on your system, Package Manager warns you and does not install the package.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   236
</listitem>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   237
</itemizedlist>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   238
<para>If the package is already installed and does not have an update available (see the Status column or the <menuchoice><guimenu>Package</guimenu><guimenuitem>Package Version Info</guimenuitem></menuchoice> option), the <guibutton>Install/Update</guibutton> option is grayed out and not selectable.</para>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   239
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   240
<listitem><para>The Install/Update Confirmation window is displayed. Packages that are not yet installed are listed in the Install Details pane, and packages that are installed are listed in the Update Details pane for you to review. Select the <guibutton>Proceed</guibutton> button to install or update the listed packages.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   241
<para>In some cases a license dialog is displayed and you must accept the license to install the package.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   242
<para>If an error occurs during package installation, an error dialog is displayed. Messages explain why the install or update failed.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   243
</listitem>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   244
</orderedlist>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   245
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   246
<sect1 id="remove-pkg"><title>Removing Packages</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   247
<para>Perform the following steps to remove a package:</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   248
<orderedlist><listitem><para>Select the package. See <xref linkend="select-pkg"/>.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   249
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   250
<listitem><para>Use one of the following methods to remove the package:</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   251
<itemizedlist><listitem><para>Select the <guibutton>Remove</guibutton> button in the tool bar.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   252
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   253
<listitem><para>Select the <menuchoice><guimenu>Package</guimenu><guimenuitem>Remove</guimenuitem></menuchoice> option from the menu bar.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   254
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   255
<listitem><para>Click your right mouse button on the name of a package to display the pop-up <guimenu>Package</guimenu> menu. Then select the <guimenuitem>Remove</guimenuitem> option.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   256
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   257
</itemizedlist>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   258
<para>If the package is not installed, the Remove option is grayed out and not selectable.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   259
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   260
<listitem><para>The Remove Confirmation window is displayed. Packages to be removed are listed in the Remove Details pane for you to review. Select the <guibutton>Proceed</guibutton> button to remove the listed packages.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   261
<para>If a package cannot be removed because other packages depend on it, you can select the <guibutton>Remove Continue</guibutton> option to attempt to remove any remaining packages that you originally selected for removal.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   262
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   263
</orderedlist>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   264
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   265
</chapter>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   266
<chapter id="update_all"><title>Updating Your System</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   267
<para>When certain key packages such as some drivers and other kernel components are updated, the system performs the following actions:</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   268
<orderedlist><listitem><para>Creates a clone of the current boot environment (BE).</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   269
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   270
<listitem><para>Updates the packages in the clone, and does not update any packages in the current BE.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   271
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   272
<listitem><para>Sets the new BE to be the default boot choice the next time the system is rebooted. The current BE remains as an alternate boot choice.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   273
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   274
</orderedlist>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   275
<sect1 id="um_info"><title>Updating All Packages</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   276
<para>When you select the <guibutton>Updates</guibutton> button in the tool bar or the <menuchoice><guimenu>Package</guimenu><guimenuitem>Updates</guimenuitem></menuchoice> menu option, Package Manager updates all installed packages that have updates available.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   278
<para>The Updates window displays, and the update process starts:</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   279
<orderedlist><listitem><para>The system refreshes all catalogs.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   280
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   281
<listitem><para>The system evaluates all installed packages to determine which packages have updates available.</para>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   282
<itemizedlist><listitem><para>If no packages have updates available, the message “No Updates Available” is displayed and processing stops.</para>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   283
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   285
</listitem>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   286
</itemizedlist>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   287
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   288
<listitem><para>Click the <guibutton>Proceed</guibutton> button to continue with the update.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   289
<para>The system might create a new boot environment (BE), as described in <xref linkend="update_all"/> above, depending on which packages are being updated.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   290
<para>If the system determined that a new BE is required but was not able to create a new BE, an error message is displayed. If the problem is not enough disk space, perform the following steps:</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   291
<orderedlist><listitem><para>Click <guibutton>Close</guibutton> to cancel the Updates process.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   292
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   293
<listitem><para>Follow the instructions in <xref linkend="remove-be"/> to remove a BE that is no longer needed.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   294
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   295
<listitem><para>Select <guibutton>Updates</guibutton> again to restart the Updates process.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   296
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   297
</orderedlist>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   298
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   299
<listitem><para>The system downloads all package updates.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   300
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   301
<listitem><para>The system installs the package updates. If a cloned BE was created, the updates are installed in the clone. If no clone was created, the updates are installed in the current BE.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   302
<para>If an error occurs at any time during the update process, the Details panel is expanded and the details of the error are displayed. An error status indicator is shown next to the failed stage.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   303
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   304
<listitem><para>If the system created a new BE for the update, you can edit the default BE name. When you are satisfied with the BE name, click the <guibutton>Restart Now</guibutton> button to reboot your system immediately. Click the <guibutton>Restart Later</guibutton> button to restart your system at a later time. You must restart to boot into the new BE. The new BE will be your default boot choice. Your current BE will be available as an alternate boot choice.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   305
</listitem>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   306
</orderedlist>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   307
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   308
<sect1 id="using_um"><title>Using Update Manager</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   310
<sect2 id="gkiso"><title>Software Updates Notification</title>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   312
</sect2>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   313
<sect2 id="gkisz"><title>Desktop System Menu</title>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   315
</sect2>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   316
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   317
</chapter>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   318
<chapter id="manage-publisher"><title>Managing Publishers</title>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   321
<sect1 id="add-publisher"><title>Adding Publishers</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   323
<itemizedlist><listitem><para>Select the <guimenuitem>Add</guimenuitem> option from the <guimenu>Publisher</guimenu> drop-down menu.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   324
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   325
<listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Add Publisher</guimenuitem></menuchoice> menu option.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   326
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   328
</listitem>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   329
</itemizedlist>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   330
<para>In the Add Publisher window, perform the following steps to add an IPS package publisher:</para>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   332
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   333
<listitem><para>In the Alias field, you can enter an alternate name for this publisher.</para>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
   334
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   335
<listitem><para>Click the <guibutton>Add</guibutton> button.</para>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
   336
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   337
<listitem><para>The Adding Publisher dialog is displayed. Click <guibutton>Cancel</guibutton> to cancel the process. Click Details to view verbose information.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   338
<itemizedlist><listitem><para>If the new publisher is added successfully, the Adding Publisher Complete dialog is displayed and shows the new publisher name, alias, and URI.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   339
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   340
<listitem><para>If the new publisher is not added, the Publisher Error dialog is displayed with information about the problem.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   341
</listitem>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   342
</itemizedlist>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   343
</listitem>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   344
</orderedlist>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   345
<para>The new publisher is the last publisher listed in the Manage Publishers window and is enabled and sticky.</para>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   347
</sect1>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   348
<sect1 id="modify-publisher"><title>Modifying Publishers</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   352
<sect2 id="priority-stickiness"><title>Changing Priority and Stickiness</title>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   353
<para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to display the Manage Publishers window.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   354
<sect3 id="set-pub-order"><title>Publisher Priority</title>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   356
<itemizedlist><listitem><para>The publisher at the top of the list is also known as the preferred publisher.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   357
<listitem><para>The preferred publisher cannot be disabled or removed.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   360
</itemizedlist>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   361
<para>To change the priority of a publisher, perform the following steps:</para>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   362
<orderedlist><listitem><para>Click to highlight a publisher row in the list in the Manage Publishers window.</para>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
   363
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   366
<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   367
</listitem>
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   368
</orderedlist>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   369
</sect3>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   370
<sect3 id="gjlab"><title>Enabled and Sticky</title>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   374
<para>To change the Enabled and Sticky settings for a publisher, perform the following steps:</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   375
<orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   376
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   377
<listitem><para>Click an Enabled box or a Sticky box to toggle its setting.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   378
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   379
<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   380
</listitem>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   381
</orderedlist>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   382
</sect3>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   383
</sect2>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   384
<sect2 id="origin-mirror"><title>Changing Alias, Origins, and Mirrors</title>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   385
<orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   386
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   388
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   389
<listitem><para>Click the <guibutton>Modify</guibutton> button to the right of the publisher list to open the Modify Publisher window.</para>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   391
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   392
<listitem><para>Select the General tab to modify the publisher alias, add and remove origins, and add and remove mirrors.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   393
</orderedlist>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   394
<sect3 id="modify-publisher-alias"><title>Publisher Alias</title>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   396
<para>To change the alias of this publisher, perform the following steps:</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   397
<orderedlist><listitem><para>On the General tab of the Modify Publisher window, enter a new name in the Alias field.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   398
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   399
<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   400
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   402
</listitem>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   403
</orderedlist>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   404
</sect3>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   405
<sect3 id="gjkza"><title>Publisher Origins</title>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   407
<para>An origin value is the URI of an IPS package repository.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   408
<para>To change, add, or remove an origin for this publisher, perform the following steps:</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   409
<orderedlist><listitem><para>Select the General tab of the Modify Publisher window.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   410
<itemizedlist><listitem><para>Add an origin.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   412
<listitem><para>Click the <guibutton>Add</guibutton> button. The new URI is added to the list below the Origin field.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   413
</orderedlist>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   414
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   415
<listitem><para>Remove an origin.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   416
<orderedlist type="a"><listitem><para>In the list below the Origin field, select the URI you want to delete.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   418
</orderedlist>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   419
</listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   420
<listitem><para>Change an origin.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   421
<orderedlist type="a"><listitem><para>Add the new origin.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   422
<listitem><para>Delete the origin you want to change.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   423
</orderedlist>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   424
</listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   425
</itemizedlist>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   426
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   427
<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   428
</listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
   430
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   431
</orderedlist>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   432
</sect3>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   433
<sect3 id="gjkyr"><title>Publisher Mirrors</title>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   435
<para>To add, remove, or change a mirror for this publisher, perform the following steps:</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   436
<orderedlist><listitem><para>Select the General tab of the Modify Publisher window.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   437
<listitem><para>Click the Mirrors label to display the Mirror field and the list of mirrors.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   438
<itemizedlist><listitem><para>Add a mirror.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   440
<listitem><para>Click the <guibutton>Add</guibutton> button. The new URI is added to the list below the Mirror field.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   441
</orderedlist>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
   442
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   443
<listitem><para>Remove a mirror.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   444
<orderedlist type="a"><listitem><para>In the list below the Mirror field, select the URI you want to delete.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   445
<listitem><para>Click the <guibutton>Remove</guibutton> button. The selected URI is removed from the list.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   446
</orderedlist>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   447
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   448
<listitem><para>Change a mirror.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   449
<orderedlist type="a"><listitem><para>Delete the mirror you want to change.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   450
<listitem><para>Add a new mirror.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   451
</orderedlist>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   452
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   453
</itemizedlist>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   454
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   455
<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   456
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   457
<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   458
</listitem>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   459
</orderedlist>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   460
</sect3>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   461
</sect2>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   462
<sect2 id="security"><title>Managing Publisher Security</title>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   464
<orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   465
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   466
<listitem><para>Select the publisher whose security you want to modify.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   467
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   470
<listitem><para>Select the Certificates tab to manage certificates for this publisher.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   471
<listitem><para>Select the Signature Policy tab to manage signature policy for this publisher.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   472
</itemizedlist>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   473
</listitem>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   474
</orderedlist>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   475
<sect3 id="keys-certs"><title>Adding SSL Keys and Certificates</title>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   476
<para>If a publisher has a secure origin, add the SSL key and SSL certificate for the publisher.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   477
<orderedlist><listitem><para>Click the General tab of the Modify Publisher window.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   478
<listitem><para>Click the SSL Key and Certificate label to display the SSL Key field and the SSL Certificate field.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   481
<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   482
<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   483
</orderedlist>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   484
</sect3>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   485
<sect3 id="manage-certs"><title>Managing Certificates</title>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   486
<orderedlist><listitem><para>Click the Certificates tab of the Modify Publisher window.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
   490
</itemizedlist>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   491
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   493
<para>Click the headings of the list of certificates to resort the list. The Organization and Name columns are resizable.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   494
<itemizedlist><listitem><para><guibutton>Remove</guibutton>. Remove the certificate that is currently selected in the certificates list.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   497
</itemizedlist>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   498
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   499
<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   500
<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   501
</orderedlist>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   502
</sect3>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   503
<sect3 id="pub-sig-policy"><title>Managing Signature Policy</title>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   504
<orderedlist><listitem><para>Click the Signature Policy tab of the Modify Publisher window.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   506
<para>To set the global signature policy, use the Signature Policy tab of the Preferences window (see <xref linkend="img-sig-policy"/>).</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   507
<itemizedlist><listitem><para>Signatures are ignored: Ignore signatures for all packages.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   509
<listitem><para>One or more valid signatures are required: Require that all newly installed packages have at least one valid signature.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   511
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   512
<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Modify Publisher window.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   513
<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para></listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   514
</orderedlist>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   515
</sect3>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   516
</sect2>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   517
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   518
<sect1 id="remove-publisher"><title>Removing Publishers</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   519
<para>Perform the following steps to remove a publisher:</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   520
<orderedlist><listitem><para>Select the <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> menu option to open the Manage Publishers window.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   521
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   522
<listitem><para>Select the publisher that you want to remove.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   523
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   524
<listitem><para>Click the <guibutton>Remove</guibutton> button to the right of the publisher list.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   526
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   527
<listitem><para>Click the <guibutton>OK</guibutton> button at the bottom of the Manage Publishers window.</para>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
   528
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   529
</orderedlist>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   530
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   531
</chapter>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   532
<chapter id="manage-be"><title>Managing Boot Environments</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   536
<sect1 id="create-be"><title>Creating a BE</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   537
<para>A new BE is automatically created when you do one of the following actions:</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   538
<itemizedlist><listitem><para>Install the Oracle Solaris OS.</para>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
   539
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   540
<listitem><para>Install or update particular key system packages such as some drivers and other kernel components.</para>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   541
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   542
<listitem><para>Use the <literal>beadm create</literal> command.</para>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
   543
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   544
</itemizedlist>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   546
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   547
<sect1 id="activate-be"><title>Activating a BE</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   549
<para>To specify a different BE to be the default active BE after the next reboot, perform the following steps:</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   551
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   552
<listitem><para>Select the <guibutton>OK</guibutton> button in the Manage Boot Environments window.</para>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   553
</listitem>
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   554
</orderedlist>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   555
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   556
<sect1 id="rename-be"><title>Renaming a BE</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   558
<para>You cannot rename the currently active BE.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   559
<para>You cannot rename a BE that you have marked for deletion.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   560
<para>To rename a BE, perform the following steps:</para>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   561
<orderedlist><listitem><para>Double-click the name of the BE that you want to rename. The name field becomes editable.</para>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   562
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   563
<listitem><para>Enter the new name.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   564
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   565
<listitem><para>Select the <guibutton>OK</guibutton> button in the Manage Boot Environments window.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   566
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   567
</orderedlist>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   568
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   569
<sect1 id="remove-be"><title>Removing a BE</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   570
<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 right-most column in the window is the Delete column.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   571
<para>The middle column in the Manage Boot Environments window shows the size of the BE. You might want to remove a BE to free some space on your storage device.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   572
<para>You cannot delete the currently active BE.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   573
<para>You cannot delete a BE that you have renamed.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   574
<para>To delete a BE, perform the following steps:</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   575
<orderedlist><listitem><para>Select the <guibutton>Delete</guibutton> box for the BE that you want to delete.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   576
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   577
<listitem><para>Select the <guibutton>OK</guibutton> button in the Manage Boot Environments window.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   578
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   579
</orderedlist>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
   580
</sect1>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   581
</chapter>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   582
<chapter id="webinstall"><title>Working With WebInstall</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   583
<para>Package Manager supports installing packages using a simple one-click WebInstall process. The WebInstall process uses a <filename>.p5i</filename> file. A <filename>.p5i</filename> file contains information to add publishers and add packages that can be installed from these publishers. The information in the <filename>.p5i</filename> file is read and used by the WebInstall process.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   584
<sect1 id="webinstall-export"><title>Exporting Files Using WebInstall</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   585
<para>If you want other users to be able to install packages that you have installed on your system, you can export the installation instructions for those package files using the WebInstall process. A <filename>.p5i</filename> file consisting of installation instructions for those packages and publishers to be installed is created.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   586
<para>To export the installation instructions for your selected packages and their publishers to a <filename>.p5i</filename> file, perform the following steps:</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   587
<orderedlist><listitem><para>From the <guimenu>Publisher</guimenu> drop-down menu, select the publisher from which you want to include the packages in the <filename>.p5i</filename> file.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   588
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   589
<listitem><para>In the package list pane, select the package whose installation instructions you want to distribute.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   590
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   591
<listitem><para>Click <menuchoice><guisubmenu>File</guisubmenu><guimenuitem>Export Selections</guimenuitem></menuchoice> to display the Export Selections Confirmation window.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   592
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   593
<listitem><para>Click the <guibutton>OK</guibutton> button to confirm the selections. The Export Selections window is displayed.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   594
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   595
<listitem><para>A default name for the <filename>p5i</filename> file with the extension <filename>.p5i</filename> is provided. You can change this file name, but do not change the extension.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   596
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   597
<listitem><para>A default location for the <filename>p5i</filename> file is provided. You can change the location. If you use the <guibutton>Browse</guibutton> button, you can select the <filename>p5i Files</filename> option from the drop-down menu at the bottom right hand side of the Export Selections window to display only <filename>.p5i</filename> files in the file list.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   598
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   599
<listitem><para>Click the <guibutton>Save</guibutton> button to save the file name and location.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   600
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   601
</orderedlist>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   602
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   603
<sect1 id="webinstall-add"><title>Using WebInstall to Add Publishers and Install Packages</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   604
<para>The WebInstall process enables you to install packages through a <filename>p5i</filename> file.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   605
<orderedlist><listitem><para>Locate the <filename>.p5i</filename> file. This file might be on your desktop or on a web site.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   606
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   607
<listitem><para>Use one of the following methods to start Package Manager in WebInstall mode:</para>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   608
<itemizedlist><listitem><para>Click on a <filename>.p5i</filename> file on your desktop. The associated application (Package Manager Web Installer) is launched.</para>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   609
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   611
<screen># <userinput>packagemanager/<replaceable>path_to_p5i_file/file.p5i</replaceable></userinput></screen>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   612
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   615
</listitem>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   616
</itemizedlist>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   617
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   622
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   624
</listitem>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   625
</itemizedlist>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   626
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   627
<listitem><para>The Install/Update window now looks the same as when you select <guibutton>Install/Update</guibutton> from within Package Manager.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   628
</listitem>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   629
</orderedlist>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   630
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   631
</chapter>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   632
<chapter id="gkioy"><title>Troubleshooting</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   633
<para>Error, warning, and informational messages are saved to a log so that you can review them at any time.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   634
<sect1 id="gkiod"><title>Viewing Message Logs</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   636
<para>Select the <guibutton>Clear</guibutton> button at the bottom of the Logs window to delete all the messages.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
   638
</sect1>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   639
</chapter>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   640
<chapter id="pkg-mgr-prefs"><title>Setting Preferences</title>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   642
<para>The Preferences window has three tabs:</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   643
<itemizedlist><listitem><para>The General tab enables you to set exit preferences and confirmation dialog preferences.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   645
<listitem><para>The Signature Policy tab enables you to set signature policy for this image.</para></listitem>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   646
</itemizedlist>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   647
<sect1 id="gjktu"><title>Exit Preferences</title>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   648
<para>Select the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> option and select the General tab.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   650
<itemizedlist><listitem><para><emphasis role="strong">Vertical and horizontal separators</emphasis> — Widths and heights of the panes in the window</para>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   651
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   652
<listitem><para><emphasis role="strong">Window size</emphasis> — Overall size of the Package Manager window</para>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   653
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   655
</listitem>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   656
<listitem><para><emphasis role="strong">Categories</emphasis> — The selected category and the expanded and collapsed categories for each publisher</para>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   657
</listitem>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   658
</itemizedlist>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   659
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   660
<sect1 id="gjkug"><title>Confirmation Dialog Preferences</title>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   661
<para>Select the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> option and select the General tab.</para>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   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>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   664
</sect1>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   665
<sect1 id="img-sig-policy"><title>Signature Policy Preferences</title>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   668
</sect1>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   669
<sect1 id="languages"><title>Optional Component Preferences Language Choices</title>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   670
<para>Select the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> option and select the Optional Components tab.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   675
</sect1>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   676
<sect1 id="dev-doc"><title>Other Optional Component Preferences</title>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   677
<para>Select the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> option and select the Optional Components tab.</para>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   680
</sect1>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   681
</chapter>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   682
<glossary id="glossary"><title>Glossary</title>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   683
<glossentry><glossterm>alias</glossterm>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   684
<glossdef><para>Another name for a publisher.</para>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   685
</glossdef>
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   686
</glossentry>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   687
<glossentry><glossterm>boot environment (BE)</glossterm>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   688
<glossdef><para>An instance of a bootable Oracle Solaris environment. The root file system and all other file systems of the boot environment that contain system software are required to be ZFS datasets.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   689
<para>The active boot environment is the one that is currently booted. A system can have many boot environments. You can select the one you want to boot into when you reboot.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   690
</glossdef>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   691
</glossentry>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   692
<glossentry><glossterm>clone</glossterm>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   693
<glossdef><para>An exact copy.</para>
1029
37317ca76af3 7745 PM Help requires changes first revision
Padraig O'Briain <padraig.obriain@sun.com>
parents: 985
diff changeset
   694
<para>A clone could be an exact copy of an operating system, a file system, or a volume. This copy has 100% compatibility with the original.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   695
</glossdef>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   696
</glossentry>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   697
<glossentry><glossterm>dataset</glossterm>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   698
<glossdef><para>A generic name for the following ZFS entities: clones, file systems, snapshots, or volumes. Each dataset is identified by a unique name in the ZFS namespace.</para>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   699
</glossdef>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   700
</glossentry>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   701
<glossentry><glossterm>image</glossterm>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   702
<glossdef><para>A collection of operating system software in a package that can be booted and installed.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   703
<para>A location on your system where packages and their associated files, directories, links, and dependencies can be installed.</para>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   704
</glossdef>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   705
</glossentry>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   706
<glossentry><glossterm>origin</glossterm>
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   707
<glossdef><para>A package server to which a publisher publishes packages.</para>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   708
</glossdef>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   709
</glossentry>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   710
<glossentry><glossterm>package</glossterm>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   711
<glossdef><para>A collection of files, directories, links, drivers, and dependencies in a defined format.</para>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   712
</glossdef>
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   713
</glossentry>
2094
dbf4ce9ada97 14027 Some features of Package Manager not documented
John Rice <john.rice@oracle.com>
parents: 1640
diff changeset
   714
<glossentry><glossterm>publisher</glossterm>
2546
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   716
</glossdef>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   717
</glossentry>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   718
<glossentry><glossterm>system publisher</glossterm>
2b1fa6a54b5e Apply Shawn Walker's backport - breaking some branding
Jon Tibble <meths@btinternet.com>
parents: 2094
diff changeset
   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>
1640
9b768674beee 13700 Package Manager Help needs to be updated
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1587
diff changeset
   720
</glossdef>
9b768674beee 13700 Package Manager Help needs to be updated
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1587
diff changeset
   721
</glossentry>
985
bcc30bb98888 5432 Package Manager does not keep window settings
John Rice <john.rice@sun.com>
parents: 859
diff changeset
   722
</glossary>
1587
e46d4e51d02f 11243 PM Help needs update with new Help tags
Padraig O'Briain <padraig.obriain@sun.com>
parents: 1074
diff changeset
   723
</book>