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

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

<book id="pkgmgr" label="fcs" lang="en"><title>OpenSolaris 2010.03 Package Manager Online Help</title>

<bookinfo><authorgroup><author><firstname>OpenSolaris</firstname>

<surname>Publications</surname>

</author>

</authorgroup>

<pubsnumber>822-7173</pubsnumber>

<releaseinfo></releaseinfo>

<pubdate>June 2009</pubdate>

<publisher><publishername>Sun Microsystems</publishername>

</publisher>

<copyright><year>2009</year>

</copyright>

<legalnotice><para>Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more U.S. patents or pending patent applications in the U.S. and in other countries.</para>

<para>U.S. Government Rights &#8211; Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements.</para>

<para>This distribution may include materials developed by third parties.</para>

<para>Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd.</para>

<para>Sun, Sun Microsystems, the Sun logo, the Solaris logo, the Java Coffee Cup logo, docs.sun.com,  Java, and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. or its subsidiaries in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other countries. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc. </para>

<para>The OPEN LOOK and <trademark>Sun</trademark> Graphical User Interface was developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Sun's licensees who implement OPEN LOOK GUIs and otherwise comply with Sun's written license agreements.</para>

<para>Products covered by and information contained in this publication are controlled by U.S. Export Control laws and may be subject to the export or import laws in other countries. Nuclear, missile, chemical or biological weapons or nuclear maritime end uses or end users, whether direct or indirect, are strictly prohibited. Export or reexport to countries subject to U.S. embargo or to entities identified on U.S. export exclusion lists, including, but not limited to, the denied persons and specially designated nationals lists is strictly prohibited.</para>

<para>DOCUMENTATION IS PROVIDED &#8220;AS IS&#8221; AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.</para>

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

<para>Sun Microsystems, Inc. d&#233;tient les droits de propri&#233;t&#233; intellectuelle relatifs &#224; la technologie incorpor&#233;e dans le produit qui est d&#233;crit dans ce document. En particulier, et ce sans limitation, ces droits de propri&#233;t&#233; intellectuelle peuvent inclure un ou plusieurs brevets am&#233;ricains ou des applications de brevet en attente aux Etats-Unis et dans d'autres pays.</para>

<para>Cette distribution peut comprendre des composants d&#233;velopp&#233;s par des tierces personnes.</para>

<para>Certaines composants de ce produit peuvent &#234;tre d&#233;riv&#233;es du logiciel Berkeley BSD, licenci&#233;s par l'Universit&#233; de Californie. UNIX est une marque d&#233;pos&#233;e aux Etats-Unis et dans d'autres pays; elle est licenci&#233;e exclusivement par X/Open Company, Ltd. </para>

<para>Sun, Sun Microsystems, le logo Sun, le logo Solaris, le logo Java Coffee Cup, docs.sun.com,  Java et Solaris sont des marques de fabrique ou des marques d&#233;pos&#233;es de Sun Microsystems, Inc., ou ses filiales, aux Etats-Unis et dans d'autres pays. Toutes les marques SPARC sont utilis&#233;es sous licence et sont des marques de fabrique ou des marques d&#233;pos&#233;es de SPARC International, Inc. aux Etats-Unis et dans d'autres pays. Les produits portant les marques SPARC sont bas&#233;s sur une architecture d&#233;velopp&#233;e par Sun Microsystems, Inc. </para>

<para>L'interface d'utilisation graphique OPEN LOOK et Sun a &#233;t&#233; d&#233;velopp&#233;e par Sun Microsystems, Inc. pour ses utilisateurs et licenci&#233;s. Sun reconna&#238;t les efforts de pionniers de Xerox pour la recherche et le d&#233;veloppement du concept des interfaces d'utilisation visuelle ou graphique pour l'industrie de l'informatique. Sun d&#233;tient une licence non exclusive de Xerox sur l'interface d'utilisation graphique Xerox, cette licence couvrant &#233;galement les licenci&#233;s de Sun qui mettent en place l'interface d'utilisation graphique OPEN LOOK et qui, en outre, se conforment aux licences &#233;crites de Sun.</para>

<para>Les produits qui font l'objet de cette publication et les informations qu'il contient sont r&#233;gis par la legislation am&#233;ricaine en mati&#232;re de contr&#244;le des exportations et peuvent &#234;tre soumis au droit d'autres pays dans le domaine des exportations et importations. Les utilisations finales, ou utilisateurs finaux, pour des armes nucl&#233;aires, des missiles, des armes chimiques ou biologiques ou pour le nucl&#233;aire maritime, directement ou indirectement, sont strictement interdites. Les exportations ou r&#233;exportations vers des pays sous embargo des Etats-Unis, ou vers des entit&#233;s figurant sur les listes d'exclusion d'exportation am&#233;ricaines, y compris, mais de mani&#232;re non exclusive, la liste de personnes qui font objet d'un ordre de ne pas participer, d'une fa&#231;on directe ou indirecte, aux exportations des produits ou des services qui sont r&#233;gis par la legislation am&#233;ricaine en mati&#232;re de contr&#244;le des exportations et la liste de ressortissants sp&#233;cifiquement design&#233;s, sont rigoureusement interdites.</para>

