Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Equinox/p2/Admin UI Users Guide

About the Eclipse Provisioning RCP Agent

  • If you have not yet downloaded the Eclipse Provisioning RCP agent, see Getting started with M1.
  • The agent RCP application allows you to install (and uninstall) an Eclipse 3.3 SDK using the Equinox Provisioning framework that is being developed in the Equinox Incubator.
  • The agent application itself is structured on top of the provisioning framework, so you can (purposefully or inadvertantly) modify the agent application by manipulating it within the application.
  • The UI for the RCP app is based on a provisioning admin UI that is being used by the provisioning team to manipulate the environment. It is not intended to demonstrate any actual provisioning UI would be delivered in Eclipse.
  • The workflow we are trying to demonstrate is very narrow, yet the UI is more flexible in allowing you to add/remove repositories and profiles. Failures are brittle (vague error reporting that requires you to check your .log file).

Overview of the Eclipse Provisioning RCP Agent

  • The RCP shows three views:
    • The Metadata Repositories view shows those metadata repositories known by the provisioning infrastructure.
      • You can (and should) ignore those repositories located in your c:/equinox.prov directory. Those are the repositories containing the RCP agent application.
      • The repository of interest is the repository located on eclipse.org (http://download.eclipse.org/eclipse/equinox/provisioning/metadata/).
      • You may add or remove repositories using this view.
      • Expanding a metadata repository will show you the installable units (IU's) available for installing.
      • You may examine the properties of repositories or IU's
      • You may install an IU to a specified profile using drag and drop or the popup menu.
    • The Artifact Repositories view shows those artifact repositories known by the provisioning infrastructure.
      • You can (and should) ignore those repositories located in your c:/equinox.prov directory. Those are the repositories containing the RCP agent application.
      • The repository of interest is the repository located on eclipse.org (http://download.eclipse.org/eclipse/equinox/provisioning/artifacts/artifacts.xml).
      • You may add or remove repositories using this view.
      • Expanding an artifact repository will show you what artifacts are located there
      • You may examine the properties of the repository
      • You can't examine the properties of the artifacts or otherwise manipulate them (yet)
    • The Profiles view shows profiles defined for installing software. Profiles are the target of an install operation.
      • The EquinoxProvisioningUI profile represents the agent application itself. It contains the IU's (bundles) that comprise the RCP app.
      • You may add or remove profiles using this view.
      • Expanding a profile shows you what IU's have been installed in the profile.
      • You may examine and change the properties of profiles and IU's.
      • You may uninstall an IU from a profile using the popup menu.
  • The Window>Preferences... menu item lets you control some application preferences:
    • You can control whether drag and drop operations should be confirmed first
    • You can control whether you view all IU's in the repositories and profiles, or just those that have been marked as a "group" IU. Viewing groups only helps reduce the clutter when you are trying to find something like the SDK.

Installing the Eclipse 3.3 SDK using the Provisioning RCP Agent

Cool stuff you can try

Back to the top