Task 3.1.1 Upgrade using the Update Wizard

Workbench for Eclipse, built on Eclipse technology, offers an Update Wizard that allows users to update Workbench for Eclipse in place, alleviating the need to reinstall. The Update Wizard gets updates from an update repository, also known as a p2 repository.

Warning

The Update Wizard can be used to apply maintenance only after an initial install of the 20.x.x release has been performed.

The following options exist for end users to upgrade via the Upgrade Wizard:

. If you have BMC AMI Common Enterprise Services (CES) installed,
CESoffers a feature called Update Center that allows updates to be centrally administered, greatly simplifying the update experience for end users by alleviating the need to manually configure a p2 repository.
Task-3-1-2-Upgrade-using-the-Reinstall-method. Each user can manually configure Workbench for Eclipse to get updates from a p2 repository.

Important

If the release you are upgrading to contains new features, after performing a Check for Updates the new features must be installed. See Adding-and-removing-Workbench-features.

Obtain updates via CES Update Center

CESis the recommended solution for managing Workbench for Eclipse configuration across multiple machines within an organization. When Workbench for Eclipse is configured to use CES, upon startup, Workbench for Eclipse performs an automatic synchronization with CESto retrieve a variety of configuration settings from CES, including p2 repositories.

You can configure Workbench for Eclipse to use CESby specifying the CES URL in either of the following places:

- When prompted during Workbench for Eclipse installation.
In the Workbench for Eclipse client (or an Eclipse IDE), from the Window menu, select Preferences > BMC> Common Enterprise Services.

To obtain updates via CES

Launch Workbench for Eclipse.
Ensure CES Synchronization has occurred. This happens automatically during Workbench for Eclipse startup, but can also be invoked on-demand from the Window menu, by selecting Preferences > BMC > Common Enterprise Services > Sync > Finish. If your CES administrator has configured a Workbench for Eclipse p2 Update Site, synchronizing will automatically update your available software sites, which references the p2 update repository configured in CES.
Update Workbench for Eclipse by following these steps:
1. From the Help menu, select Check for Updates.
2. If there are updates available, the Available Updates dialog will display the updates selected.
  Warning
  It is important to select all of the Workbench for Eclipse updates so that all Workbench for Eclipse features are at the same version, otherwise Workbench for Eclipse may not function properly.
  Important
  If the release you are upgrading to contains new features, after performing a Check for Updates the new features must be installed. See Adding-and-removing-Workbench-features.
3. Click Next and follow the wizard instructions to completion.
  Important
  If you want to be notified when new updates are available, from the Window menu, select Preferences > Install/Update > Automatic Updates. Check Automatically find new updates and notify me to activate automatic update checking.

Obtain updates from a p2 repository

BMC provides the Workbench for Eclipse p2 repository from the product order email or on BMC Support Center.

Warning

When updating the Code Pipeline or the Data Studio features in an Eclipse-based IDE, the following Software Sites must also be included and enabled:

For Photon
http://download.eclipse.org/releases/photon
http://download.eclipse.org/eclipse/updates/4.8
For higher Eclipse levels use the equivalent level download site.

To update Workbench for Eclipse, or the plug-ins in an Eclipse IDE, from a p2 repository

Download the p2 repository zip file via one of the following methods:
- From the Workbench for Eclipse p2 repository link in the Workbench for Eclipse product order email.
- From the Products > Workbench for Eclipse page under Downloads on the BMC Support Center.
Unzip (extract) the downloaded file to a directory location.
Launch Workbench for Eclipse (or an Eclipse IDE).
Add the unzipped p2 repository folder as a software site.
      a. From the Window menu, select Preferences > Install/Update > Available Software Sites.
      b. Click Add > Local and browse to the p2 repository folder (software site) that was unzipped/extracted earlier.
      c. Enter a name in the Name field. Click OK.
From the Help menu, select Check for Updates.
1. If there are updates available, the Available Updates dialog will display the updates selected.
  Warning
  It is important to select all of the Workbench for Eclipse updates so that all Workbench for Eclipse features are in the same version, otherwise Workbench for Eclipse may not function properly.
2. Click Next and follow the Available Updates wizard instructions to completion.