diff -r f68acb39f2bf -r e46d4e51d02f src/gui/help/C/package-manager.xml.in --- a/src/gui/help/C/package-manager.xml.in Wed Dec 16 10:34:01 2009 -0600 +++ b/src/gui/help/C/package-manager.xml.in Thu Dec 17 08:27:14 2009 +0000 @@ -1,6 +1,6 @@ -OpenSolaris 2009.06 Package Manager Online Help +OpenSolaris 2010.03 Package Manager Online Help OpenSolaris Publications @@ -13,33 +13,37 @@ 2009 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. -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. +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. This distribution may include materials developed by third parties. 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. -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. +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. The OPEN LOOK and Sun 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. 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. -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. +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. -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. -Cette distribution peut comprendre des composants développés par des tierces personnes. -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. -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. -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. -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. +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. +Cette distribution peut comprendre des composants développés par des tierces personnes. +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. +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. +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. +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. 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. About the Package Manager -Welcome to the OpenSolaris 2009.06 Package Manager online help! -Use this help contents to learn how to use the Package Manager. Navigate through this help by clicking the topics displayed in the sidebar. -The OpenSolaris 2009.06 Package Manager application is a graphical user interface for the Image Packaging System (IPS) software. +Welcome to the OpenSolaris 2010.03 Package Manager online help! +Use the help contents to learn how to use the Package Manager. Navigate through this help by clicking the topics displayed in the sidebar. +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. +
Package Manager + + +
The Package Manager enables you to perform the following tasks: -Search, install, and remove packages +Install, remove, and search for packages Update your system -Add and modify repositories +Add and manage publishers Create, remove, and manage boot environments @@ -48,149 +52,189 @@ About Image Packaging System Image Packaging System (IPS) is 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. -The OpenSolaris 2009.06 release uses IPS as its packaging system. -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. +The OpenSolaris 2010.03 release uses IPS as its packaging system. +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. Users can use IPS to install packages from a repository, create and publish their own IPS packages, mirror an existing repository, and publish existing packages to a repository. Once you have installed packages, IPS enables you to search, update, and manage packages on your system. 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. The Package Manager provides a subset of the tasks that can be performed from the command-line. -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 . -For more information about IPS, see the Image Packaging System Guide and the IPS man pages. -Visit the project page on opensolaris.org and subscribe to pkg-discuss@sun.com to get involved with the IPS project. +If the system on which IPS is installed is on the network, IPS can automatically access the OpenSolaris publisher. For the OpenSolaris 2010.03 release, your IPS client can access the packages from . +For more IPS documentation, see the Image Packaging System Guide and the pkg man pages. +For more information about IPS, visit the project page. -The Package Manager Window -About the Package Manager Window -When you start the Package Manager, the following window is displayed. -
Package Manager Start Up Window - +Getting Started With Package Manager +When you start the Package Manager, a Start Page similar to the example below is displayed: +
Package Manager Start Page +
-The Start Page provides links to opensolaris.com page where you can get more information about OpenSolaris, subscribe to newsletters and join the OpenSolaris community. -To close the Start Page and see the list of packages , perform any of the following actions in the main window of the Package Manager: +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. +The Start Page also provides links to more information about the OpenSolaris project, subscribe to newsletters and join the OpenSolaris community. +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: Select a package category -Switch the top level category - -Switch the Show filter +Change the View drop-down menu Perform a search -Change the repository +Change the publisher Select ViewStart Page to return to the Start Page at anytime. -See the section to turn off the initial display of the Start Page when the Package Manager starts. +See to turn off the initial display of the start page when the Package Manager starts. -
List of Packages in the Package Manager Window - +About The Package Manager Window +
Package Manager Main View +
The main window of the Package Manager consists of the following elements : Menubar -You can access the menus on the menubar to perform all of the commands related to the Package Manager. +The menubar contains the menus and sub-menus required to perform all of the commands related to the Package Manager. Toolbar -The toolbar contains the icons for a subset of the commands that can be performed by using the menus on the menubar. ASearch box is also located on the toolbar. +The toolbar contains the icons for a subset of the commands that can be performed by using the menus on the menubar. A Search field is also located on the toolbar. You can perform the following actions from the toolbar : +Updates – Click Updates to check for and install the latest updates. + +Install/Update – Select a package and click Install/Update to install or update a package. - -List of Packages by Category -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 Applications-Desktop, Applications –Web—based, and Operating System. +Refresh – Click Refresh to reload the list of packages. + +Remove – Select a package and click Remove to remove a package. + +Search for a Package – Type the name or description of a package in the Search field to search for a package. See the section for examples on how to search for a package. + + -List of Packages by Status -The Show drop-down menu enables you to filter the list of packages by the following options : -All Packages – Shows the list of all packages available in the current repository. - -Installed Packages – Shows the list of packages installed on your system. +Publisher Drop-Down Menu +The list of available publishers is shown in the Publisher drop-down menu. Users can perform the following tasks from the publisher drop-down menu : +Select a publisher -Updates Available — Shows the list of packages that have newer versions available in the current repository. +View the list of packages installed from all publishers -Non-installed Packages – Shows the list of packages that are not installed, but are available in the currently selected repository. +Search for package across all publishers -Selected Packages – Shows the list of packages that you have selected. +Add a publisher -Package Name and Description -The list of packages in the selected category, a brief description, and their status are displayed here. +List of Packages by Category +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: +Applications + +Desktop (GNOME) + +Development + +Drivers + +System + +Web Services + + + + +Recent Searches +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. + + +List of Packages by Status +The View drop-down menu enables you to view package status with the following options : +All Packages – Shows the list of all packages available within the current publisher. + +Installed Packages – Shows the list of packages installed within the current publisher on your system. + +Updates — Shows the list of packages that have newer versions available within the current publisher. + +Not Installed Packages – Shows the list of packages that are not installed, but are available in the currently selected publisher. + +Selected Packages – Shows the list of packages that you have selected. + + + + +Package Name, Status, and Description +The list of packages in the selected category, a brief description, and their status are displayed in here. +The Publisher name is also displayed here in the following instances : +When the Pubisher drop-down menu is set to All Publishers (Installed) + +When search results are displayed for the All Publishers (Search) option + +When a recent search result is displayed + + Package Details 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. -Repository Drop-down Menu -The list of available repositories is shown in the Repository drop-down menu. Click a repository name to select it. + +
+ +Package Manager Settings +Use the EditPreferences to change the Package Manager settings. The following sections discuss the preferences that can be changed by the user. +Start Page Preferences +A Start Page is displayed in the main window of the Package Manager when the application is started. The Start Page provides links to opensolaris.com page where you can get more information about OpenSolaris, subscribe to newsletters and join the OpenSolaris community. +You can choose to turn off this setting so this page is not displayed when Package Manager starts. +Select EditPreferences from the main menu and uncheck the Show Start Page on Startup to disable the Start Page. This dialog is checked by default. +Select ViewStart Page from the main menu to go to the Start Page at anytime. + +Exit Preferences +The Package Manager application can remember some of its current settings if the Remember current state on exit option in the EditPreferences is checked. +The following settings are saved: +Vertical separators – The size of the columns in the main window the Package Manager - -Search Box -Search for a package is provided in the following contexts : -Search within the current repository +Window size – The size of the Package Manager window -Search across all configured repositories +Current publisher – The publisher that is selected when the Package Manager is closed - - - -Start Page Preferences -A Start Page is displayed in the main window of the Package Manager when the application is started. The Start Page provides links to opensolaris.com page where you can get more information about OpenSolaris, subscribe to newsletters and join the OpenSolaris community. -You can choose to turn off this setting so this page is not displayed when Package Manager starts. -Select EditPreferences from the menu and uncheck the Show Start Page on startup box to disable the Start Page. -Select ViewStart Page to go to the Start Page at anytime. +Confirmation Dialog Preferences +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 Show Confirmation Dialog uncheck On Updates, On Package Install/Update, and On Package Remove to turn these settings off. Working With Packages -Install a Package -The list of packages is displayed in the main windows of the Package Manager. Perform the following steps to install a package: -To install a single package, click on a package to select it. To install many packages, check the box next to the packages you want to install. +Install a Package +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: +Check the box next to the package or packages to select it. Double-clicking the package also selects the package. -Click the Install/Update icon in the toolbar to start the package installation process. +Click Install/Update to start the package installation process. You can also choose PackageInstall/Update to start the package installation process. -View the details or cancel the package installation . -Click Show Details to view the details. +Click Details to view the installation details or Cancel to cancel the package installation. -Click Cancel to cancel the package installation. No changes are made and you are returned to the main window. - - - -After the installation has completed, click Close on the Installation Completed dialog box to return to the main window. +After the installation has completed, click Close. Installation Error -If an error occurs during package installation, an error dialog box is displayed. An Installation Failed message and the reason for the failure is displayed. Click Close to close the error dialog box and return to the main window of the Package Manager. +If an error occurs during package installation, an error dialog with the error message is displayed along with the reason for failure. Click Close to close the error dialog. -Remove a Package +Remove a Package Perform the following steps to remove a package: -To remove a single package, click on a package to select it. To remove many packages, check the box next to the packages you want to remove. +Check the box next to a package to select it. Double-clicking the package also selects the package. -Click the Remove button in the toolbar to start the package uninstallation process. +Click Remove to start the package uninstallation process. You can also choose PackageRemove to remove a package. -Review the packages to be removed and the package dependencies details in the Remove Confirmation dialog box. - -Uninstall the package or cancel the uninstallation process. -Click Proceed to start uninstalling the packages. +Review the packages to be removed and the package dependencies details in the Remove Confirmation dialog. -Click Cancel to cancel the process. No changes are made and you are returned to the main window. -After you click the Proceed button, you cannot undo the package removal action. However, you can reinstall the package at any time. - - - +Click Proceed to start removing the packages or Cancel to cancel the process. -Search for a Package +Search for a Package You can search for a package in the following ways : -Search the current repository – Search for a package in the repository currently selected in the Repository drop-down menu. The category selection or the Show filter does not affect the search and the search is performed on all packages in the currently selected repository. -Enter a description, or a partial name in the Search box located on the toolbar. For example, you might type one of the following search terms to search for SUNWgnome-games : +Search the current publisher – Search for a package in the publisher currently selected in the Publisher drop-down menu. If you do not know the status of the package you are searching for, set the View drop-down menu to All Packages. +Enter a description, or a partial name in the Search field. For example, you might type one of the following search terms to search for SUNWgnome-games : SUNWgames games @@ -205,78 +249,111 @@ -Search all repositories – Select the multi-repository icon in the Search box to search for the package across all configured or registered repositories. -Note the following important considerations when using the multi-repository search. -The multi-repository search currently supports a search based on the package contents including its description, classification, and the files contained within the package. However, the correct results are displayed only if the term used for searching is an exact match. - -The multi-repository search does not search the package name. - -Wild card searching is supported by using the asterisk wild card, *, in the search term. Search using the wild card can be slower than an exact match search. - - - -Type a description of the package in the box. For example, the SUNWdiveintopython package is a book on Python programming. The description of the package contains the string book. To search for this package, you might then type one of the following terms: +Search all publishers – Choose All Publishers(Search) from the Publisher 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 View drop-down menu to All Packages. +Type a description of the package in the Search field. For example, the SUNWdiveintopython package is a book on Python programming. The description of the package contains the string book. To search for this package, you might then type one of the following terms: python book -If you searched for the term diveinto in the multi-repository search, the SUNWdiveintopython package will not be displayed as the term diveinto is not present as an independent, complete word in the package contents. However you will find the package using the * wild card. Hence, searching for the term diveinto* will display the SUNWdiveintopython package. +If you searched for the term diveinto when searching for the SUNWdiveintopython package, the results will not be displayed as the term diveinto is not present as an independent, complete word in the package contents. However you will find the package using the * wild card. Hence, searching for the term diveinto* will display the SUNWdiveintopython package. -Use the submenus under the Edit menu to cut, copy, paste, or clear text in the Search box. +Use the submenus under the Edit menu to cut, copy, or paste text in the Search field. + +The following operators are supported for a package search: +The AND operator + When the search term is separated by spaces or the AND operator, the Package Manager will search for packages containing all the search terms. + + +Double Quotes +When a search term is placed within double quotes, the Package Manager will search for packages that match the search term exactly. + + +Wildcard * +Including a wildcard in your search term enables you to search for partial package names. For example, when you enter boo* in your search term, the packages displayed could include boot and book in the package name and description. +Wildcard searching can be slower than an exact match search or a search based on package description. + -Use the icon on the right side of the Search box to clear the search results. + +The OR operator +When a search term is separated by the OR operator, the Package Manager searches for packages that contain any of the search terms. + + + + +Cancel Package Search +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. + +Update a Package +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 : +Select the Updates option in the View drop-down menu to list all packages that have updates available in the currently selected publisher. + +Select the Updates option in the View drop-down menu and the All Publishers (Installed) in the Publisher drop-down menu to list all packages that have updates available from all publishers. - +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. + +Select the package or packages you want to update and click Install/Update to install the latest version of the package. Use the Updates icon on the toolbar to update all packages on your system. -Update a Package -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 Install/Update button to install the latest version of the package. +Package Version Information +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 : +Installable Version – 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 Updates icon on the toolbar. + +Installed Version – The version of the package installed on the system. + +Latest Version – 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. + + + +View Installed Packages From All Publishers +Choose the All Publishers (Installed) from the Publisher drop-down menu filter to view a list of all packages that you have installed from all publishers. +You cannot search for a package from the All Publishers (Installed) option. Switch to All Publishers (Search) to search for a package. + -Introduction to Boot Environments +Introduction to Boot Environments A boot environment is an image that is bootable. Upon an initial OpenSolaris installation, a boot environment is created. - You can maintain multiple boot environments on your OpenSolaris 2009.06 system. Use the beadm(1) command from the command—line interface (CLI) to create, rename, mount or unmount, or destroy these boot environments. -The Package Manager enables you to manage the boot environments created during the process of updating your image. For more information, see section. -System administrators can maintain multiple boot environments on their systems, and each boot environment can have different software versions installed. + You can maintain multiple boot environments on your OpenSolaris 2010.03 system. Use the beadm(1) command from the command-line interface (CLI) to create, rename, mount or unmount, or destroy these boot environments. +The Package Manager enables you to manage the boot environments created during the process of updating your image. For more information, see section. +Users can maintain multiple boot environments on their systems, and each boot environment can have different software versions installed. When you use either the Package Manager or the pkg image-update 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. - See the beadm(1) man pages and the Upgrading and Managing Boot Environments document to learn more about boot environments and the beadm(1) command. + See the beadm(1) man pages and the Upgrading and Managing Boot Environments document to learn more about boot environments and the beadm(1) command. Update All Packages (Update Your Image) Perform the following steps to update all the packages in your image. -Click the Update All icon located on the toolbar to start the process of updating all the packages installed in your image. -You can also choose PackageUpdate All to start the process. -The Update All icon is enabled when updates are available to the installed packages. +Click Updates to start the process of updating all the packages installed in your image. +You can also choose PackageUpdates to start the process. +If no updates are available to your installed packages, a No Updates Available message is displayed after you click Updates. -A Create New Boot Environment window is displayed. A name for the new boot environment is automatically generated. - -(optional) You can change the name of the new boot environment if you want. +The process of updating all the packages installed on your system is completed in three phases: +Preparation -Confirm or Cancel the new boot environment. -Click Proceed to create a new boot environment and proceed with the Update All process. +Download -Click Cancel to cancel the process. +Install -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 section on how to rectify the error and continue with updating your image. +Click on the Details tab displayed in each of the phases to view more information. + +After the update process is completed successfully, an Update All Complete 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. +If the Package Manager is unable to create a new boot environment, an error message is displayed. See the section on how to rectify the error and continue with updating your image. -If you chose to proceed with the Update All process, the packages are downloaded and installed. -After a successful completion, the Update All Complete dialog box is shown. A link to the Release Notes is provided in the dialog box. Read the before rebooting your system. - Click Close. -You must reboot your system for the changes to take effect. + Click Restart Now to reboot your system immediately. +Click Restart Later to restart your system at a later time. You must reboot your system for the changes to take effect. +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. Update All Errors -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 : -Not enough disk space, the selected action cannot be performed. Click OK to manage your existing BEs and free up disk space or Cancel to cancel the action. -Click Cancel to cancel the Update All process and return to the main window. +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 : +Not enough disk space, the Update All action cannot be performed. Choose Manage BE to manage your boot environments and free up disk space.. +Click Close to cancel the Update All process. Perform the following steps if you want to rectify the error and continue with the Update All process: -Click OK to display the Boot Environment Management dialog box. +Click Manage BE to display the Manage Boot Environment dialog. Select the boot environments that you want to delete. You cannot delete the currently active boot environment. @@ -288,20 +365,20 @@ Click OK. -The Boot Environment Confirmation dialog is shown. Review your changes and click OK to proceed. +The Boot Environment Confirmation dialog is shown. Review your changes and click OK to proceed. -Click the Update All icon to restart the process of updating all packages. +Click Update All to restart the process of updating all packages. -Manage Boot Environments +Manage Boot Environments Perform the following steps to manage your boot environments: -Click FileManage Boot Environments to open the Manage Boot Environments dialog. +Click FileManage Boot Environments to open the Manage Boot Environments dialog. -In this dialog box , you can perform the following actions: -Activate a boot environment – Select the boot environment that you want to be active on system reboot. This will be the default boot environment after you have rebooted your system. +In this dialog, you can perform the following actions: +Activate a boot environment – Select the boot environment you want to be active on system reboot. This is the default boot environment after you have rebooted your system. -Remove old or unused boot environments to free up disk space – Select the boot environments that you want to delete. +Remove old or unused boot environments to free up disk space – Select the boot environnment or boot environments you want to delete. You cannot the delete the currently active boot environment. If you have selected a boot environment to be renamed, it cannot be deleted. @@ -309,7 +386,7 @@ -Rename a boot environment – Double-click the boot environment name that you want to change. Enter the new name of the boot environment and click OK. +Rename a boot environment – Double-click the boot environment name you want torename. Enter the new name of the boot environment and click OK. If you have selected a boot environment to be deleted, it cannot be renamed. The currently active boot environment cannot be renamed. @@ -319,19 +396,14 @@ -Accept or decline the changes: -Click OK to proceed. +Click OK to proceed or Cancel to cancel all changes. -Click Cancel to cancel all changes and return to the main window. - - - -The Boot Environment Confirmation dialog is displayed. Review your changes and click OK to proceed. +The Boot Environment Confirmation dialog is displayed. Review your changes and click OK to proceed. After you click OK, you cannot undo any changes that you made to the boot environments. The changes that you made to the default boot environment setting are effective only after system reboot. -Click Cancel to cancel the changes and return to the BE Management dialog box. +Click Cancel to cancel the changes. Reboot your system to boot into the newly activated boot environment. Reboot your system only if you changed the active boot environment. @@ -340,145 +412,218 @@ -Managing Repositories -Add a Repository -Perform the following steps to add a repository: -Choose FileManage Repositories. -You can also choose Add... from the Repository drop-down menu in the main window of the Package Manager. +Add and Manage Publishers +The FileManage Publishers dialog enables the user to add and manage the configured publishers. A publisher is a person, group, or corporation that designs, creates, and publishes a package to a repository. A repository is a source for packages. Every publisher has a origin URI (Universal Resource Identifier) associated with it. Read the following sections to learn how to add and manage publishers on your system. +Add a Publisher +Perform the following steps to add a publisher and its associated URI: +Choose FileAdd Publishers. +You can also choose the Add.. option from the Publisher drop-down menu or select FileManage Publishers and then click Add.. in the Manage Publishers dialog. + +The Add Publisher dialog is displayed. Enter the name of the publisher and the associated URI. If the publisher is a secure publisher, the SSL Key and SSL Certificate fields are displayed. Follow the steps in the section to add an SSL key and certificate. + +Click Add. + +The Adding Publisher dialog is displayed. Click Cancel to cancel the process. - The Manage Repositories dialog box is displayed. Type the name and the address (URL) of the repository you want to add. Click Add. +The Adding Publisher Complete dialog is displayed if the publisher is added successfully. + + +
An Adding Publisher Error is displayed if the publisher could not be added. Click Details to get more information about the error. +
+
+Remove a Publisher +Perform the following steps to remove a publisher: +Choose FileManage Publishers. + +Click on a publisher from the list to select it. Click Remove. + +The Manage Publishers Confirmation dialog is displayed. + +Click OK to save the changes and remove the publisher or Cancel to return to the Manage Publishers dialog without making any changes. -Add a Secure Repository -A secure repository requires a SSL key and certificate for access. Perform the following steps to add a secure repository: -Follow the steps in section to add a repository. +Set Publisher Priority +Perform the following steps to set or change the publisher priority: +Choose FileManage Publishers to open the Manage Publishers dialog. -Follow the steps in the section to add a SSL key and certificate. -. +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. +Packages are searched within the publishers in the order of priority, the publisher with the highest priority is searched first. + +Click OK to save your changes or Cancel to return to the Manage Publishers dialog without making any changes. -Remove a Repository -Perform the following steps to remove a repository: -Choose FileManage Repositories to open the Manage Repositories dialog. +Modify Publisher Alias +Perform the following steps to modify the alias of a publisher: +Choose FileManage Publishers. + +Select the publisher whose alias you want to modify. Click Modify... -Select a repository from the list. Click Remove. -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. - +The Modify Publisher dialog is displayed. Modify or enter a new name of the alias in the Alias field. + +Click OK to save your changes or Cancel to return to the Manage Publishers dialog without making any changes. + +Click OK in the Manage Publishers dialog to exit the dialog. Note that clicking Cancel in the Manage Publishers dialog will not undo the changes made in the Modify Publishers dialog. -Set a Preferred Repository -Perform the following steps to set a preferred repository: -Choose FileManage Repositories to open the Manage Repositories dialog. +Add Publisher Origins +Perform the following steps to add an origin or origins associated with a publisher: +Choose FileManage Publishers. + +Select the publisher whose origin you want to modify. The Details tab in the Manage Publishers dialog displays the origin associated with the publisher. -Click the radio button next to the repository that you would like to set as the preferred repository. +Click Modify... + The Modify Publisher dialog is displayed. Enter the name of the new origin you want to associate with the publisher in the Origin field. Click Add. The list of associated origins is displayed in the table. +You cannot change the origin URI after the origin has been added. + -Click Close if you are not making any other changes to the repository information. +(optional) If the origin you have added is a secure origin, add the SSL Key and SSL certificate. Browse to locate the SSL Key and SSL Certificate on your system. + +Click OK to save your changes or Cancel to return to the Manage Publishers dialog without making any changes. + +Click OK in the Manage Publishers dialog to exit the dialog. Note that clicking Cancel in the Manage Publishers dialog will not undo the changes made in the Modify Publishers dialog. -Modify a Repository -Perform the following steps to modify a repository: -Choose FileManage Repositories to open the Manage Repositories dialog. +Remove Publisher Origins +Perform the following steps to remove an origin or origins associated with a publisher: +Choose FileManage Publishers. -Select the repository that you want to modify. +Select the publisher whose origin you want to remove. The Details tab in the Manage Publishers dialog displays the origin or origins associated with the publisher. -Click the Modify button. - The Modify Repository dialog box is displayed. You can perform the following actions in the Modify Repository dialog box: -Change the URL of the repository – Type a valid URL for the repository. -You cannot change a repository name after you have added a repository. To change the repository name, delete the existing repository with the old name and add a repository with the new name. See the section for steps on how to remove a repository. +Click Modify... + The Modify Publisher dialog is displayed. The list of associated origins is displayed in the table. -Add a SSL Key and Certificate – A secure repository requires a SSL key and certificate for access. -The Instructions link in the Modify Repository dialog box links to a registration site which provides instructions for downloading the SSL key and certificate -In the Modify Repository dialog box, click the Instructions link to download the key and certificate. Save them on your system. +Select the origin you want to remove. Click Remove. +If only one origin is associated with a publisher, it cannot be removed. + -Click the Browse button to locate the SSL key on your system. +Click OK to save your changes or Cancel to return to the Manage Publishers dialog without making any changes. -Click the Browse button to locate the SSL certificate on your system. +Click OK in the Manage Publishers dialog to exit the dialog. Note that clicking Cancel in the Manage Publishers dialog will not undo the changes made in the Modify Publishers dialog. + +Add Publisher Mirrors +Perform the following steps to add a mirror for a publisher: +Choose FileManage Publishers. -Add a Mirror – If a repository has a mirror, add the repository name and URL, and then click the Modify button to add the mirror information. +Select the publisher for which you want to add the mirror. + +Click Modify... + The Modify Publisher dialog is displayed. - +Enter the URI for the mirror in the Mirror field. Click Add. + +Click OK to save your changes or Cancel to return to the Manage Publishers dialog without making any changes. + +Click OK in the Manage Publishers dialog to exit the dialog. Note that clicking Cancel in the Manage Publishers dialog will not undo the changes made in the Modify Publishers dialog. -Confirm or decline the changes. -Click OK to save the changes and return to the Manage Repositories dialog box. + + +Remove Publisher Mirrors +Perform the following steps to remove a mirror associated with a publisher: +Choose FileManage Publishers. + +Select the publisher for which you want to remove the mirror. -Click Cancel to cancel your changes. +Click Modify... + The Modify Publisher dialog is displayed. The list of associated mirrors is displayed in the table. - +Select the mirror you want to remove. Click Remove. + +Click OK to save your changes or Cancel to return to the Manage Publishers dialog without making any changes. + +Click OK in the Manage Publishers dialog to exit the dialog. Note that clicking Cancel in the Manage Publishers dialog will not undo the changes made in the Modify Publishers dialog.
Working With WebInstall -The OpenSolaris 2009.06 Package Manager provides support for users to add new repositories and optionally, install packages from these repositories using a simple one-click WebInstall process. A .p5i file which contains the repositories to be added and optionally, the package or packages that can be installed from these repositories, is required for the WebInstall process. The information contained in the .p5i file is read and used by the WebInstall process. -How to Use WebInstall to Add Repositories and Install Packages -Before You BeginLocate the .p5i file which may be present on your desktop, the Start page in the Package Manager, or on a website. -Start the Package manager in WebInstall mode in one of the following ways: +The OpenSolaris 2010.03 Package Manager provides support for users to add new publishers and optionally, install packages from these publishers using a simple one-click WebInstall process. A .p5i file which contains the publishers to be added and optionally, the packages that can be installed from these publishers, is required for the WebInstall process. The information contained in the .p5i file is read and used by the WebInstall process. +Export Package Selections as WebInstall Files +If you want to distribute some of the packages available on your system to others for easy installation and distribution, you can export the references to the packages, using the WebInstall process. The FileExport Selections feature enables you to create a .p5i file containing the installation instructions for the selected packages. The .p5i file is can then be distributed for use. See the section on how to install packages from a .p5i. +The following procedure lists the steps to create a .p5i file and export your files. +From the Publisher drop-down menu, select the publisher from which you want to include the packages in the .p5i file. + +Check the box next to the package or packages to select it. The packages selected are highlighted. + +Click FileExport Selections to display the Export Selections Confirmation window. + +Click OK to confirm the selections and proceed or Cancel to cancel the selections. + +The Export Selections window is displayed. + +A default name for the p5i file with the extension .p5i is provided. Click inside the Name field to change the name of the p5i file. + +The file is saved in the /tmp folder by default. Click the Browse for other folders tab to select your own folder. + +Choose the p5i Files option in the drop-down menu located at the bottom right hand side of the window. + + + +How to Use WebInstall to Add Publishers and Install Packages +The WebInstall process enables you to install packages through a p5i file. +Locate the .p5i file which may be present on your desktop, the Start page in the Package Manager, or on a website. + +Start the Package Manager in WebInstall mode in one of the following ways: Click on a .p5i file on your desktop, and the associated application, Package Manager in WebInstall mode, will be launched. Start the Package Manager from the command-line along with a path to the .p5i file. For example, type the following command at the command-line: -$ pfexec packagemanager/path_to_pi5_file/file.p5i +$ pfexec packagemanager/path_to_p5i_file/file.p5i -Click on a URL location that contains a link to .p5i file. If you are using this method to start the WebInstall, the .p5i file must be located on a web server that has registered the new mime type. Only then, the web server can manage the .p5i automatically and start Package Manager in WebInstall mode. +Click on a URL location that contains a link to .p5i file. If you are using this method to start WebInstall, the .p5i file must be located on a web server that has registered the new mime type. Only then, the web server can manage the .p5i automatically and start Package Manager in WebInstall mode. If the .p5i is located on a web server that does not have the new mime type registered, save the .p5i file to your desktop and then click on it to launch Web Install. - -The following example window that shows a list of repositories that will be added and the packages that will be installed. Review the information. -
Package Manager WebInstaller - + +You will see a window similar to the example window shown below. The window shows a list of publishers that will be added and the packages that will be installed. Review the information. + -
-
-Confirm or cancel the WebInstall process. -Click Proceed to add the new repositories and install the packages. -Click Cancel to cancel the process. The Package Manager application exits. - -(Optional) If the repositories that are to be added are secure repositories, an SSL key and certificate is required. An Add New Repositories dialog box is displayed. -Click the Instructions link in the Add New Repositories dialog box to download the SSL key and certificate. + +Confirm or cancel the WebInstall process. +Click Proceed to add the new publishers and install the packages. -Click the Browse button to locate the SSL key on your system. +The Add Publisher dialog is displayed. The name and URI of the publisher is already entered. +The Adding Publisher Complete dialog is displayed if the publisher has been added successfully. -Click the Browse button to locate the SSL certificate on your system. +(Optional) If the publishers to be added are secure publishers, an SSL key and certificate is required. Browse to locate the SSL Key and SSL Certificate on your system. Click OK to proceed. - -The Adding New Repositories status bar is displayed. - -(Optional) If packages are being installed, the Install/Update dialog box is displayed. Click Cancel to cancel the package installation. +If packages are being installed, the Install/Update dialog is displayed. The application will close when all packages are installed. - -
+
+
+
+Using WebInstall With a Disabled Publisher +Sometimes a .p5i file may contain packages from a disabled publisher. In such cases WebInstall opens up an Enable Publisher dialog which allows the user to enable the publisher before installing packages.
Working With the Update Manager About The Update Manager -The Update Manager is a separate application that starts from the desktop when updates to the installed packages are available in the repository. +The Update Manager is a separate application that starts from the desktop when updates to the installed packages are available in the publisher.
Update Manager Main Window - +
-You can use the Update Manager application to update the installed packages in your image. -For the OpenSolaris 2009.06 release, the Update Manager updates all installed packages in the image. This action is equivalent to running the pkg image-update command from the command-line. +You can use the Update Manager application to update the installed packages in your image. The Update Manager uses the publisher that is currently set in the Package Manager to install the latest image. +For the OpenSolaris 2010.03 release, the Update Manager updates all installed packages in the image. This action is equivalent to running the pkg image-update command from the command-line.
-Using the Update Manager +Using the Update Manager When updates are available to the installed packages, a notification icon is displayed in the notification panel on the OpenSolaris desktop. You can also click SystemAdministrationUpdate Manager to manually launch the Update Manager. When you are notified of a software update, perform the following steps to begin the process of updating your system: -Click the notification icon on the desktop to display the Update Manager window. +Click the notification icon on the desktop to display the Update Manager window. -Click the Update All button in the Update Manager window. +Click Update All in the Update Manager window. Select a package and click the Details panel if you want to view more information about the package. -The Update All dialog box is displayed. Proceed with the Update All process or cancel the action. +The Update All dialog is displayed. Proceed with the Update All process or cancel the action. Click Proceed to create a new boot environment and update all packages in the current image. 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 section on how to rectify the error and continue with updating your image. @@ -489,7 +634,7 @@ -If you chose to proceed, the Installing Updates windows are displayed. The package installation process consists of four stages: +If you chose to proceed, the Installing Updates windows are displayed. The package installation process consists of four stages: Prepare Download. @@ -497,12 +642,11 @@ Install. -You can choose to cancel the process only during the Prepare and Download stages. Click the Cancel button to cancel the installation process. No changes are made and you are returned to the main window of the Update Manager. +You can choose to cancel the process only during the Prepare and Download stages. +Click the Details panel to view more information about each of the installation processes. If an error occurs during any of the stages, the Details panel is expanded and the details of the error are displayed. An error status indicator is shown next to the failed stage. -Click the Details panel to view more information about each of the installation processes. - Read the before rebooting your system. You must reboot your system for the changes to take effect. @@ -511,35 +655,29 @@ Update All Errors A new boot environment clone must 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 : -Not enough disk space, the selected action cannot be performed. Click OK to manage your existing BEs and free up disk space or Cancel to cancel the action. -Click No to cancel the Update All process and return to the Update Manager main window. +Not enough disk space, the Update All action cannot be performed. Choose Manage BE to manage your boot environments and free up disk space.. +Click Close to cancel the Update All process. Perform the following steps if you want to rectify the error and continue with the Update All process: -Click Yes in the error dialog box to go to the Boot Environment Management dialog. +Click Manage BE in the error dialog to go to the Manage Boot Environments dialog. Go to step 2 in the section. Follow the instructions to delete old or unused boot environments and free up disk space. -Click the Update All button in the Update Manager window to restart the process of updating all packages. +Click Update All in the Update Manager window to restart the process of updating all packages. -
-Release Notes -The OpenSolaris 2009.06 Release Notes are available at the following locations: -x86 Release Notes - -SPARC Release Notes - - - -Package Manager Screencast -A screencast that shows Package Manager usage for beginners is available. Click the link below to go to the screencast. -OpenSolaris 2009.06 Package Manager Screencast +2010.03 Release Notes +The Release Notes for 2010.03 are available at the following location: . + Image Packaging System Glossary publisher -A person, group, or corporation that designs, creates, and publishes a package to a repository. The repository in turn serves the packages from the (default) publisher, for downloading purposes. The developer-quality packages managed by Sun and made available through http://pkg.opensolaris.com/dev is an example of a publisher. -The term authority has been replaced with the term publisher from the OpenSolaris 2009.06 release onwards. +A person, group, or corporation that designs, creates, and publishes a package to a repository. The repository in turn serves the packages from the (default) publisher, for downloading purposes. + + +repository +A location where clients can publish and retrieve package content such as files contained within the package, and package metadata which includes information about the package such as its name and description. boot environment @@ -565,13 +703,14 @@ A collection of files, directories, links, drivers, and dependencies in a defined format. -preferred repository -A default repository that is the source for packages. If a user does not explicitly specify a repository when installing and updating packages, the preferred repository is chosen as the source for packages. +origin +Location of a package repository specified by a URI. -repository -A location where packages are available for downloading. A publisher can publish packages to many repositories. +alias +An alternate name for a publisher. - \ No newline at end of file + +