<para>LA DOCUMENTATION EST FOURNIE "EN L'ETAT" ET TOUTES AUTRES CONDITIONS, DECLARATIONS ET GARANTIES EXPRESSES OU TACITES SONT FORMELLEMENT EXCLUES, DANS LA MESURE AUTORISEE PAR LA LOI APPLICABLE, Y COMPRIS NOTAMMENT TOUTE GARANTIE IMPLICITE RELATIVE A LA QUALITE MARCHANDE, A L'APTITUDE A UNE UTILISATION PARTICULIERE OU A L'ABSENCE DE CONTREFACON. </para>

</legalnotice>

</bookinfo>

<chapter><title>About the Package Manager</title>

<para>Welcome to the <trademark>OpenSolaris</trademark> 2010.03 Package Manager online help!</para>

<para>Use the help contents to learn how to use the Package Manager. Navigate through this help by clicking the topics displayed in the sidebar.</para>

<para>The OpenSolaris 2010.03 Package Manager application is a graphical user interface for the Image Packaging System (IPS) software. The Package Manager provides a subset of the functionality offered by the command-line (CLI) clients provided with IPS.</para>

<figure id="gjldi"><title>Package Manager</title>

<mediaobject><imageobject><imagedata fileref="figures/pkgmgr-main.png" /></imageobject>

</mediaobject>

</figure>

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

<itemizedlist><listitem><para>Install, remove, and search for packages</para>

</listitem>

<listitem><para>Update your system</para>

</listitem>

<listitem><para>Add and manage publishers</para>

</listitem>

<listitem><para>Create, remove, and manage boot environments</para>

</listitem>

</itemizedlist>

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

</note>

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

<para>After an initial installation of the OpenSolaris 2010.03 operating system, you will find that some of the software applications that you use on a regular basis are not immediately available to you. These software applications are available as packages in a repository for downloading and installing over the network. A repository is a source for packages.</para>

<para>Once you have installed packages, IPS enables you to search, update, and manage packages on your system.</para>

<para>With IPS , you can upgrade your system to a newer build of OpenSolaris, install and update your software to the latest available versions in a repository, and retrieve packages from mirror repositories. </para>

<note><para><emphasis role="strong">The Package Manager provides a subset of the tasks that can be performed from the command-line.</emphasis></para>

</note>

<para>For more IPS documentation, see the <ulink url="http://docs.sun.com/source/820-7679/index.html"><citetitle>Image Packaging System Guide</citetitle></ulink> and the <filename>pkg</filename> <ulink url="http://opensolaris.org/sc/src/pkg/gate/src/man/">man pages</ulink>.</para>

<para>For more information about IPS, visit the <ulink url="http://opensolaris.org/os/project/pkg">project page</ulink>.</para>

</sect1>

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

<para>When you start the Package Manager, a Start Page similar to the example below is displayed:</para>

<figure id="gijpx"><title>Package Manager Start Page</title>

<mediaobject><imageobject><imagedata fileref="figures/startpage_new.png" /></imageobject>

</mediaobject>

</figure>

<para>The Start Page provides a list of featured packages that can be installed. It includes a list of some of the most popular and recent packages downloaded by the OpenSolaris community of users. The Recommended list of packages point to software applications that are frequently downloaded by the OpenSolaris user. Click the package links to install the packages.</para>

<para>The Start Page also provides links to more information about the OpenSolaris project, subscribe to newsletters and join the OpenSolaris community.</para>

<para>To close the Start Page and see the list of packages in the selected publisher, perform any of the following actions in the main window of the Package Manager:</para>

<itemizedlist><listitem><para>Select a package category</para>

</listitem>

<listitem><para>Change the <emphasis role="strong">View</emphasis> drop-down menu</para>

</listitem>

<listitem><para>Perform a search</para>

</listitem>

<listitem><para>Change the publisher</para>

</listitem>

</itemizedlist>

<para>Select <menuchoice><guimenu>View</guimenu><guimenuitem>Start Page</guimenuitem></menuchoice> to return to the Start Page at anytime.</para>

<note><para>See <xref linkend="edit-prefs"/> to turn off the <emphasis role="strong">initial display</emphasis> of the start page when the Package Manager starts.</para>

</note>

<sect2 id="gjlbj"><title>About The Package Manager Window</title>

<figure id="gilgx"><title>Package Manager Main View</title>

<mediaobject><imageobject><imagedata fileref="figures/pkgmgr-main.png" /></imageobject>

</mediaobject>

</figure>

<para>The main window of the Package Manager consists of the following elements :</para>

<variablelist><varlistentry><term><emphasis role="strong">Menubar</emphasis></term>

