Difference between revisions of "Equinox/p2/Update UI Users Guide"

From Eclipsepedia

< Equinox‎ | p2
Jump to: navigation, search
(Launching the new update UI)
 
(6 intermediate revisions by 2 users not shown)
Line 2: Line 2:
  
 
== About the Equinox p2 Update UI ==
 
== About the Equinox p2 Update UI ==
If we're doing our job right, we won't need a user's guide for end-users to figure out the update UI!  Nevertheless, this page is provided as a step by step for getting software into your running Eclipse SDK using the new UI.
+
If we're doing our job right, we won't need a user's guide for end-users to figure out the update UI!  Nevertheless, this page provides pointers to documentation for the Eclipse update manager.
  
== Launching the new update UI ==
+
== Eclipse Help ==
The Update UI is located in the help menu (where the old update manager used to be).  The main difference you will notice is that there are no longer two menu items '''Find and Install...''' and '''Manage Configuration'''Instead, this information has been combined in one dialog, using tabs.
+
In a running Eclipse instance, you can access help by clicking the Help menu and selecting Help Contents. In the Contents pane, navigate to Workbench User Guide -> Tasks -> Updating and installing softwareAlternatively, the help is available [http://help.eclipse.org/galileo/index.jsp?topic=/org.eclipse.platform.doc.user/tasks/tasks-129.htm online].  The Eclipse 3.4 series (aka Ganymede) help is also available online [http://help.eclipse.org/ganymede/index.jsp?topic=/org.eclipse.platform.doc.user/tasks/tasks-129.htm here].
 
+
    [[Image:P2MenuItem.jpg]]
+
 
+
The UI shows you what you currently have installed...
+
 
+
    [[Image:P2InstalledList.jpg]]
+
 
+
...and what is available for install.
+
 
+
    [[Image:P2AvailableList.jpg]]
+
 
+
What is available is controlled by what sites you have connected to. Clicking on '''Manage sites...''' will let you add and remove sites. (For those of you familiar with p2 concepts, a "site" is a colocated metadata and artifact repository.)  For those of you who aren't, a "site" is a place where you can get cool software, much like an Update Manager site.  In fact, p2 can read Update Manager sites.
+
 
+
    [[Image:P2ManageSites.jpg]]
+
 
+
Let's look again at the install list:
+
 
+
[[Image:P2InstalledList.jpg]]
+
 
+
If you select something in this list, you can check to see if there are updates available for itYou can also try to uninstall it. You can review its properties (the description of what it is, who provided it, etc.) At the bottom you can control whether the system should automatically look for updates to what you have installed.  There is also a link to the preference page that lets you control the schedule for updating and other preferences related to updating.
+
 
+
[[Image:P2UpdatePrefs.jpg]]
+
 
+
== Installing and Uninstalling ==
+
When you choose to install or uninstall something, you'll first get a progress indicator while the system figures out if installing or uninstalling is allowed, given your current setup. Once this work is done, you'll either be notified that you can't do what you tried to do, or you'll get a dialog confirming what you are trying to do, and showing you some additional information. For example, here's what you might see if you tried to install the p2 agent and the relengtools...
+
 
+
[[Image:P2InstallDialog.jpg]]
+
 
+
From here, you can install all of the items, some of them, or just cancel.  Suppose you decided you didn't need the releng tools after all.  You can check only the agent and then continue with the install. 
+
 
+
== Updating ==
+
You can always check for updates of your installed software from the installed software list.
+
 
+
  [[Image:P2CheckUpdates.jpg]]
+
 
+
If updates are available, you'll see a list of what can be updated:
+
 
+
  [[Image:P2UpdateDialog.jpg]]
+
 
+
You can also set up the preferences so that the system automatically checks for updates. In this case, it will notify you with a popup that updates are available.
+
 
+
  [[Image:P2UpdateNotify.jpg]]
+
 
+
If you click the popup link to check for updates, you'll see the same list you saw when you checked manually.
+
 
+
  [[Image:P2UpdateDialog.jpg]]
+
  
 
== For more information ==
 
== For more information ==

Latest revision as of 15:27, 3 January 2011

Contents


[edit] About the Equinox p2 Update UI

If we're doing our job right, we won't need a user's guide for end-users to figure out the update UI! Nevertheless, this page provides pointers to documentation for the Eclipse update manager.

[edit] Eclipse Help

In a running Eclipse instance, you can access help by clicking the Help menu and selecting Help Contents. In the Contents pane, navigate to Workbench User Guide -> Tasks -> Updating and installing software. Alternatively, the help is available online. The Eclipse 3.4 series (aka Ganymede) help is also available online here.

[edit] For more information

If you encounter bugs, or would like to enter enhancement requests for this work, please use the Equinox Incubator category in Bugzilla. You can add the prefix "[prov]" to the subject line of the bug report to help us with bug triage.