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.

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

•  Upgrade using the Update Wizard if you have BMC AMI Common Enterprise Services ( CES ) installed,
• CES offers 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.
• Upgrade using the Reinstall method. Each user can manually configure Workbench for Eclipse to get updates from a p2 repository.

Obtain updates via CES Update Center

CES is 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 CES to retrieve a variety of configuration settings from CES, including p2 repositories.

You can configure Workbench for Eclipse to use CES by 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

1. Launch Workbench for Eclipse.
2. 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.
3. 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.

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

1. 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.
2. Unzip (extract) the downloaded file to a directory location.
3. Launch Workbench for Eclipse (or an Eclipse IDE).
4. 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.
5. 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.