<listitem><para>The menubar contains the menus and sub-menus required to perform all of the commands related to the Package Manager.</para>

<para></para>

</listitem>

</varlistentry>

<varlistentry><term><emphasis role="strong">Toolbar</emphasis></term>

<listitem><para>The toolbar contains the icons for a subset of the commands that can be performed by using the menus on the menubar. A <emphasis role="strong">Search</emphasis> field is also located on the toolbar. You can perform the following actions from the toolbar :</para>

<itemizedlist><listitem><para><emphasis role="strong">Updates</emphasis> &#8211; Click <emphasis role="strong">Updates</emphasis> to check for and install the latest updates.</para>

</listitem>

<listitem><para><emphasis role="strong">Install/Update</emphasis> &#8211; Select a package and click <emphasis role="strong">Install/Update</emphasis> to install or update a package.</para>

</listitem>

<listitem><para><emphasis role="strong">Refresh</emphasis> &#8211; Click <emphasis role="strong">Refresh</emphasis> to reload the list of packages.</para>

</listitem>

<listitem><para><emphasis role="strong">Remove</emphasis> &#8211; Select a package and click <emphasis role="strong">Remove</emphasis> to remove a package.</para>

</listitem>

<listitem><para><emphasis role="strong">Search for a Package</emphasis> &#8211; Type the name or description of a package in the <emphasis role="strong">Search</emphasis> field to search for a package. See the <xref linkend="search-pkg"/> section for examples on how to search for a package.</para>

</listitem>

</itemizedlist>

</listitem>

</varlistentry>

<varlistentry><term><emphasis role="strong">Publisher Drop-Down Menu</emphasis></term>

<listitem><para>The list of available publishers is shown in the <emphasis role="strong">Publisher</emphasis> drop-down menu. Users can perform the following tasks from the publisher drop-down menu :</para>

<itemizedlist><listitem><para><emphasis role="strong">Select a publisher</emphasis></para>

</listitem>

<listitem><para><emphasis role="strong">View the list of packages installed from all publishers</emphasis></para>

</listitem>

<listitem><para><emphasis role="strong">Search for package across all publishers</emphasis></para>

</listitem>

<listitem><para><emphasis role="strong">Add a publisher</emphasis></para>

</listitem>

</itemizedlist>

</listitem>

</varlistentry>

<varlistentry><term><emphasis role="strong">List of Packages by Category</emphasis></term>

<listitem><para>You can browse the available packages by category in the left hand side panel. Click on a category to see the sub-categories of packages available. There are six main categories that are displayed in the Package Manager:</para>

<itemizedlist><listitem><para><emphasis role="strong">Applications</emphasis></para>

</listitem>

<listitem><para><emphasis role="strong">Desktop (GNOME)</emphasis></para>

</listitem>

<listitem><para><emphasis role="strong">Development</emphasis></para>

</listitem>

<listitem><para><emphasis role="strong">Drivers</emphasis></para>

</listitem>

<listitem><para><emphasis role="strong">System</emphasis></para>

</listitem>

<listitem><para><emphasis role="strong">Web Services</emphasis></para>

</listitem>

</itemizedlist>

</listitem>

</varlistentry>

<varlistentry><term><emphasis role="strong">Recent Searches</emphasis></term>

<listitem><para>The Package Manager saves your recent package searches. Click the Recent Searches in the left hand side panel to view the packages you searched for recently.</para>

</listitem>

</varlistentry>

<varlistentry><term><emphasis role="strong">List of Packages by Status</emphasis></term>

<listitem><para>The <emphasis role="strong">View</emphasis> drop-down menu enables you to view package status with the following options :</para>

<itemizedlist><listitem><para><emphasis role="strong">All Packages</emphasis> &#8211; Shows the list of all packages available within the current publisher.</para>

</listitem>

<listitem><para><emphasis role="strong">Installed Packages</emphasis> &#8211; Shows the list of packages installed within the current publisher on your system.</para>

</listitem>

<listitem><para><emphasis role="strong">Updates</emphasis> &#8212; Shows the list of packages that have newer versions available within the current publisher.</para>

</listitem>

<listitem><para><emphasis role="strong">Not Installed Packages</emphasis> &#8211; Shows the list of packages that are not installed, but are available in the currently selected publisher.</para>

</listitem>

<listitem><para><emphasis role="strong">Selected Packages</emphasis> &#8211; Shows the list of packages that you have selected.</para>

</listitem>

</itemizedlist>

</listitem>

</varlistentry>

<varlistentry><term><emphasis role="strong">Package Name, Status, and Description</emphasis></term>

<listitem><para>The list of packages in the selected category, a brief description, and their status are displayed in here.</para>

<para>The Publisher name is also displayed here in the following instances : </para>

<itemizedlist><listitem><para>When the <emphasis role="strong">Pubisher</emphasis> drop-down menu is set to All Publishers (Installed)</para>

