1 <?xml version="1.0" encoding="utf-8"?> |
1 <?xml version="1.0" encoding="utf-8"?> |
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd"> |
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd"> |
3 <book id="package_manager_online_help" lang="en"><title>Getting Started With OpenSolaris 2008.11 Package Manager</title> |
3 <book id="pkgmgr" label="beta" lang="en"><title>OpenSolaris 2009.06 Package Manager Online Help</title> |
4 <bookinfo><authorgroup><author><firstname>IPS</firstname> |
4 <bookinfo><authorgroup><author><firstname>OpenSolaris</firstname> |
5 <surname>Documentation Team</surname> |
5 <surname>Publications</surname> |
6 </author> |
6 </author> |
7 </authorgroup> |
7 </authorgroup> |
8 <pubsnumber>820-6570</pubsnumber> |
8 <pubsnumber>822-7173</pubsnumber> |
9 <releaseinfo>v 0.1</releaseinfo> |
9 <releaseinfo></releaseinfo> |
10 <pubdate>Nov 2008</pubdate> |
10 <pubdate>June 2009</pubdate> |
11 <publisher><publishername>Sun Microsystems, Inc.</publishername> |
11 <publisher><publishername>Sun Microsystems</publishername> |
12 <address><street>4150 Network Circle</street> |
|
13 <city>Santa Clara</city> |
|
14 <state>CA</state> |
|
15 <postcode>95054</postcode> |
|
16 <country>U.S.A.</country> |
|
17 </address> |
|
18 </publisher> |
12 </publisher> |
19 <copyright><year>2008</year> |
13 <copyright><year>2009</year> |
20 <holder>Sun Microsystems, Inc.</holder> |
|
21 </copyright> |
14 </copyright> |
22 <abstract><para/> |
|
23 </abstract> |
|
24 <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> |
15 <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> |
25 <para>U.S. Government Rights – Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements.</para> |
16 <para>U.S. Government Rights – Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements.</para> |
26 <para>This distribution may include materials developed by third parties.</para> |
17 <para>This distribution may include materials developed by third parties.</para> |
27 <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> |
18 <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> |
28 <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> |
19 <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> |
29 <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> |
20 <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> |
30 <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> |
21 <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> |
31 <para>DOCUMENTATION IS PROVIDED “AS IS” 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> |
22 <para>DOCUMENTATION IS PROVIDED “AS IS” 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> |
32 <para lang="fr"/> |
23 <para lang="fr"></para> |
33 <para>Sun Microsystems, Inc. détient les droits de propriété intellectuelle relatifs à la technologie incorporée dans le produit qui est décrit dans ce document. En particulier, et ce sans limitation, ces droits de propriété intellectuelle peuvent inclure un ou plusieurs brevets américains ou des applications de brevet en attente aux Etats-Unis et dans d'autres pays.</para> |
24 <para>Sun Microsystems, Inc. détient les droits de propriété intellectuelle relatifs à la technologie incorporée dans le produit qui est décrit dans ce document. En particulier, et ce sans limitation, ces droits de propriété intellectuelle peuvent inclure un ou plusieurs brevets américains ou des applications de brevet en attente aux Etats-Unis et dans d'autres pays.</para> |
34 <para>Cette distribution peut comprendre des composants développés par des tierces personnes.</para> |
25 <para>Cette distribution peut comprendre des composants développés par des tierces personnes.</para> |
35 <para>Certaines composants de ce produit peuvent être dérivées du logiciel Berkeley BSD, licenciés par l'Université de Californie. UNIX est une marque déposée aux Etats-Unis et dans d'autres pays; elle est licenciée exclusivement par X/Open Company, Ltd. </para> |
26 <para>Certaines composants de ce produit peuvent être dérivées du logiciel Berkeley BSD, licenciés par l'Université de Californie. UNIX est une marque déposée aux Etats-Unis et dans d'autres pays; elle est licenciée exclusivement par X/Open Company, Ltd. </para> |
36 <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éposées de Sun Microsystems, Inc., ou ses filiales, aux Etats-Unis et dans d'autres pays. Toutes les marques SPARC sont utilisées sous licence et sont des marques de fabrique ou des marques déposées de SPARC International, Inc. aux Etats-Unis et dans d'autres pays. Les produits portant les marques SPARC sont basés sur une architecture développée par Sun Microsystems, Inc.</para> |
27 <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éposées de Sun Microsystems, Inc., ou ses filiales, aux Etats-Unis et dans d'autres pays. Toutes les marques SPARC sont utilisées sous licence et sont des marques de fabrique ou des marques déposées de SPARC International, Inc. aux Etats-Unis et dans d'autres pays. Les produits portant les marques SPARC sont basés sur une architecture développée par Sun Microsystems, Inc.</para> |
37 <para>L'interface d'utilisation graphique OPEN LOOK et Sun a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun reconnaît les efforts de pionniers de Xerox pour la recherche et le développement du concept des interfaces d'utilisation visuelle ou graphique pour l'industrie de l'informatique. Sun détient une licence non exclusive de Xerox sur l'interface d'utilisation graphique Xerox, cette licence couvrant également les licenciés de Sun qui mettent en place l'interface d'utilisation graphique OPEN LOOK et qui, en outre, se conforment aux licences écrites de Sun.</para> |
28 <para>L'interface d'utilisation graphique OPEN LOOK et Sun a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun reconnaît les efforts de pionniers de Xerox pour la recherche et le développement du concept des interfaces d'utilisation visuelle ou graphique pour l'industrie de l'informatique. Sun détient une licence non exclusive de Xerox sur l'interface d'utilisation graphique Xerox, cette licence couvrant également les licenciés de Sun qui mettent en place l'interface d'utilisation graphique OPEN LOOK et qui, en outre, se conforment aux licences écrites de Sun.</para> |
38 <para>Les produits qui font l'objet de cette publication et les informations qu'il contient sont régis par la legislation américaine en matière de contrôle des exportations et peuvent être soumis au droit d'autres pays dans le domaine des exportations et importations. Les utilisations finales, ou utilisateurs finaux, pour des armes nucléaires, des missiles, des armes chimiques ou biologiques ou pour le nucléaire maritime, directement ou indirectement, sont strictement interdites. Les exportations ou réexportations vers des pays sous embargo des Etats-Unis, ou vers des entités figurant sur les listes d'exclusion d'exportation américaines, y compris, mais de manière non exclusive, la liste de personnes qui font objet d'un ordre de ne pas participer, d'une façon directe ou indirecte, aux exportations des produits ou des services qui sont régis par la legislation américaine en matière de contrôle des exportations et la liste de ressortissants spécifiquement designés, sont rigoureusement interdites.</para> |
29 <para>Les produits qui font l'objet de cette publication et les informations qu'il contient sont régis par la legislation américaine en matière de contrôle des exportations et peuvent être soumis au droit d'autres pays dans le domaine des exportations et importations. Les utilisations finales, ou utilisateurs finaux, pour des armes nucléaires, des missiles, des armes chimiques ou biologiques ou pour le nucléaire maritime, directement ou indirectement, sont strictement interdites. Les exportations ou réexportations vers des pays sous embargo des Etats-Unis, ou vers des entités figurant sur les listes d'exclusion d'exportation américaines, y compris, mais de manière non exclusive, la liste de personnes qui font objet d'un ordre de ne pas participer, d'une façon directe ou indirecte, aux exportations des produits ou des services qui sont régis par la legislation américaine en matière de contrôle des exportations et la liste de ressortissants spécifiquement designés, sont rigoureusement interdites.</para> |
39 <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> |
30 <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> |
40 </legalnotice> |
31 </legalnotice> |
41 </bookinfo> |
32 </bookinfo> |
42 <chapter id="pkg_mgr_online_help"><title>Introduction</title> |
33 <chapter><title>OpenSolaris 2009.06 Package Manager </title> |
43 <highlights><para>Welcome to the <trademark>OpenSolaris 2008.11</trademark> Package Manager Online Help!</para> |
34 <sect1 id="abt_pkgmgr"><title>About the Package Manager</title> |
44 <para>Use this help contents to learn how to use the Package Manager. Navigate through this help by clicking on the topics displayed in the side bar.</para> |
35 <para>Welcome to the <trademark>OpenSolaris</trademark> 2009.06 Package Manager online help!</para> |
45 <para>The OpenSolaris 2008.11 <application>Package Manager</application> application is a graphical user interface for the Image Packaging System (IPS) software. IPS is a network-centric packaging system that enables users to download and install packages, create and manage repositories, mirror repositories, and create and publish their own packages to a repository.</para> |
36 <para>Use this help contents to learn how to use the Package Manager. Navigate through this help by clicking the topics displayed in the sidebar.</para> |
46 <para>See the <ulink url="http://dlc.sun.com/osol/docs/content/2008.11/IMGPACKAGESYS/"><citetitle>Image Packaging System Guide</citetitle></ulink> for information on IPS.</para> |
37 <para>The OpenSolaris 2009.06 Package Manager application is a graphical user interface for the Image Packaging System (IPS) software. </para> |
47 <para>The <application>Package Manager</application> enables you to perform the following tasks:</para> |
38 <para>The Package Manager enables you to perform the following tasks:</para> |
48 <itemizedlist><listitem><para>Search, install, update, and remove packages.</para> |
39 <itemizedlist><listitem><para>Search, install, and remove packages.</para> |
49 </listitem> |
40 </listitem> |
50 <listitem><para>Add and modify repositories.</para> |
41 <listitem><para>Add and modify repositories.</para> |
51 </listitem> |
42 </listitem> |
52 <listitem><para>Create, remove and manage boot environments.</para> |
43 <listitem><para>Create, remove, and manage boot environments.</para> |
53 </listitem> |
44 </listitem> |
54 </itemizedlist> |
45 </itemizedlist> |
55 <note><para>See the <xref linkend="glossary-1"/> for definitions of the terms used in this document.</para> |
46 <note><para>See the <xref linkend="glossary"/> for definitions of the terms used in this document.</para> |
56 </note> |
47 </note> |
57 </highlights> |
48 </sect1> |
58 <sect1 id="ghoap"><title>Package Manager Screencast</title> |
49 <sect1 id="abt_ips"><title>About Image Packaging System (IPS)</title> |
59 <para>Learn how to use the OpenSolaris 2008.11 Package Manager through a screencast. Click <ulink url="http://webcast-west.sun.com/interactive/09B01790/index.html">here</ulink> to go the Package Manager screencast.</para> |
50 <sect2 id="gikcw"><title>An Introduction to IPS</title> |
60 </sect1> |
51 <para>The Image Packaging System software is a network-centric packaging system written in Python. IPS is an attempt to design and implement a software delivery system that interacts with a network repository. The IPS software is a framework which provides for software lifecycle management including installation, upgrade, and removal.</para> |
61 <sect1><title>Starting Package Manager</title> |
52 <para>The OpenSolaris 2009.06 release uses IPS as its packaging system.</para> |
62 <para>You can start the <application>Package Manager</application> in the following ways:</para> |
53 <para>After an initial installation of OpenSolaris 2009.06 operating system, you will find that many 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 internet. A repository is a source for packages.</para> |
63 <variablelist><varlistentry><term><emphasis role="strong">Desktop Menu</emphasis></term> |
54 <para>Users can use IPS to install packages from a repository, create and publish their own IPS packages, set up an OpenSolaris repository, mirror an existing repository, and publish existing packages to a repository.</para> |
64 <listitem><para>Click <menuchoice><guimenu>System</guimenu><guisubmenu>Administration</guisubmenu><guimenuitem>Package Manager</guimenuitem></menuchoice>.</para> |
55 <para>Once you have installed packages, IPS enables you to search, update, and manage packages on your system.</para> |
65 </listitem> |
56 <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> |
66 </varlistentry> |
57 <para>If the system on which IPS is installed is on the network, IPS can automatically access the OpenSolaris repository. For the OpenSolaris 2009.06 release, your IPS client can access the packages from <ulink url="http://pkg.opensolaris.org"></ulink>. </para> |
67 <varlistentry><term><emphasis role="strong">Command line</emphasis></term> |
58 <para>See the Image Packaging System Guide for more information about IPS.</para> |
68 <listitem><para>Run the following command :</para> |
59 <para>Visit the <ulink url="http://opensolaris.org/os/project/pkg">project page</ulink> on opensolaris.org and subscribe to [email protected] to get involved with the IPS project.</para> |
69 <para><userinput>$ gksu packagemanager &</userinput></para> |
60 </sect2> |
70 </listitem> |
61 </sect1> |
71 </varlistentry> |
62 <sect1 id="pm_win"><title>The Package Manager Window</title> |
72 </variablelist> |
63 <sect2 id="gijpl"><title>About the Package Manager Window</title> |
73 </sect1> |
64 <para>When you start the Package Manager, the following window is displayed. </para> |
74 <sect1 id="ghmbh"><title>Package Manager Window</title> |
65 <figure id="gijpx"><title>Package Manager Main Window</title> |
75 <para>When you start the <application>Package Manager</application>, the following window is displayed: </para> |
|
76 <figure id="ghpto"><title>Package Manager Main Window</title> |
|
77 <mediaobject><imageobject><imagedata fileref="figures/package_manager.png" /></imageobject> |
66 <mediaobject><imageobject><imagedata fileref="figures/package_manager.png" /></imageobject> |
78 </mediaobject> |
67 </mediaobject> |
79 </figure> |
68 </figure> |
80 <para>The main window of the <application>Package Manager</application> consists of the following elements :</para> |
69 <para>The main window of the Package Manager consists of the following elements :</para> |
81 <variablelist><varlistentry><term><emphasis role="strong">List of Packages by Category</emphasis></term> |
70 <variablelist><varlistentry><term><emphasis role="strong">Menubar</emphasis></term> |
|
71 <listitem><para>You can access the menus on the menubar to perform all of the commands related to the Package Manager.</para> |
|
72 <para></para> |
|
73 </listitem> |
|
74 </varlistentry> |
|
75 <varlistentry><term><emphasis role="strong">Toolbar</emphasis></term> |
|
76 <listitem><para>The toolbar contains the icons for a subset of the commands that can be performed by using the menus on the menubar. Additionally, a <guilabel>Search</guilabel> box and a <guilabel>Repositories</guilabel> drop-down menu are also located on the toolbar.</para> |
|
77 </listitem> |
|
78 </varlistentry> |
|
79 <varlistentry><term><emphasis role="strong">List of Packages by Category</emphasis></term> |
82 <listitem><para>You can browse the available packages by category in the left hand side drop-down menu. The drop-down menu shows the list of categories available such as <emphasis role="strong">Applications-Desktop</emphasis>, <emphasis role="strong">Applications Web based</emphasis>, and <emphasis role="strong">Operating System</emphasis>.</para> |
80 <listitem><para>You can browse the available packages by category in the left hand side drop-down menu. The drop-down menu shows the list of categories available such as <emphasis role="strong">Applications-Desktop</emphasis>, <emphasis role="strong">Applications Web based</emphasis>, and <emphasis role="strong">Operating System</emphasis>.</para> |
83 </listitem> |
81 </listitem> |
84 </varlistentry> |
82 </varlistentry> |
85 <varlistentry><term><emphasis role="strong">List of Packages by Status</emphasis></term> |
83 <varlistentry><term><emphasis role="strong">List of Packages by Status</emphasis></term> |
86 <listitem><para>The <guilabel>Show</guilabel> drop-down menu enables you to filter the list of packages by the following options:</para> |
84 <listitem><para>The <guilabel>Show</guilabel> drop-down menu enables you to filter the list of packages by the following options :</para> |
87 <itemizedlist><listitem><para><emphasis role="strong">All Packages</emphasis>– Shows the list of all packages available in the current repository.</para> |
85 <itemizedlist><listitem><para><emphasis role="strong">All Packages</emphasis> – Shows the list of all packages available in the current repository.</para> |
88 </listitem> |
86 </listitem> |
89 <listitem><para><emphasis role="strong">Installed Packages</emphasis> – Shows the list of packages installed on your system.</para> |
87 <listitem><para><emphasis role="strong">Installed Packages</emphasis> – Shows the list of packages installed on your system.</para> |
90 </listitem> |
88 </listitem> |
91 <listitem><para><emphasis role="strong">Updates Available</emphasis> — Shows the list of packages that have newer versions available in the current repository.</para> |
89 <listitem><para><emphasis role="strong">Updates Available</emphasis> — Shows the list of packages that have newer versions available in the current repository.</para> |
92 </listitem> |
90 </listitem> |
93 <listitem><para><emphasis role="strong">Non-installed Packages</emphasis> – Shows the list of packages that are not installed, but are available in the currently selected repository.</para> |
91 <listitem><para><emphasis role="strong">Non-installed Packages</emphasis> – Shows the list of packages that are not installed, but are available in the currently selected repository.</para> |
94 </listitem> |
92 </listitem> |
95 <listitem><para><emphasis role="strong">Selected Packages</emphasis> – Shows the list of packages that you have selected.</para> |
93 <listitem><para><emphasis role="strong">Selected Packages</emphasis> – Shows the list of packages that you have selected.</para> |
96 </listitem> |
94 </listitem> |
97 </itemizedlist> |
95 </itemizedlist> |
98 </listitem> |
|
99 </varlistentry> |
|
100 <varlistentry><term><emphasis role="strong">Toolbar</emphasis></term> |
|
101 <listitem><para>The toolbar contains the icons for a subset of the commands that can be performed by using the menus on the menubar.</para> |
|
102 <para>The <guilabel>Repositories</guilabel> drop-down menu is also located on the toolbar.</para> |
|
103 </listitem> |
|
104 </varlistentry> |
|
105 <varlistentry><term><emphasis role="strong">Menubar</emphasis></term> |
|
106 <listitem><para>You can access the menus on the menubar to perform all of the commands related to the Package Manager.</para> |
|
107 <para/> |
|
108 </listitem> |
96 </listitem> |
109 </varlistentry> |
97 </varlistentry> |
110 <varlistentry><term><emphasis role="strong">Package Name and Description</emphasis></term> |
98 <varlistentry><term><emphasis role="strong">Package Name and Description</emphasis></term> |
111 <listitem><para>The list of packages in the selected category, a brief description, and their status are displayed here.</para> |
99 <listitem><para>The list of packages in the selected category, a brief description, and their status are displayed here.</para> |
112 </listitem> |
100 </listitem> |
113 </varlistentry> |
101 </varlistentry> |
114 <varlistentry><term><emphasis role="strong">Package Details</emphasis></term> |
102 <varlistentry><term><emphasis role="strong">Package Details</emphasis></term> |
115 <listitem><para>Click a package to select it. Details of the selected package such as name, version, file dependencies, and license are displayed in this window.</para> |
103 <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> |
116 </listitem> |
104 </listitem> |
117 </varlistentry> |
105 </varlistentry> |
118 <varlistentry><term><emphasis role="strong">Repository Drop-down Menu</emphasis></term> |
106 <varlistentry><term><emphasis role="strong">Repository Drop-down Menu</emphasis></term> |
119 <listitem><para>The list of available repositories is shown in the repository drop-down menu. Click a repository name to select it.</para> |
107 <listitem><para>The list of available repositories is shown in the repository drop-down menu. Click a repository name to select it.</para> |
120 <note><para>Click the <guilabel>Reload</guilabel> button to reload the Package Manager and view the list of packages from the newly selected repository.</para> |
108 <note><para>Clicking the <guilabel>Reload</guilabel> button reloads the Package Manager and displays the list of packages in the newly selected repository.</para> |
121 </note> |
109 </note> |
|
110 </listitem> |
|
111 </varlistentry> |
|
112 <varlistentry><term><emphasis role="strong">Search Box</emphasis></term> |
|
113 <listitem><para>Search for a package is provided in the following contexts :</para> |
|
114 <itemizedlist><listitem><para>Search within the current, default repository</para> |
|
115 </listitem> |
|
116 <listitem><para>Search across all configured repositories</para> |
|
117 </listitem> |
|
118 </itemizedlist> |
122 </listitem> |
119 </listitem> |
123 </varlistentry> |
120 </varlistentry> |
124 </variablelist> |
121 </variablelist> |
125 </sect1> |
122 </sect2> |
126 </chapter> |
123 <sect2 id="edit_prefs"><title>Edit Preferences</title> |
127 <chapter><title>Working With the Package Manager</title> |
124 <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> |
128 <highlights><para>The following sections document the tasks that can be performed with the <application>Package Manager</application>.</para> |
125 <para>You can choose to turn off this setting so this page is not displayed when Package Manager starts.</para> |
129 </highlights> |
126 <para>Select <guimenu>Edit</guimenu> <guisubmenu>Preferences</guisubmenu> from the menu and uncheck the <emphasis role="strong">Show Start Page on startup</emphasis> box to disable the Start Page.</para> |
130 <sect1 id="ghmzf"><title>Install a Package</title> |
127 </sect2> |
|
128 </sect1> |
|
129 <sect1><title>Working With Packages</title> |
|
130 <sect2 id="install_pkg"><title>Install a Package</title> |
131 <para>Perform the following steps to install a package:</para> |
131 <para>Perform the following steps to install a package:</para> |
132 <orderedlist><listitem><para>In the main window of the <application>Package Manager</application>, click the <guibutton>Reload</guibutton> button to view the latest list of packages available to you.</para> |
132 <orderedlist><listitem><para>In the main window of the <application>Package Manager</application>, click the <guibutton>Reload</guibutton> button to view the latest list of packages available to you.</para> |
133 </listitem> |
133 </listitem> |
134 <listitem><para>Check the box next to the package to select it.</para> |
134 <listitem><para>Select a package.</para> |
135 </listitem> |
135 </listitem> |
136 <listitem><para>Click <guibutton>Install/Update</guibutton> in the toolbar to start the package installation process.</para> |
136 <listitem><para>Click <guibutton>Install/Update</guibutton> in the toolbar to start the package installation process.</para> |
137 <para>You can also choose <menuchoice><guimenu>Package</guimenu><guimenuitem>Install/Update</guimenuitem></menuchoice> to start the package installation process.</para> |
137 <para>You can also choose <menuchoice><guimenu>Package</guimenu><guimenuitem>Install/Update</guimenuitem></menuchoice> to start the package installation process.</para> |
138 </listitem> |
138 </listitem> |
139 <listitem><para>The <application>Package Manager</application> checks for dependencies. Click <guilabel>Show Details</guilabel> to see more information about the package and its dependencies .</para> |
139 <listitem><para>View the details or cancel the package installation </para> |
|
140 <itemizedlist><listitem><para>Click <guilabel>Show Details</guilabel> to view the details.</para> |
|
141 </listitem> |
|
142 <listitem><para>Click <guibutton>Cancel</guibutton> to cancel the package installation. No changes are made and you are returned to the main window. </para> |
|
143 </listitem> |
|
144 </itemizedlist> |
140 </listitem> |
145 </listitem> |
141 <listitem><para>Review the package installation information and the package dependencies details in the <guilabel>Install Confirmation</guilabel> dialog.</para> |
146 <listitem><para>Review the package installation information and the package dependencies details in the <guilabel>Install Confirmation</guilabel> dialog.</para> |
142 <para>Click <guibutton>Next</guibutton> to proceed with the package installation.</para> |
147 <itemizedlist><listitem><para>Click <guibutton>Next</guibutton> to proceed with the package installation.</para> |
143 <para>Click <guibutton>Cancel</guibutton> to cancel the package installation. No changes are made and you are returned to the main window.</para> |
148 </listitem> |
144 </listitem> |
149 <listitem><para>Click <guibutton>Cancel</guibutton> to cancel the package installation. No changes are made and you are returned to the main window.</para> |
145 <listitem><para>The <guilabel>Downloading Packages</guilabel> dialog is displayed. Click <guibutton>Cancel</guibutton> if you want to cancel the package installation. No changes are made and you are returned to the main window.</para> |
150 </listitem> |
146 </listitem> |
151 </itemizedlist> |
147 </orderedlist> |
152 </listitem> |
148 <para>The packages are installed. The updated list of packages are displayed in the main window.</para> |
153 <listitem><para>Click <guibutton>Cancel</guibutton> to cancel the package installation in the <guilabel>Downloading Packages</guilabel> dialog box. </para> |
149 </sect1> |
154 <para>No changes are made and you are returned to the main window.</para> |
150 <sect1 id="ghmyo"><title>Remove a Package</title> |
155 </listitem> |
|
156 <listitem><para>Check the <guilabel>Accept</guilabel> box and click <guibutton>Accept</guibutton> to accept the terms of the license and complete the package installation successfully.</para> |
|
157 <warning role="caution"><para> If you reject the license, the installation process is canceled and the packages will not be installed.</para> |
|
158 </warning> |
|
159 </listitem> |
|
160 </orderedlist> |
|
161 </sect2> |
|
162 <sect2 id="remove_pkg"><title>Remove a Package</title> |
151 <para>Perform the following steps to remove a package:</para> |
163 <para>Perform the following steps to remove a package:</para> |
152 <orderedlist><listitem><para>Check the box next to the package or packages that you want to remove.</para> |
164 <orderedlist><listitem><para>Select the package or packages that you want to remove.</para> |
153 </listitem> |
165 </listitem> |
154 <listitem><para>Click the <guibutton>Remove</guibutton> button in the toolbar to start the process.</para> |
166 <listitem><para>Click the <guibutton>Remove</guibutton> button in the toolbar to start the process.</para> |
155 <para>You can also choose <menuchoice><guimenu>Package</guimenu><guimenuitem>Remove</guimenuitem></menuchoice> to remove a package.</para> |
167 <para>You can also choose <menuchoice><guimenu>Package</guimenu><guimenuitem>Remove</guimenuitem></menuchoice> to remove a package.</para> |
156 </listitem> |
168 </listitem> |
157 <listitem><para>Review the packages to be removed and the package dependencies details in the <guilabel>Remove Confirmation</guilabel> dialog.</para> |
169 <listitem><para>Review the packages to be removed and the package dependencies details in the <guilabel>Remove Confirmation</guilabel> dialog box.</para> |
158 </listitem> |
170 </listitem> |
159 <listitem><para>Click <guibutton>Proceed</guibutton> to confirm. After you click the <guibutton>OK</guibutton> button, you cannot undo the package removal.</para> |
171 <listitem><para>Uninstall the package or cancel the uninstallation process.</para> |
160 <para>Click <guibutton>Cancel</guibutton> to cancel the process. No changes are made and you are returned to the main window.</para> |
172 <itemizedlist><listitem><para>Click <guibutton>Proceed</guibutton> to start uninstalling the packages.</para> |
161 </listitem> |
173 </listitem> |
162 </orderedlist> |
174 <listitem><para>Click <guibutton>Cancel</guibutton> to cancel the process. No changes are made and you are returned to the main window.</para> |
163 </sect1> |
175 <warning role="caution"><para>After you click the <guibutton>Proceed</guibutton> button, you cannot undo the package removal action.</para> |
164 <sect1 id="ghmxy"><title>Search for a Package</title> |
176 </warning> |
165 <para>Type the name of the package that you want to search for in the <guilabel>Search</guilabel> box. Enter the complete name, description, or a partial name to search for the package. For example, you might enter one of the following search terms to search for <filename>SUNWgnome-games</filename> :</para> |
177 </listitem> |
|
178 </itemizedlist> |
|
179 </listitem> |
|
180 </orderedlist> |
|
181 </sect2> |
|
182 <sect2 id="search_pkg"><title>Search for a Package</title> |
|
183 <para>You can search for a package in the following ways :</para> |
|
184 <itemizedlist><listitem><para><emphasis role="strong">Search the default repository</emphasis> – The search will be performed on the default repository, <emphasis role="strong">http://pkg.opensolaris.org</emphasis>.</para> |
|
185 </listitem> |
|
186 <listitem><para><emphasis role="strong">Search the current repository</emphasis> – </para> |
|
187 </listitem> |
|
188 <listitem><para><emphasis role="strong">Search all repositories</emphasis>– Search for the package across all configured or registered repositories. </para> |
|
189 </listitem> |
|
190 </itemizedlist> |
|
191 <para>Type the name of the package that you want to search for in the <guilabel>Search</guilabel> box. </para> |
|
192 <para>Enter the complete name, description, or a partial name to search for the package. For example, you might type one of the following search terms to search for <filename>SUNWgnome-games</filename> :</para> |
166 <itemizedlist><listitem><para>SUNWgames</para> |
193 <itemizedlist><listitem><para>SUNWgames</para> |
167 </listitem> |
194 </listitem> |
168 <listitem><para>games</para> |
195 <listitem><para>games</para> |
169 </listitem> |
196 </listitem> |
170 <listitem><para>GNOME-games</para> |
197 <listitem><para>GNOME-games</para> |
171 </listitem> |
198 </listitem> |
172 </itemizedlist> |
199 </itemizedlist> |
173 <tip><itemizedlist><listitem><para>Use the submenus under the <menuchoice><guimenu>Edit</guimenu></menuchoice> menu to cut, copy, paste, or clear text in the <guilabel>Search</guilabel> tab.</para> |
200 <tip><itemizedlist><listitem><para>Use the submenus under the <menuchoice><guimenu>Edit</guimenu></menuchoice> menu to cut, copy, paste, or clear text in the <guilabel>Search</guilabel> tab.</para> |
174 </listitem> |
201 </listitem> |
175 <listitem><para>Use the icon on the right hand side of the <guilabel>Search</guilabel> tab to clear the search results.</para> |
202 <listitem><para>Use the icon on the right side of the <guilabel>Search</guilabel> tab to clear the search results.</para> |
176 </listitem> |
203 </listitem> |
177 </itemizedlist> |
204 </itemizedlist> |
178 </tip> |
205 </tip> |
179 </sect1> |
206 </sect2> |
180 <sect1 id="ghmzc"><title>Update a Package</title> |
207 <sect2 id="update_pkg"><title>Update a Package</title> |
181 <para>Look for the green icon next to the installed package name. This icon indicates that updates are available for the package in the currently selected repository. Select the package and click the <guibutton>Install/Update</guibutton> button to install the latest version of the package.</para> |
208 <para>Look for the green icon next to the installed package name. This icon indicates that updates are available for the package in the currently selected repository. Select the package and click the <guibutton>Install/Update</guibutton> button to install the latest version of the package.</para> |
182 </sect1> |
209 </sect2> |
183 <sect1 id="ghmym"><title>Switch Between Configured Repositories</title> |
210 </sect1> |
184 <para>Use the <guilabel>Repositories</guilabel> drop-down menu on the toolbar to view a list of configured repositories. Click a repository name to switch to a different repository.</para> |
211 <sect1 id="intro_be"><title>Introduction to Boot Environments</title> |
185 </sect1> |
212 <para>The OpenSolaris 2009.06 release is a boot environment.</para> |
186 <sect1 id="ghqub"><title>Introduction to Boot Environments</title> |
213 <para> A boot environment is an image that is bootable. The boot environment consists of a root file system and, optionally, other file systems, such as <filename>/usr</filename>, <filename>/var</filename>, or <filename>/export</filename>. These other file systems are mounted below the root file system. The root file system and all other file systems of the boot environment that contain system software are required to be ZFS datasets.</para> |
187 <para>The OpenSolaris 2008.11 release is a boot environment.</para> |
214 <para> You can maintain multiple boot environments on your system. Use the command—line interface (CLI) to create, rename, mount or unmount, or destroy these boot environments. The primary reason to have more than one boot environment on your system is to create backups of your existing boot environments before you modify them. Then you have the option of booting a backup boot environment when needed.</para> |
188 <para> A boot environment is an image that is bootable. The boot environment consists of a root file system and, optionally, other file systems, such as <filename>/usr</filename>, <filename>/var</filename>, or <filename>/export</filename>. These other file systems are mounted below the root file system. The root file system and all other file systems of the boot environment that contain system software are required to be zfs datasets.</para> |
215 <para> See the <ulink url="http://dlc.sun.com/osol/docs/content/2008.11/snapupgrade/snap3.html"><citetitle>Upgrading and Managing Boot Environments</citetitle></ulink> document to learn more.</para> |
189 <para> You can maintain multiple boot environments on your system. The primary reason to have more than one boot environment on your system is to create backups of your existing boot environments before you modify them. Then, you have the option of booting a backup boot environment when needed. Use the <command>beadm(1)</command> utility to create, and manage your boot environments. </para> |
216 <para>The Package Manager creates a clone of the active boot environment when an image is updated.</para> |
190 <para>For detailed instructions about the <command>beadm</command> utility, see the <literal>beadm</literal>(1M) man page.</para> |
217 <sect2 id="update_all"><title>Update All Packages (Update Your Image)</title> |
191 <para> See the <ulink url="http://dlc.sun.com/osol/docs/content/2008.11/snapupgrade/snap3.html"><citetitle>Upgrading and Managing Boot Environments</citetitle></ulink> document for more information on boot environments.</para> |
|
192 <para>The <application>Package Manager</application> creates a clone of the active boot environment when an image is updated.</para> |
|
193 </sect1> |
|
194 <sect1 id="ghmyp"><title>Update the Current Image (Update All Packages)</title> |
|
195 <para>Perform the following steps to update all the packages in your image.</para> |
218 <para>Perform the following steps to update all the packages in your image.</para> |
196 <orderedlist><listitem><para>Click the <guilabel>Update All</guilabel> button to start the process of updating <emphasis role="strong">all</emphasis> the packages in your image.</para> |
219 <orderedlist><listitem><para>Click the <guilabel>Update All</guilabel> button to start the process of updating <emphasis role="strong">all</emphasis> the packages in your image.</para> |
197 <para>You can also choose <menuchoice><guimenu>File</guimenu><guimenuitem>Update All</guimenuitem></menuchoice> to start the process.</para> |
220 <para>You can also choose <menuchoice><guimenu>File</guimenu><guimenuitem>Update All</guimenuitem></menuchoice> to start the process.</para> |
198 <note><para>The <guilabel>Update All</guilabel> button is enabled when updates are available to the installed packages.</para> |
221 <note><para>The <guilabel>Update All</guilabel> button is enabled when updates are available to the installed packages.</para> |
199 </note> |
222 </note> |
200 </listitem> |
223 </listitem> |
201 <listitem><para>The <guilabel>Update All</guilabel> window is displayed. Click <guibutton>Proceed</guibutton> to create a new boot environment and proceed with the Update All process.</para> |
224 <listitem><para>A <guilabel>Create New Boot Environment</guilabel> window is displayed. A name for the new boot environment is automatically generated.</para> |
202 <para>During the Update All process, a clone of the active boot environment is created. This clone enables the user to boot into the boot environment state that existed before the Update All process was started. If the Package Manager is unable to create a new boot environment, an error message will be displayed. See the <xref linkend="ghmyd"/> section on how to rectify the error and continue with updating your image.</para> |
225 </listitem> |
|
226 <listitem><para>(optional) You can change the name of the new boot environment if you want. </para> |
|
227 </listitem> |
|
228 <listitem><para>Confirm or Cancel the new boot environment.</para> |
|
229 <itemizedlist><listitem><para>Click <guibutton>Proceed</guibutton> to create a new boot environment and proceed with the Update All process.</para> |
|
230 </listitem> |
|
231 <listitem><para>Click <guibutton>Cancel</guibutton> to cancel the process.</para> |
|
232 </listitem> |
|
233 </itemizedlist> |
|
234 <note><para>During the Update All process, a clone of the active boot environment is created. This clone enables the user to boot into the boot environment state that existed before the Update All process was started. If the Package Manager is unable to create a new boot environment, an error message will be displayed. See the <xref linkend="gilfh"/> section on how to rectify the error and continue with updating your image.</para> |
|
235 </note> |
|
236 <para>If you chose to proceed with the Update All process, the packages are downloaded and installed.</para> |
|
237 <para>After a successful completion, the <guilabel>Update All Complete</guilabel> dialog box is shown.</para> |
|
238 </listitem> |
|
239 <listitem><para> Click <guibutton>Close</guibutton>. </para> |
|
240 </listitem> |
|
241 <listitem><para>Read the <ulink url="http://opensolaris.org/os/project/indiana/resources/relnotes/200811/x86/">Release Notes</ulink> before rebooting your system. </para> |
|
242 <note><para><emphasis role="strong">You must reboot your system for the changes to take effect.</emphasis></para> |
|
243 </note> |
|
244 </listitem> |
|
245 </orderedlist> |
|
246 </sect2> |
|
247 <sect2 id="gilfh"><title>Update All Errors</title> |
|
248 <para>A new boot environment clone must be created by the Package Manager for the Update All 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> |
|
249 <para><literal>Not enough disk space: the Update All action cannot be performed. You may choose to return to BE Management to manage your boot environments and free up disk space</literal>.</para> |
|
250 <para>Click <guibutton>Cancel</guibutton> to cancel the Update All process and return to the main window.</para> |
|
251 <para>Perform the following steps if you want to rectify the error and continue with the Update All process: </para> |
|
252 <orderedlist><listitem><para>Click <guibutton>OK</guibutton> to display the <guilabel>Boot Environment Management</guilabel> dialog box.</para> |
|
253 </listitem> |
|
254 <listitem><para>Select the boot environments that you want to delete.</para> |
|
255 <note><itemizedlist><listitem><para>You cannot delete the currently active boot environment.</para> |
|
256 </listitem> |
|
257 <listitem><para>You do not need to reboot your system if you are only deleting some of your boot environments.</para> |
|
258 </listitem> |
|
259 </itemizedlist> |
|
260 </note> |
|
261 </listitem> |
|
262 <listitem><para>Click <guibutton>OK</guibutton>. The <guilabel>Manage BEs Changes Confirmation</guilabel> dialog is shown.</para> |
|
263 </listitem> |
|
264 <listitem><para> Review your changes and click <guibutton>OK</guibutton> to delete your boot environments.</para> |
|
265 </listitem> |
|
266 <listitem><para>Click the <guibutton>Update All</guibutton> icon to restart the process of updating all packages.</para> |
|
267 </listitem> |
|
268 </orderedlist> |
|
269 </sect2> |
|
270 <sect2 id="manage_be"><title>Manage Boot Environments</title> |
|
271 <para>Perform the following steps to manage your boot environments:</para> |
|
272 <orderedlist><listitem><para>Click <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Boot Environments</guimenuitem></menuchoice> to open the <guilabel>Manage Boot Environments</guilabel> dialog.</para> |
|
273 </listitem> |
|
274 <listitem><para id="gijqg">In this dialog box , you can perform the following actions:</para> |
|
275 <itemizedlist><listitem><para><emphasis role="strong">Activate a boot environment</emphasis> – Select the boot environment that you want to be active on system reboot. This will be the default boot environment <emphasis role="strong">after</emphasis> you have rebooted your system.</para> |
|
276 </listitem> |
|
277 <listitem><para><emphasis role="strong">Remove old or unused boot environments to free up disk space</emphasis> – Select the boot environments that you want to delete.</para> |
|
278 <note><itemizedlist><listitem><para>You cannot the delete the currently active boot environment.</para> |
|
279 </listitem> |
|
280 <listitem><para>You do not need to reboot your system if you are only deleting some of your boot environments.</para> |
|
281 </listitem> |
|
282 </itemizedlist> |
|
283 </note> |
|
284 </listitem> |
|
285 <listitem><para><emphasis role="strong">Rename a boot environment</emphasis> – Double-click the BE name that you want to change. Enter the new name of the BE and click <guibutton>OK</guibutton>. </para> |
|
286 </listitem> |
|
287 </itemizedlist> |
|
288 </listitem> |
|
289 <listitem><para>Accept or decline the changes:</para> |
|
290 <itemizedlist><listitem><para>Click <guibutton>OK</guibutton> to proceed.</para> |
|
291 </listitem> |
|
292 <listitem><para>Click <guibutton>Cancel</guibutton> to cancel all changes and return to the main window.</para> |
|
293 </listitem> |
|
294 </itemizedlist> |
|
295 </listitem> |
|
296 <listitem><para>The <guilabel>Manage BEs Confirmation</guilabel> dialog box is displayed.</para> |
|
297 <para>Review the boot environment changes and click <guibutton>OK</guibutton> to proceed.</para> |
|
298 <warning role="caution"><para>After you click <guibutton>OK</guibutton>, you cannot undo any changes that you made to the boot environments.</para> |
|
299 </warning> |
|
300 <note><para>The changes that you made to the <emphasis role="strong">default boot environment</emphasis> setting are effective only after system reboot.</para> |
|
301 </note> |
|
302 <para>Click <guibutton>Cancel</guibutton> to cancel the changes and return to the <literal>BE Management</literal> dialog box.</para> |
|
303 </listitem> |
|
304 <listitem><para>Reboot your system to see the latest changes.</para> |
|
305 <note><para>You do not need to reboot your system if you only renamed a BE and did not make any other changes.</para> |
|
306 </note> |
|
307 </listitem> |
|
308 </orderedlist> |
|
309 </sect2> |
|
310 </sect1> |
|
311 <sect1 id="manage_repo"><title>Managing Repositories</title> |
|
312 <sect2 id="add_repo"><title>Add a Repository</title> |
|
313 <para>Perform the following steps to add a repository:</para> |
|
314 <orderedlist><listitem><para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Repositories</guimenuitem></menuchoice> to open the <guilabel>Manage Repositories</guilabel> dialog.</para> |
|
315 </listitem> |
|
316 <listitem><para>Type the name and the address (URL) of the repository you want to add. Click <guibutton>Add</guibutton></para> |
|
317 </listitem> |
|
318 </orderedlist> |
|
319 </sect2> |
|
320 <sect2 id="remove_repo"><title>Remove a Repository</title> |
|
321 <para>Perform the following steps to remove a repository:</para> |
|
322 <orderedlist><listitem><para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Repositories</guimenuitem></menuchoice> to open the <guilabel>Manage Repositories</guilabel> dialog.</para> |
|
323 </listitem> |
|
324 <listitem><para>Select a repository from the list. Click <guibutton>Remove</guibutton>.</para> |
|
325 <note><para>A repository that has been set as preferred repository cannot be removed. To remove a preferred repository, set a nonpreferred repository as preferred, and then remove the repository.</para> |
|
326 </note> |
|
327 </listitem> |
|
328 </orderedlist> |
|
329 </sect2> |
|
330 <sect2 id="set_pref_repo"><title>Set a Preferred Repository</title> |
|
331 <para>Perform the following steps to set a preferred repository:</para> |
|
332 <orderedlist><listitem><para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Repositories</guimenuitem></menuchoice> to open the <guilabel>Manage Repositories</guilabel> dialog.</para> |
|
333 </listitem> |
|
334 <listitem><para>Click the radio button next to the repository that you would like to set as the preferred repository.</para> |
|
335 </listitem> |
|
336 <listitem><para>Click <guibutton>Close</guibutton> if you are not making any other changes to the repository information.</para> |
|
337 </listitem> |
|
338 </orderedlist> |
|
339 </sect2> |
|
340 <sect2 id="modify_repo"><title>Modify a Repository</title> |
|
341 <para>Perform the following steps to modify a repository:</para> |
|
342 <orderedlist><listitem><para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Manage Repositories</guimenuitem></menuchoice> to open the <guilabel>Manage Repositories</guilabel> dialog.</para> |
|
343 </listitem> |
|
344 <listitem><para>Select the repository that you want to modify.</para> |
|
345 </listitem> |
|
346 <listitem><para>Click the <guibutton>Modify</guibutton> button.</para> |
|
347 <para> The <guilabel>Modify Repository</guilabel> dialog box is displayed. You can perform the following actions in the <guilabel>Modify Repository</guilabel> dialog box:</para> |
|
348 <itemizedlist><listitem><para><emphasis role="strong">Change the name and URL of the repository</emphasis> – Type a valid name for the repository and the URL of the repository.</para> |
|
349 <para>A repository name is considered valid if it does not exist in the current list of repositories.</para> |
|
350 </listitem> |
|
351 <listitem><para><emphasis role="strong">Add a SSL Key and Certificate</emphasis> – If a repository requires a key or certificate, add the repository name and URL, and then click the <guibutton>Modify</guibutton> button to add additional information such as a key or certificate.</para> |
|
352 </listitem> |
|
353 <listitem><para><emphasis role="strong">Add a Mirror</emphasis> – If a repository has a mirror, add the repository name and URL, and then click the <guibutton>Modify</guibutton> button to add the mirror information.</para> |
|
354 </listitem> |
|
355 </itemizedlist> |
|
356 </listitem> |
|
357 <listitem><para>Confirm or decline the changes.</para> |
|
358 <itemizedlist><listitem><para>Click <guibutton>OK</guibutton> to save the changes and return to the <guilabel>Manage Repositories</guilabel> dialog box.</para> |
|
359 </listitem> |
|
360 <listitem><para>Click <guibutton>Cancel</guibutton> to cancel your changes.</para> |
|
361 </listitem> |
|
362 </itemizedlist> |
|
363 </listitem> |
|
364 </orderedlist> |
|
365 </sect2> |
|
366 </sect1> |
|
367 <sect1 id="um_info"><title>Working With the Update Manager</title> |
|
368 <sect2 id="gijqh"><title>About The Update Manager</title> |
|
369 <para>The Update Manager is a separate application that starts from the desktop when updates to the installed packages are available in the repository.</para> |
|
370 <figure id="gijqi"><title>Update Manager Main Window</title> |
|
371 <mediaobject><imageobject><imagedata fileref="figures/update_all.png" /></imageobject> |
|
372 </mediaobject> |
|
373 </figure> |
|
374 <para>You can use the Update Manager application to update the installed packages in your image.</para> |
|
375 <note><para>For the OpenSolaris 2009.06 release, the Update Manager updates <emphasis role="strong">all</emphasis> installed packages in the image. This action is equivalent to updating the image.</para> |
|
376 </note> |
|
377 </sect2> |
|
378 <sect2 id="using_um"><title>Using the Update Manager</title> |
|
379 <para>When updates are available to the installed packages, a notification icon is displayed in the notification panel on the OpenSolaris desktop.</para> |
|
380 <para> You can also click <menuchoice><guimenu>System</guimenu><guisubmenu>Administration</guisubmenu><guimenuitem>Update Manager</guimenuitem></menuchoice> to manually launch the Update Manager.</para> |
|
381 <para>When you are notified of a software update, perform the following steps to begin the process of updating your system :</para> |
|
382 <orderedlist><listitem><para>Click the notification icon on the desktop to display the <guilabel>Update Manager</guilabel> window.</para> |
|
383 </listitem> |
|
384 <listitem><para>Click the <guibutton>Update All</guibutton> button in the <guilabel>Update Manager</guilabel> window.</para> |
|
385 <note><para>Select a package and click the <guilabel>Details</guilabel> panel if you want to view more information about the package.</para> |
|
386 </note> |
|
387 </listitem> |
|
388 <listitem><para>The <guilabel>Update All</guilabel> dialog box is displayed. Proceed with the Update All process or cancel the action.</para> |
|
389 <itemizedlist><listitem><para>Click <guibutton>Proceed</guibutton> to create a new boot environment and update all packages in the current image.</para> |
|
390 <para>During the Update All process, a clone of the active boot environment is created. This clone enables the user to boot into the boot environment state that existed before the Update All process was started. </para> |
|
391 <para>If the Package Manager is unable to create a new boot environment, an error message will be displayed. See the <xref linkend="gileh"/> section on how to rectify the error and continue with updating your image.</para> |
203 <note><para>A name for the new boot environment is automatically generated.</para> |
392 <note><para>A name for the new boot environment is automatically generated.</para> |
204 </note> |
393 </note> |
205 <para>Click <guibutton>Cancel</guibutton> to cancel the process.</para> |
394 </listitem> |
206 </listitem> |
395 <listitem><para>Click <guibutton>Cancel</guibutton> to cancel the process.</para> |
207 <listitem><para id="step_2">If you chose to proceed, the Package Manager checks for dependencies and the <guilabel>Install/Update Confirmation</guilabel> dialog is displayed.</para> |
396 </listitem> |
208 <para>Review the packages to be installed and click <guibutton>Next</guibutton> to proceed.</para> |
397 </itemizedlist> |
209 <para>Click <guibutton>Cancel</guibutton> to cancel the process.</para> |
398 </listitem> |
210 </listitem> |
399 <listitem><para>If you chose to proceed, the <guilabel>Installing Updates</guilabel> windows are displayed. The package installation process consists of four stages:</para> |
211 <listitem><para>The packages are downloaded and installed.</para> |
400 <orderedlist><listitem><para>Evaluate.</para> |
|
401 </listitem> |
|
402 <listitem><para>Download.</para> |
|
403 </listitem> |
|
404 <listitem><para>Install.</para> |
|
405 </listitem> |
|
406 <listitem><para>Index.</para> |
|
407 </listitem> |
|
408 </orderedlist> |
|
409 <para>You can choose to cancel the process only during the Evaluate and Download stages. Click the <guibutton>Cancel</guibutton> button to cancel the installation process. No changes are made and you are returned to the main window of the Update Manager.</para> |
|
410 <note><para>If an error occurs during any of the stages, the <guilabel>Details</guilabel> panel is expanded and the details of the error are displayed. An error status indicator is shown next to the failed stage.</para> |
|
411 </note> |
|
412 </listitem> |
|
413 <listitem><para>Click the <guilabel>Details</guilabel> panel to view more information about each of the installation processes.</para> |
212 </listitem> |
414 </listitem> |
213 <listitem><para>Read the <ulink url="http://opensolaris.org/os/project/indiana/resources/relnotes/200811/x86/">Release Notes</ulink> before rebooting your system.</para> |
415 <listitem><para>Read the <ulink url="http://opensolaris.org/os/project/indiana/resources/relnotes/200811/x86/">Release Notes</ulink> before rebooting your system.</para> |
214 <warning role="caution"><para>You must reboot your system for the changes to take effect.</para> |
416 <warning role="caution"><para>You must reboot your system for the changes to take effect.</para> |
215 </warning> |
417 </warning> |
216 </listitem> |
418 </listitem> |
217 </orderedlist> |
419 </orderedlist> |
218 <sect2 id="ghmyd"><title>Update All Errors</title> |
420 </sect2> |
219 <para>A new boot environment clone <emphasis role="strong">must</emphasis> be created for the Update All 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 :</para> |
421 <sect2 id="gileh"><title>Update All Errors</title> |
220 <para><literal>Not enough disk space: the selected action cannot be performed. You may choose to return to BE Management to manage your boot environments and free up disk space</literal>.</para> |
422 <para>A new boot environment clone <emphasis role="strong">must</emphasis> be created for the Update All process to be completed. The following error message is displayed if a boot environment clone cannot be created due to space restrictions :</para> |
221 <para>Click <guibutton>Cancel</guibutton> to cancel the Update All process and return to the main window.</para> |
423 <para><literal>Not enough disk space: the Update All action cannot be performed. Do you want to launch BE Management to manage your existing BEs and free up disk space?</literal></para> |
222 <para>Perform the following steps if you want to rectify the error and continue with the Update All process: </para> |
|
223 <orderedlist><listitem><para>Click <guibutton>BE Management</guibutton> to go to the <guilabel>Boot Environment Management</guilabel> dialog.</para> |
|
224 <para>Click <guibutton>Close</guibutton> to cancel the process and return to the main window.</para> |
|
225 </listitem> |
|
226 <listitem><para>If you chose to rectify the error, go to step 2 in the <xref linkend="ghmya"/> section. Follow instructions to delete old or unused boot environments and free up disk space.</para> |
|
227 </listitem> |
|
228 <listitem><para>Click the <guibutton>Update All</guibutton> icon to restart the process of updating all packages.</para> |
|
229 </listitem> |
|
230 </orderedlist> |
|
231 </sect2> |
|
232 </sect1> |
|
233 <sect1 id="ghmya"><title>Manage Boot Environments</title> |
|
234 <para>Perform the following steps to manage your boot environments :</para> |
|
235 <orderedlist><listitem><para>Click <menuchoice><guimenu>File</guimenu><guimenuitem>Boot Environment Management</guimenuitem></menuchoice> to open the <guilabel>Boot Environment Management</guilabel> dialog.</para> |
|
236 </listitem> |
|
237 <listitem><para id="be_step2">In this dialog, you can perform the following actions:</para> |
|
238 <variablelist><varlistentry><term><emphasis role="strong">Change the default boot environment.</emphasis></term> |
|
239 <listitem><para>Select the boot environment that you want to be active on system reboot. This is the default boot environment.</para> |
|
240 </listitem> |
|
241 </varlistentry> |
|
242 <varlistentry><term><emphasis role="strong">Remove old or unused boot environments to free up disk space.</emphasis></term> |
|
243 <listitem><para>Select the boot environments that you want to delete.</para> |
|
244 <note><para>You do not need to reboot your system if you are only deleting some of your boot environments.</para> |
|
245 </note> |
|
246 </listitem> |
|
247 </varlistentry> |
|
248 </variablelist> |
|
249 </listitem> |
|
250 <listitem><para>Click <guibutton>OK</guibutton> to proceed.</para> |
|
251 <para>Click <guibutton>Reset</guibutton> to reset the changes and show the initial state of the boot environments.</para> |
|
252 <para>Click <guibutton>Cancel</guibutton> to cancel all changes and return to the main window.</para> |
|
253 </listitem> |
|
254 <listitem><para>If you chose to proceed, the <guilabel>BE Management Confirmation</guilabel> dialog is displayed. Review the boot environment changes and click <guibutton>OK</guibutton> to proceed.</para> |
|
255 <warning role="caution"><para>After you click <guibutton>OK</guibutton>, you cannot undo any changes you made to the boot environments.</para> |
|
256 </warning> |
|
257 <note><para>The changes that you made to the <emphasis role="strong">default boot environment</emphasis> setting is effective only after system reboot.</para> |
|
258 </note> |
|
259 <para>Click <guibutton>Cancel</guibutton> to cancel the changes and return to the <literal>BE Management</literal> dialog box.</para> |
|
260 </listitem> |
|
261 <listitem><para>Reboot your system to boot into the new default boot environment.</para> |
|
262 </listitem> |
|
263 </orderedlist> |
|
264 </sect1> |
|
265 <sect1 id="ghmzn"><title>Edit Repositories</title> |
|
266 <para>Perform the following steps to add, remove, or configure repositories:</para> |
|
267 <orderedlist><listitem><para>Choose <menuchoice><guimenu>Settings</guimenu><guimenuitem>Edit Repositories</guimenuitem></menuchoice> to open the <guilabel>Manage Repositories</guilabel> dialog.</para> |
|
268 </listitem> |
|
269 <listitem><para>In this dialog box, you can perform the following actions :</para> |
|
270 <orderedlist><listitem><para><emphasis role="strong">Add a Repository</emphasis> – To add a new repository, type the name and the address (URL) of the repository. Click <guibutton>Add</guibutton>.</para> |
|
271 </listitem> |
|
272 <listitem><para><emphasis role="strong">Remove a Repository</emphasis> – To remove a repository, click a repository name from the list to select it. Click <guibutton>Remove</guibutton>.</para> |
|
273 <note><para>A repository that has been set as the preferred repository cannot be removed. To remove a preferred repository, set a nonpreferred repository as preferred, and then remove the repository.</para> |
|
274 </note> |
|
275 </listitem> |
|
276 <listitem><para><emphasis role="strong">Set a Preferred Repository</emphasis> – To set a repository as a preferred repository, click the radio button next to the repository that you would like to set as the preferred repository. Click <guibutton>Close</guibutton> if you are not making any other changes to the repository information.</para> |
|
277 </listitem> |
|
278 <listitem><para><emphasis role="strong">Modify a Repository</emphasis> – Perform the following steps to modify a repository :</para> |
|
279 <orderedlist><listitem><para>Select the repository that you want to modify.</para> |
|
280 </listitem> |
|
281 <listitem><para>Click the <guibutton>Modify</guibutton> button.</para> |
|
282 <para> The <guilabel>Modify Repository</guilabel> dialog box is displayed.</para> |
|
283 </listitem> |
|
284 <listitem><para>Type a valid name and URL for the repository.</para> |
|
285 <para>A repository name is considered valid if it does not exist in the current list of repositories.</para> |
|
286 </listitem> |
|
287 <listitem><para>Click <guibutton>OK</guibutton> to save the changes and return to the <guilabel>Manage Repositories</guilabel> dialog box.</para> |
|
288 <para>Click <guibutton>Cancel</guibutton> to cancel your changes. You are returned to the <guilabel>Manage Repositories</guilabel> dialog box.</para> |
|
289 </listitem> |
|
290 </orderedlist> |
|
291 </listitem> |
|
292 </orderedlist> |
|
293 </listitem> |
|
294 </orderedlist> |
|
295 </sect1> |
|
296 </chapter> |
|
297 <chapter><title>Update Manager</title> |
|
298 <highlights><para>The <application>Update Manager</application> is a separate application that launches from the desktop when updates to the installed packages are available in the repository.</para> |
|
299 </highlights> |
|
300 <sect1><title>Working With Update Manager</title> |
|
301 <figure id="ghqbx"><title>Update Manager Main Window</title> |
|
302 <mediaobject><imageobject><imagedata fileref="figures/update_all.png" /></imageobject> |
|
303 </mediaobject> |
|
304 </figure> |
|
305 <para>You can use the <application>Update Manager</application> application to update the installed packages in your image.</para> |
|
306 <note><para>For the OpenSolaris 2008.11 release, the <application>Update Manager</application> updates <emphasis role="strong">all</emphasis> installed packages in the image. This is equivalent to updating the image.</para> |
|
307 </note> |
|
308 <orderedlist><listitem><para>When updates are available to the installed packages, a notification icon is displayed in the notification panel on the OpenSolaris desktop and the <guilabel>Update Manager</guilabel> window is displayed.</para> |
|
309 <para> You can also click <menuchoice><guimenu>System</guimenu><guisubmenu>Administration</guisubmenu><guimenuitem>Update Manager</guimenuitem></menuchoice> to manually launch the Update Manager.</para> |
|
310 </listitem> |
|
311 <listitem><para>Click the <guibutton>Update All</guibutton> button in the <guilabel>Update All</guilabel> window to begin the process of updating your image.</para> |
|
312 <para>Select a package and click the <guilabel>Details</guilabel> panel if you want to view more information about the package.</para> |
|
313 </listitem> |
|
314 <listitem><para>The <guilabel>Update All</guilabel> window is displayed. Click <guibutton>Proceed</guibutton> to create a new boot environment and update all packages in the current image.</para> |
|
315 <para>During the Update All process, a clone of the active boot environment is created. This clone enables the user to boot into the boot environment state that existed before the Update All process was started. </para> |
|
316 <para>Click <guibutton>Cancel</guibutton> to cancel the process.</para> |
|
317 <para>If the Package Manager is unable to create a new boot environment, an error message will be displayed. See the <xref linkend="ghquj"/> section on how to rectify the error and continue with updating your image.</para> |
|
318 <note><para>A name for the new boot environment is automatically generated.</para> |
|
319 </note> |
|
320 </listitem> |
|
321 <listitem><para>If you chose to proceed, the <guilabel>Installing Updates</guilabel> windows are displayed. There are four stages to the package installation process:</para> |
|
322 <orderedlist><listitem><para>Evaluate.</para> |
|
323 </listitem> |
|
324 <listitem><para>Download.</para> |
|
325 </listitem> |
|
326 <listitem><para>Install.</para> |
|
327 </listitem> |
|
328 <listitem><para>Index.</para> |
|
329 </listitem> |
|
330 </orderedlist> |
|
331 <para>You can choose to cancel the process only during the Evaluate and Download stages. Click the <guibutton>Cancel</guibutton> button to cancel the installation process. No changes are made and you are returned to the main window of the Update Manager.</para> |
|
332 <note><para>If an error occurs during any of the stages, the <guilabel>Details</guilabel> panel is expanded and the details of the error are displayed. An error status indicator is shown next to the failed stage.</para> |
|
333 </note> |
|
334 </listitem> |
|
335 <listitem><para>Click the <guilabel>Details</guilabel> panel to view more information on each of the installation processes.</para> |
|
336 </listitem> |
|
337 <listitem><para>Read the <ulink url="http://opensolaris.org/os/project/indiana/resources/relnotes/200811/x86/">Release Notes</ulink> before rebooting your system.</para> |
|
338 <warning role="caution"><para>You must reboot your system for the changes to take effect.</para> |
|
339 </warning> |
|
340 </listitem> |
|
341 </orderedlist> |
|
342 <sect2 id="ghquj"><title>Update All Errors (Update Manager)</title> |
|
343 <para>A new boot environment clone <emphasis role="strong">must</emphasis> be created for the Update All 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 :</para> |
|
344 <para><literal>Not enough disk space: the Update All action cannot be performed. Click OK to launch BE Management to manage your existing BEs and free up disk space.</literal>.</para> |
|
345 <para>Click <guibutton>No</guibutton> to cancel the Update All process and return to the Update Manager main window.</para> |
424 <para>Click <guibutton>No</guibutton> to cancel the Update All process and return to the Update Manager main window.</para> |
346 <para>Perform the following steps if you want to rectify the error and continue with the Update All process: </para> |
425 <para>Perform the following steps if you want to rectify the error and continue with the Update All process: </para> |
347 <orderedlist><listitem><para>Click <guibutton>Yes</guibutton> in the error dialog to go to the <literal>Boot Environment Management</literal> dialog.</para> |
426 <orderedlist><listitem><para>Click <guibutton>Yes</guibutton> in the error dialog box to go to the <literal>Boot Environment Management</literal> dialog.</para> |
348 <para>Click <guibutton>Close</guibutton> to cancel the process and return to the main window.</para> |
427 </listitem> |
349 </listitem> |
428 <listitem><para>Go to step 2 in the <xref linkend="gilfh"/> section. Follow the instructions to delete old or unused boot environments and free up disk space.</para> |
350 <listitem><para>If you chose to rectify the error, go to step 2 in the <xref linkend="ghmya"/> section. Follow instructions to delete old or unused boot environments and free up disk space.</para> |
|
351 </listitem> |
429 </listitem> |
352 <listitem><para>Click the <guibutton>Update All</guibutton> button in the <literal>Update Manager</literal> window to restart the process of updating all packages.</para> |
430 <listitem><para>Click the <guibutton>Update All</guibutton> button in the <literal>Update Manager</literal> window to restart the process of updating all packages.</para> |
353 </listitem> |
431 </listitem> |
354 </orderedlist> |
432 </orderedlist> |
355 </sect2> |
433 </sect2> |
356 </sect1> |
434 </sect1> |
357 </chapter> |
435 </chapter> |
358 <glossary id="glossary-1"><title>Image Packaging System Glossary</title> |
436 <glossary id="glossary"><title>Image Packaging System Glossary</title> |
359 <glossentry><glossterm>authority</glossterm> |
437 <glossentry><glossterm>publisher</glossterm> |
360 <glossdef lang="en"><itemizedlist><listitem><para>A person, group, or corporation that designs, creates, and publishes a package to a repository.</para> |
438 <glossdef lang="en"><itemizedlist><listitem><para>A person, group, or corporation that designs, creates, and publishes a package to a repository.</para> |
361 </listitem> |
439 </listitem> |
362 <listitem><para>A location that is configured to point to a repository and might contain additional information about the package, such as the publisher of the package. The repository, in turn, serves the packages from the (default) authority, for downloading purposes. The developer-quality packages managed by Sun and made available through http://pkg.opensolaris.com is an example of an authority.</para> |
440 <listitem><para>A location that is configured to point to a repository and might contain additional information about the package, such as the publisher of the package. The repository in turn serves the packages from the (default) authority, for downloading purposes. The developer-quality packages managed by Sun and made available through http://pkg.opensolaris.com is an example of an authority.</para> |
|
441 <note><para>Before the 2009.06 release, the term <emphasis>authority</emphasis> was used instead of <emphasis>publisher</emphasis>.</para> |
|
442 </note> |
363 </listitem> |
443 </listitem> |
364 </itemizedlist> |
444 </itemizedlist> |
365 </glossdef> |
445 </glossdef> |
366 </glossentry> |
446 </glossentry> |
367 <glossentry><glossterm>boot environment</glossterm> |
447 <glossentry><glossterm>boot environment</glossterm> |
368 <glossdef><para>For an OpenSolaris release, a boot environment is an instance of a bootable OpenSolaris environment. The boot environment consists of a root file system and, optionally, other file systems, such as <filename>/usr</filename>, <filename>/var</filename>, or <filename>/export</filename>. These other file systems are mounted below the root file system. The root file system and all other file systems of the boot environment that contain system software are required to be zfs datasets.</para> |
448 <glossdef><para>For an OpenSolaris release, a boot environment is an instance of a bootable OpenSolaris environment. The boot environment consists of a root file system and, optionally, other file systems, such as <filename>/usr</filename>, <filename>/var</filename>, or <filename>/export</filename>. These other file systems are mounted below the root file system. The root file system and all other file systems of the boot environment that contain system software are required to be ZFS datasets.</para> |
369 <para>The active boot environment is the one that is currently booted. Exactly one active boot environment can be booted. An inactive boot environment is not currently booted, but can be in a state of waiting for activation on the next reboot.</para> |
449 <para>The active boot environment is the one that is currently booted. Exactly one active boot environment can be booted. An inactive boot environment is not currently booted, but can be in a state of waiting for activation on the next reboot.</para> |
370 </glossdef> |
450 </glossdef> |
371 </glossentry> |
451 </glossentry> |
372 <glossentry><glossterm>clone</glossterm> |
452 <glossentry><glossterm>clone</glossterm> |
373 <glossdef><para>An exact copy. </para> |
453 <glossdef><para>An exact copy. </para> |