Installing the IBM® Engineering Workflow Management client in Eclipse by using the p2 installation repository

You can install the Engineering Workflow Management client into a supported version of Eclipse from the Help > Install New Software menu in Eclipse.

Before you begin

Install the required set of Eclipse patches. For instruction, see the Required Features in the Eclipse environment section of this Jazz.net article.
Note: Support for Eclipse 4.23 and Edge browser is available in EWM 7.0.2 iFix020 and later. You can use the EWM 7.0.2 iFix020 p2 Install Repository that is provided on the All Downloads page. To configure Eclipse to use the Edge web browser, add the following line to the eclipse.ini file.
Dorg.eclipse.swt.browser.DefaultType=edge

About this task

The p2 Install Repository is a .zip file that uses an Eclipse update site (or p2 repository) to get Engineering Workflow Management client features, bundles, and its EMF and GEF dependencies.

Procedure

  1. Download and install a supported version of Eclipse from http://download.eclipse.org/eclipse/downloads/ or one of the Eclipse mirror sites.
  2. Extract the .zip file to a directory. For example,
    • On Windows, extract to: C:\dev\eclipse-ewm
    • On Mac, extract to: /Users/YOUR_USERNAME/eclipse-ewm
  3. For Windows operating system, double-click the eclipse.exe executable file in C:\dev\eclipse-ewm to open it.
    • You need a Java Virtual Machine (JVM) version 8 or higher in your path for this to work. If needed, you can add the JVM path to the C:\dev\eclipse-ewm\eclipse.ini file by adding the following two lines to the file just before vmargs.
      -vm
      C:\path\to\java.exe
  4. For Mac operating system, double-click the Eclipse.app executable file in /Users/YOUR_USERNAME/eclipse-ewm to open it. You can also drag & drop the Eclipse app icon to Applications for quick access.
    • You need a Java Virtual Machine (JVM) version 8 or higher in your path for this to work. If needed, you can add the JVM path to the eclipse.ini file just before vmargs.
      -vm
      /path/to/java
    • To open the eclipse.ini file, follow the below steps.
    1. From Applications, right-click on the Eclipse app icon.
    2. Click Show Package Contents from the menu.
    3. Go to Contents > Eclipse and open the eclipse.ini file.
  5. From the Engineering Workflow Management downloads page, navigate to the respective 7.0.3 milestone page, click the All Downloads tab and download the p2 Install Repository.
  6. Start Eclipse and select Help > Install New Software.
  7. In the Available Software window, click Add. In the Add Repository window, click Archive and navigate to the p2 Install Repository .zip file that you downloaded in step 5. Click OK.
  8. In the next window, ensure that Group items by category is selected. Select Engineering Workflow Management Client (extend an Eclipse installation).
  9. Click Next, then Next again in the Install Details window.
  10. After you accept the terms of the license agreement, click Finish.
    A security warning window opens during the installation because the Engineering Workflow Management client bundles and features are not signed. Click OK to complete the installation. Click Restart Now when prompted to restart at the end of the installation.
  11. To install language packs for the client, download a Client for Eclipse IDE National Language Support Pack (NLS pack) from the Engineering Workflow Management downloads page.
    Tip: NLS Pack 1 contains translations in Brazilian Portuguese, French, German, Italian, Japanese, Korean, Simplified Chinese, Traditional Chinese, and Spanish. NLS pack 2 contains translations in Czech, Hungarian, Polish, and Russian. NLS pack 2a contains translation in Turkish.
  12. Select File > Exit to stop the client.
  13. Extract the language pack .zip file to a folder named dropins under the Eclipse directory created in step 2. For example,
    • On Windows, extract to: C:\dev\eclipse-ewm\eclipse\dropins
    • On Mac, extract to: /Users/YOUR_USERNAME/eclipse-ewm/Eclipse.app/Contents/Eclipse/dropins
  14. If the system locale for your operating system is already in the language you want to launch Eclipse in, all you have to do is to launch Eclipse normally, and the language packs are loaded . If the system locale is in English and you want to launch Eclipse in another language (for example, French), you must launch Eclipse with the -nl command line argument. For example,
    • On Windows:
      eclipse.exe -nl fr
    • On Mac:
      ./eclipse -nl fr