</listitem>

<listitem><para>When search results are displayed for the All Publishers (Search) option</para>

</listitem>

<listitem><para>When a recent search result is displayed</para>

</listitem>

</itemizedlist>

</listitem>

</varlistentry>

<varlistentry><term><emphasis role="strong">Package Details</emphasis></term>

<listitem><para>Click a package name to select it. Details of the selected package, such as name, version, file dependencies, and license are displayed in this window.</para>

</listitem>

</varlistentry>

</variablelist>

</sect2>

</sect1>

<sect1 id="pkg-mgr-prefs"><title>Package Manager Settings</title>

<para>Use the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> to change the Package Manager settings. The following sections discuss the preferences that can be changed by the user.</para>

<sect2 id="edit-prefs"><title>Start Page Preferences</title>

<para>A Start Page is displayed in the main window of the Package Manager when the application is started. The Start Page provides links to <ulink url="http://opensolaris.com">opensolaris.com</ulink> page where you can get more information about OpenSolaris, subscribe to newsletters and join the OpenSolaris community.</para>

<para>You can choose to turn off this setting so this page is not displayed when Package Manager starts.</para>

<para>Select <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> from the main menu and uncheck the <emphasis role="strong">Show Start Page on Startup</emphasis> to disable the Start Page. This dialog is checked by default.</para>

<para>Select <menuchoice><guimenu>View</guimenu><guimenuitem>Start Page</guimenuitem></menuchoice> from the main menu to go to the Start Page at anytime.</para>

</sect2>

<sect2 id="gjktu"><title>Exit Preferences</title>

<para>The Package Manager application can remember some of its current settings if the <emphasis role="strong">Remember current state on exit</emphasis> option in the <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> is checked.</para>

<para>The following settings are saved:</para>

<itemizedlist><listitem><para><emphasis role="strong">Vertical separators</emphasis> &#8211; The size of the columns in the main window the Package Manager</para>

</listitem>

<listitem><para><emphasis role="strong">Window size</emphasis> &#8211; The size of the Package Manager window</para>

</listitem>

<listitem><para><emphasis role="strong">Current publisher</emphasis> &#8211; The publisher that is selected when the Package Manager is closed</para>

</listitem>

</itemizedlist>

</sect2>

<sect2 id="gjkug"><title>Confirmation Dialog Preferences</title>

<para>When a package is selected for installation, update, or removal, a confirmation dialog is displayed that displays the list of packages and the action to be performed. Under the <emphasis role="strong">Show Confirmation Dialog</emphasis> uncheck <emphasis role="strong">On Updates</emphasis>, <emphasis role="strong">On Package Install/Update</emphasis>, and <emphasis role="strong">On Package Remove</emphasis> to turn these settings off.</para>

</sect2>

</sect1>

<sect1><title>Working With Packages</title>

<sect2 id="install-pkg"><title>Install a Package</title>

<para>The list of packages and their status is displayed in the main window of the Package Manager. Perform the following steps to install a package:</para>

<orderedlist><listitem><para>Check the box next to the package or packages to select it. Double-clicking the package also selects the package.</para>

</listitem>

<listitem><para>Click <guibutton>Install/Update</guibutton> to start the package installation process.</para>

<para>You can also choose <menuchoice><guimenu>Package</guimenu><guimenuitem>Install/Update</guimenuitem></menuchoice> to start the package installation process.</para>

</listitem>

<listitem><para>Click <guilabel>Details</guilabel> to view the installation details or <guibutton>Cancel</guibutton> to cancel the package installation.</para>

</listitem>

<listitem><para>After the installation has completed, click <guibutton>Close</guibutton>.</para>

</listitem>

</orderedlist>

<subtopic id="gilxb"><title>Installation Error</title>

<para>If an error occurs during package installation, an error dialog with the error message is displayed along with the reason for failure. Click <guibutton>Close</guibutton> to close the error dialog.</para>

</subtopic>

</sect2>

<sect2 id="remove-pkg"><title>Remove a Package</title>

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

<orderedlist><listitem><para>Check the box next to a package to select it. Double-clicking the package also selects the package.</para>

</listitem>

<listitem><para>Click <guibutton>Remove</guibutton> to start the package uninstallation process.</para>

<para>You can also choose <menuchoice><guimenu>Package</guimenu><guimenuitem>Remove</guimenuitem></menuchoice> to remove a package.</para>

</listitem>

<listitem><para>Review the packages to be removed and the package dependencies details in the <emphasis role="strong">Remove Confirmation</emphasis> dialog.</para>

</listitem>

<listitem><para>Click <guibutton>Proceed</guibutton> to start removing the packages or <guibutton>Cancel</guibutton> to cancel the process. </para>

</listitem>

</orderedlist>

</sect2>

<sect2 id="search-pkg"><title>Search for a Package</title>

<para>You can search for a package in the following ways :</para>

<itemizedlist><listitem><para><emphasis role="strong">Search the current publisher</emphasis> &#8211; Search for a package in the publisher currently selected in the <emphasis role="strong"> Publisher</emphasis> drop-down menu. If you do not know the status of the package you are searching for, set the <emphasis role="strong">View</emphasis> drop-down menu to <emphasis role="strong">All Packages</emphasis>.</para>

<para>Enter a description, or a partial name in the <emphasis role="strong">Search</emphasis> field. For example, you might type one of the following search terms to search for <filename>SUNWgnome-games</filename> :</para>

<itemizedlist><listitem><para>SUNWgames</para>

</listitem>

<listitem><para>games</para>

</listitem>

<listitem><para>GNOME-games</para>

</listitem>

</itemizedlist>

<para>To search for SunStudio compilers, you might type one of the following terms:</para>

<itemizedlist><listitem><para>compiler</para>

</listitem>

<listitem><para>tools</para>

</listitem>

</itemizedlist>

</listitem>

<listitem><para><emphasis role="strong">Search all publishers</emphasis> &#8211; Choose <emphasis role="strong">All Publishers(Search)</emphasis> from the <emphasis role="strong">Publisher</emphasis> drop-down menu to search for a package across all configured publishers. If you do not know the status of the package you are searching for, set the <emphasis role="strong">View</emphasis> drop-down menu to <emphasis role="strong">All Packages</emphasis>.</para>

<para>Type a description of the package in the <emphasis role="strong">Search</emphasis> field. For example, the <filename>SUNWdiveintopython</filename> package is a book on Python programming. The description of the package contains the string <emphasis>book</emphasis>. To search for this package, you might then type one of the following terms:</para>

<itemizedlist><listitem><para>python</para>

</listitem>

<listitem><para>book</para>

</listitem>

</itemizedlist>

<note><para>If you searched for the term <emphasis>diveinto</emphasis> when searching for the <filename>SUNWdiveintopython</filename> package, the results will not be displayed as the term <emphasis>diveinto</emphasis> is not present as an independent, complete word in the package contents. However you will find the package using the <literal>*</literal> wild card. Hence, searching for the term <literal>diveinto*</literal> will display the <filename>SUNWdiveintopython</filename> package.</para>

</note>

</listitem>

</itemizedlist>

<tip><para>Use the submenus under the <menuchoice><guimenu>Edit</guimenu></menuchoice> menu to cut, copy, or paste text in the <emphasis role="strong">Search</emphasis> field.</para>

</tip>

<para>The following operators are supported for a package search:</para>

<variablelist><varlistentry><term><emphasis role="strong">The AND operator</emphasis></term>

<listitem><para> When the search term is separated by spaces or the AND operator, the Package Manager will search for packages containing <emphasis role="strong">all</emphasis> the search terms.</para>

</listitem>

</varlistentry>

<varlistentry><term><emphasis role="strong">Double Quotes</emphasis></term>

<listitem><para>When a search term is placed within double quotes, the Package Manager will search for packages that <emphasis role="strong">match the search term exactly</emphasis>.</para>

</listitem>

</varlistentry>

<varlistentry><term><emphasis role="strong">Wildcard *</emphasis></term>

<listitem><para>Including a wildcard in your search term enables you to search for partial package names. For example, when you enter <emphasis>boo*</emphasis> in your search term, the packages displayed could include <emphasis>boot</emphasis> and <emphasis>book</emphasis> in the package name and description.</para>

<note><para>Wildcard searching can be slower than an exact match search or a search based on package description.</para>

</note>

</listitem>

</varlistentry>

<varlistentry><term><emphasis role="strong">The OR operator</emphasis></term>

<listitem><para>When a search term is separated by the OR operator, the Package Manager searches for packages that contain any of the search terms.</para>

</listitem>

</varlistentry>

</variablelist>

</sect2>

<sect2 id="gjmtb"><title>Cancel Package Search</title>

<para>If you want to cancel a search, use the Cancel Search icon at the bottom of the main window of the Package Manager. This icon is visible on the status bar only during a search operation.</para>

</sect2>

<sect2 id="update-pkg"><title>Update a Package</title>

<para>Look for the Updates icon next to the installed package name. This icon indicates that updates are available for the package in the currently selected publisher. You can also choose one of the following views to display a list of packages that have updates available :</para>

<itemizedlist><listitem><para>Select the <menuchoice><guimenuitem>Updates</guimenuitem></menuchoice> option in the <emphasis role="strong">View</emphasis> drop-down menu to list all packages that have updates available in the currently selected publisher.</para>

</listitem>

<listitem><para>Select the <menuchoice><guimenuitem>Updates</guimenuitem></menuchoice> option in the <emphasis role="strong">View</emphasis> drop-down menu and the <emphasis role="strong">All Publishers (Installed)</emphasis> in the <emphasis role="strong">Publisher</emphasis> drop-down menu to list all packages that have updates available from all publishers.</para>

</listitem>

</itemizedlist>

<note><para>Updating a package may fail sometimes, due to inherent dependencies of the package you have selected for installation or update. You may need to update all packages on your system to get the latest updates.</para>

</note>

<para>Select the package or packages you want to update and click <guibutton>Install/Update</guibutton> to install the latest version of the package. Use the <emphasis role="strong">Updates</emphasis> icon on the toolbar to update all packages on your system.</para>

</sect2>

<sect2 id="package-version"><title>Package Version Information</title>

<para>Select a package in the main window of the Package Manager and right-click your mouse to view the package version information. There are three types of package versions :</para>

<orderedlist><listitem><para><emphasis role="strong">Installable Version</emphasis> &#8211; The version of a package that is available for installation or an update. This version may be older than the latest available version of the package due to package dependencies on the system. Hence you may not be able to install the latest available version of the package unless you update your system using the <emphasis role="strong">Updates</emphasis> icon on the toolbar.</para>

</listitem>

<listitem><para><emphasis role="strong">Installed Version</emphasis> &#8211; The version of the package installed on the system.</para>

</listitem>

<listitem><para><emphasis role="strong">Latest Version</emphasis> &#8211; This is the latest version of the package available for installation or update. The latest version can be installed if your system is up-to-date.</para>

</listitem>

</orderedlist>

</sect2>

<sect2 id="gjlak"><title>View Installed Packages From All Publishers</title>

<para>Choose the <emphasis role="strong">All Publishers (Installed)</emphasis> from the <emphasis role="strong">Publisher</emphasis> drop-down menu filter to view a list of all packages that you have installed from all publishers.</para>

<note><para>You cannot search for a package from the <emphasis role="strong">All Publishers (Installed)</emphasis> option. Switch to <emphasis role="strong">All Publishers (Search)</emphasis> to search for a package.</para>

</note>

</sect2>

</sect1>

<sect1 id="intro-be"><title>Introduction to Boot Environments</title>

<para>A boot environment is an image that is bootable. Upon an initial OpenSolaris installation, a boot environment is created.</para>

<para> You can maintain multiple boot environments on your OpenSolaris 2010.03 system. Use the <command>beadm(1)</command> command from the command&#45;line interface (CLI) to create, rename, mount or unmount, or destroy these boot environments.</para>

<para>The Package Manager enables you to manage the boot environments created during the process of updating your image. For more information, see <xref linkend="manage-be"/> section.</para>

<para>Users can maintain multiple boot environments on their systems, and each boot environment can have different software versions installed.</para>

<para>When you use either the Package Manager or the <command>pkg image-update</command> command to update all the packages in your active OpenSolaris boot environment, a clone of that boot environment is automatically created. The packages are updated in the clone rather than in the original boot environment. After successfully completing the updates, the new clone is activated. Then, the clone will become the new default boot environment on system reboot. The original boot environment is also available as an alternate selection.</para>

<para id="gjkqr"> See the beadm(1) man pages and the <ulink url="http://docs.sun.com/source/820-7679/index.html"><citetitle>Upgrading and Managing Boot Environments</citetitle></ulink> document to learn more about boot environments and the <command>beadm(1)</command> command.</para>

<sect2 id="update_all"><title>Update All Packages (Update Your Image)</title>

<para>Perform the following steps to update all the packages in your image.</para>

<orderedlist><listitem><para>Click <guibutton>Updates</guibutton> to start the process of updating <emphasis role="strong">all</emphasis> the packages installed in your image.</para>

<para>You can also choose <menuchoice><guimenu>Package</guimenu><guisubmenu>Updates</guisubmenu></menuchoice> to start the process.</para>

<note><para>If no updates are available to your installed packages, a <emphasis role="strong">No Updates Available</emphasis> message is displayed after you click <guibutton>Updates</guibutton>.</para>

</note>

</listitem>

<listitem><para>The process of updating all the packages installed on your system is completed in three phases:</para>

<itemizedlist><listitem><para><emphasis role="strong">Preparation</emphasis></para>

</listitem>

<listitem><para><emphasis role="strong">Download</emphasis></para>

</listitem>

<listitem><para><emphasis role="strong">Install</emphasis></para>

</listitem>

</itemizedlist>

<para>Click on the <emphasis>Details</emphasis> tab displayed in each of the phases to view more information.</para>

</listitem>

<listitem><para>After the update process is completed successfully, an <emphasis role="strong">Update All Complete</emphasis> dialog is displayed. A new boot environment is created which consists of the updated packages. The new boot environment is given a default name by the Package Manager, you can change the given boot environment name.</para>

<note><para>If the Package Manager is unable to create a new boot environment, an error message is displayed. See the <xref linkend="gilfh"/> section on how to rectify the error and continue with updating your image.</para>

</note>

</listitem>

<listitem><para> Click <guibutton>Restart Now</guibutton> to reboot your system immediately.</para>

<para>Click <guibutton>Restart Later</guibutton> to restart your system at a later time. <emphasis role="strong">You must reboot your system for the changes to take effect.</emphasis></para>

<note><para>During the Update All process, a clone of the active boot environment is created. You can boot into the clone to return to the boot environment state that existed before the Update All process was started.</para>

</note>

</listitem>

</orderedlist>

</sect2>

<sect2 id="gilfh"><title>Update All Errors</title>

<para>A new boot environment clone must be created by the Package Manager for the Updates process to be completed. An error message is displayed if a boot environment clone cannot be created. You might see an error message such as the following :</para>

<para><literal>Not enough disk space, the Update All action cannot be performed. Choose Manage BE to manage your boot environments and free up disk space.</literal>.</para>

<para>Click <guibutton>Close</guibutton> to cancel the Update All process.</para>

<para>Perform the following steps if you want to rectify the error and continue with the Update All process: </para>

<orderedlist><listitem><para>Click <guibutton>Manage BE</guibutton> to display the <emphasis role="strong">Manage Boot Environment</emphasis> dialog.</para>

</listitem>

<listitem><para>Select the boot environments that you want to delete.</para>

<note><itemizedlist><listitem><para>You cannot delete the currently active boot environment.</para>

</listitem>

<listitem><para>You do not need to reboot your system if you are only deleting some of your boot environments.</para>

</listitem>

</itemizedlist>

</note>

</listitem>

<listitem><para>Click <guibutton>OK</guibutton>.</para>

</listitem>

<listitem><para>The <emphasis role="strong">Boot Environment Confirmation</emphasis> dialog is shown. Review your changes and click OK to proceed.</para>

</listitem>

<listitem><para>Click <guibutton>Update All</guibutton> to restart the process of updating all packages.</para>

</listitem>

</orderedlist>

</sect2>

<sect2 id="manage-be"><title>Manage Boot Environments</title>

<para>Perform the following steps to manage your boot environments:</para>

<orderedlist><listitem><para>Click <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Boot Environments</guimenuitem></menuchoice> to open the <emphasis role="strong">Manage Boot Environments</emphasis> dialog.</para>

</listitem>

<listitem><para id="gijqg">In this dialog, you can perform the following actions:</para>

<itemizedlist><listitem><para><emphasis role="strong">Activate a boot environment</emphasis> &#8211; Select the boot environment you want to be active on system reboot. This is the default boot environment <emphasis role="strong">after</emphasis> you have rebooted your system.</para>

</listitem>

<listitem><para><emphasis role="strong">Remove old or unused boot environments to free up disk space</emphasis> &#8211; Select the boot environnment or boot environments you want to delete.</para>

<note><itemizedlist><listitem><para>You cannot the delete the currently active boot environment.</para>

</listitem>

<listitem><para>If you have selected a boot environment to be renamed, it cannot be deleted.</para>

</listitem>

</itemizedlist>

</note>

</listitem>

<listitem><para><emphasis role="strong">Rename a boot environment</emphasis> &#8211; Double-click the boot environment name you want torename. Enter the new name of the boot environment and click <guibutton>OK</guibutton>.</para>

<note><itemizedlist><listitem><para>If you have selected a boot environment to be deleted, it cannot be renamed.</para>

</listitem>

<listitem><para>The currently active boot environment cannot be renamed.</para>

</listitem>

</itemizedlist>

</note>

</listitem>

</itemizedlist>

</listitem>

<listitem><para>Click <guibutton>OK</guibutton> to proceed or <guibutton>Cancel</guibutton> to cancel all changes.</para>

</listitem>

<listitem><para>The <emphasis role="strong">Boot Environment Confirmation</emphasis> dialog is displayed. Review your changes and click OK to proceed.</para>

<warning role="caution"><para>After you click <guibutton>OK</guibutton>, you cannot undo any changes that you made to the boot environments.</para>

</warning>

<note><para>The changes that you made to the <emphasis role="strong">default boot environment</emphasis> setting are effective only after system reboot.</para>

</note>

<para>Click <guibutton>Cancel</guibutton> to cancel the changes.</para>

</listitem>

<listitem><para>Reboot your system to boot into the newly activated boot environment.</para>

<note><para>Reboot your system only if you changed the active boot environment.</para>

</note>

</listitem>

</orderedlist>

</sect2>

</sect1>

<sect1 id="manage-publisher"><title>Add and Manage Publishers</title>

<sect2 id="add-publisher"><title>Add a Publisher</title>

<para>Perform the following steps to add a publisher and its associated URI:</para>

<orderedlist><listitem><para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Add Publishers</guimenuitem></menuchoice>.</para>

<para>You can also choose the <guibutton>Add..</guibutton> option from the <emphasis role="strong">Publisher</emphasis> drop-down menu or select <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> and then click <emphasis>Add..</emphasis> in the <emphasis role="strong">Manage Publishers</emphasis> dialog.</para>

</listitem>

<listitem><para>The <emphasis role="strong">Add Publisher</emphasis> dialog is displayed. Enter the name of the publisher and the associated URI. If the publisher is a secure publisher, the <emphasis role="strong">SSL Key</emphasis> and <emphasis role="strong">SSL Certificate</emphasis> fields are displayed. Follow the steps in the <xref linkend="modify-publisher"/> section to add an SSL key and certificate.</para>

</listitem>

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

</listitem>

<listitem><para>The <emphasis role="strong">Adding Publisher</emphasis> dialog is displayed. Click Cancel to cancel the process.</para>

</listitem>

<listitem><para>The <emphasis role="strong">Adding Publisher Complete</emphasis> dialog is displayed if the publisher is added successfully.</para>

</listitem>

</orderedlist>

<blockquote><para>An <emphasis role="strong">Adding Publisher Error</emphasis> is displayed if the publisher could not be added. Click <emphasis role="strong">Details</emphasis> to get more information about the error.</para>

</blockquote>

</sect2>

<sect2 id="remove-publisher"><title>Remove a Publisher</title>

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

<orderedlist><listitem><para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice>.</para>

</listitem>

<listitem><para>Click on a publisher from the list to select it. Click <guibutton>Remove</guibutton>.</para>

</listitem>

<listitem><para>The <emphasis role="strong">Manage Publishers Confirmation</emphasis> dialog is displayed.</para>

</listitem>

<listitem><para>Click <guibutton>OK</guibutton> to save the changes and remove the publisher or <guibutton>Cancel</guibutton> to return to the <emphasis role="strong">Manage Publishers</emphasis> dialog without making any changes.</para>

</listitem>

</orderedlist>

</sect2>

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

<para>Perform the following steps to set or change the publisher priority:</para>

<orderedlist><listitem><para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice> to open the <emphasis role="strong">Manage Publishers</emphasis> dialog.</para>

</listitem>

<listitem><para>The list of configured publishers is displayed. Click the arrows to change the priority of the publishers. The publisher with the highest priority is displayed at the top of the list.</para>

<para><emphasis role="strong">Packages are searched within the publishers in the order of priority, the publisher with the highest priority is searched first.</emphasis></para>

</listitem>

<listitem><para>Click <guibutton>OK</guibutton> to save your changes or <guibutton>Cancel</guibutton> to return to the <emphasis role="strong">Manage Publishers</emphasis> dialog without making any changes.</para>

</listitem>

</orderedlist>

</sect2>

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

<para>Perform the following steps to modify the alias of a publisher:</para>

<orderedlist><listitem><para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice>.</para>

</listitem>

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

</listitem>

<listitem><para>The <emphasis role="strong">Modify Publisher</emphasis> dialog is displayed. Modify or enter a new name of the alias in the <emphasis role="strong">Alias</emphasis> field.</para>

</listitem>

<listitem><para>Click <guibutton>OK</guibutton> to save your changes or <guibutton>Cancel</guibutton> to return to the <emphasis role="strong">Manage Publishers</emphasis> dialog without making any changes.</para>

</listitem>

<listitem><para>Click <guibutton>OK</guibutton> in the <emphasis role="strong">Manage Publishers</emphasis> dialog to exit the dialog. Note that clicking <guibutton>Cancel</guibutton> in the <emphasis role="strong">Manage Publishers</emphasis> dialog will not undo the changes made in the <emphasis role="strong">Modify Publishers</emphasis> dialog.</para>

</listitem>

</orderedlist>

</sect2>

<sect2 id="gjkza"><title>Add Publisher Origins</title>

<para>Perform the following steps to add an origin or origins associated with a publisher:</para>

<orderedlist><listitem><para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Publishers</guimenuitem></menuchoice>.</para>

</listitem>

<listitem><para>Select the publisher whose origin you want to modify. The <emphasis role="strong">Details</emphasis> tab in the <emphasis role="strong">Manage Publishers</emphasis> dialog displays the origin associated with the publisher.</para>

</listitem>

<listitem><para>Click <guibutton>Modify..</guibutton>.</para>

<para> The <emphasis role="strong">Modify Publisher</emphasis> dialog is displayed. Enter the name of the new origin you want to associate with the publisher in the <emphasis role="strong">Origin</emphasis> field. Click <guibutton>Add</guibutton>. The list of associated origins is displayed in the table.</para>

<note><para>You cannot change the origin URI after the origin has been added.</para>

</note>

</listitem>

<listitem><para>(optional) If the origin you have added is a secure origin, add the SSL Key and SSL certificate. <guibutton>Browse</guibutton> to locate the SSL Key and SSL Certificate on your system.</para>

</listitem>

<listitem><para>Click <guibutton>OK</guibutton> to save your changes or <guibutton>Cancel</guibutton> to return to the <emphasis role="strong">Manage Publishers</emphasis> dialog without making any changes.</para>