Installing and updating into an existing Eclipse workbench

You can install IBM® WebSphere® Application Server Developer Tools for Eclipse into an existing Eclipse workbench from Eclipse Marketplace (Help > Eclipse Marketplace) or from downloaded installation files. You can also update IBM WebSphere Application Server Developer Tools for Eclipse installed into an existing Eclipse workbench.

Before you begin

Ensure that your computer meets the system requirements for the software that you are installing.
Restriction: You cannot install into an existing Eclipse 3.6.2 that uses a version 1.7 JRE; the installation does not complete or has errors.
You can complete the installation by making either of the following changes:
  • Update to Eclipse 3.7.2, 3.8.1 or 4.2.1:
    1. Update Eclipse.
    2. In the eclipse.ini, file add the following text after the -vmargs line: -Djava.util.Arrays.useLegacyMergeSort=true
    3. Restart Eclipse and then install the package from inside Eclipse.
  • Switch to JRE 1.6 for the installation, then switch back to JRE 1.7 after the installation completes.
Important: The developer tools for WebSphere Application Server version 7.0, 8.0, or 8.5 are supported on Windows and Linux operating systems only. If you attempt to install these tools on another type of operating system, then you will get an error similar to the following example during the installation:
Cannot complete the install because some dependencies are not satisfiable
com.ibm.websphere.wdt.st.v7.feature.group ____ cannot be installed in this environment because its filter is not applicable
Important: If you install the developer tools for WebSphere Application Server version 7.0, 8.0, or 8.5 on a form of Linux operating system that is not supported (for example, Ubuntu), you will not get an error message during the installation, but the tools will not work.

About this task

You can install the software using any of the following methods:
Method When to use
Find and install the remote installation files from your Eclipse workbench. Use your workbench to locate and install the installation files for WebSphere Application Server Developer Tools for Eclipse V8.5.1 from Eclipse Marketplace.
Drag an Install icon from the Eclipse Marketplace or WASdev Community web page to your workbench (Eclipse 3.7.2, 3.8.1 or 4.2.1 only). From the Eclipse Marketplace web page (http://marketplace.eclipse.org/) or the WASdev community download page (https://www.ibm.com/developerworks/mydeveloperworks/blogs/wasdev/entry/download?lang=en), you can start the installation of WebSphere Application Server Developer Tools for Eclipse V8.5.1 by dragging the Install icon for the tools version that you want to install from your web browser to your running workbench.
Installing from downloaded installation files Use this method if you want to download the installation files for WebSphere Application Server Developer Tools for Eclipse V8.5.1 and then install the product into an existing Eclipse workbench.

Installing from a remote repository

About this task

You can install the product from installation files located in a remote repository by either using your Eclipse workbench find the installation files or by finding a link to the installation files on a web page.

The developer tools are available for the following versions of WebSphere Application Server:
  • IBM WebSphere Application Server v7.0 Developer Tools
  • IBM WebSphere Application Server v8.0 Developer Tools
  • IBM WebSphere Application Server v8.5 Developer Tools
  • IBM WebSphere Application Server v8.5 Liberty Profile Developer Tools

Procedure

  1. Start your Eclipse IDE for Java EE Developers workbench.
  2. Start the installation using either of the following methods.
    • Locate the installation files from your Eclipse workbench:
      1. Click Help > Eclipse Marketplace.
      2. In the Find field, type WebSphere.
      3. In the list of results, locate IBM WebSphere Application Server version Developer Tools V8.5.1 and then click Install. The Confirm Selected Features page opens.
    • (Eclipse 3.7.2, 3.8.1 or 4.2.1 only) Drag an Install icon from a web page to your Eclipse workbench:
      1. Open your web browser to http://www.ibm.com/wasdev and click the Download tab.
      2. Locate the Install icon (This is a graphical icon of the Install icon.) for IBM WebSphere Application Server version Developer Tools.
      3. Select and drag the Install icon to your Eclipse workbench, and drop it on the Eclipse toolbar. The Confirm Selected Features page opens.
  3. On the Confirm Selected Features page, expand the parent nodes and select the features that you want to install. When you are finished, click Next.
  4. On the Review Licenses page, review the license text. If you agree to the terms, click I accept the terms of the license agreement and then click Finish. The installation process starts.
    Note: During the installation, a Security Warning dialog box might open and display the following message:
    Warning: You are installing software that contains unsigned content. The authenticity or validity of this software cannot be established. Do you want to continue with the installation?
    You can safely ignore the message and click OK to continue.
  5. When the installation process completes, restart the workbench.

What to do next

  1. Configure the installation.
  2. If you purchased a license for the product (for example, you purchased a WebSphere Application Server bundle that includes WebSphere Application Server Developer Tools for Eclipse), then you must install a supported license. For instructions, see Converting an unlicensed version of WebSphere Application Server Developer Tools for Eclipse into a licensed version.

Installing from downloaded installation files

You can install the product into an existing Eclipse workbench from installation files that you downloaded to your computer. To the install the product while not connected to the Internet, you must download additional prerequisite Eclipse files.

Before you begin

Important: If your computer will not be connected to the Internet during the installation, then you must download and install prerequisite Eclipse files before you install WebSphere Application Server Developer Tools for Eclipse.
  1. Download the following files for your version of Eclipse IDE for Java EE Developers:
    Table 1. Prerequisites for offline installation of WebSphere Application Server Developer Tools for Eclipse.
    Files for version 3.6.2 Files for version 3.7.2 Files for versions 3.8.1 or 4.2.1
  2. For each compressed file that you downloaded in the previous step, extract the contents of the file into the eclipse directory of your Eclipse IDE for Java EE Developers. Ensure that you preserve the structure of the extracted contents.
    Tip: You can overwrite any files that have the same name.

    For example, if your eclipse directory is located in the file path C:\eclipse-jee-helios-SR2-win32\ , then you must extract the contents of each file into the directory C:\eclipse-jee-helios-SR2-win32\.

    When you are finished, the extracted files will be in the existing directories of your Eclipse IDE:
    • eclipse (For example, C:\eclipse-jee-helios-SR2-win32\eclipse.)
    • eclipse\plugins (For example, C:\eclipse-jee-helios-SR2-win32\eclipse\plugins.)
    • eclipse\features (For example, C:\eclipse-jee-helios-SR2-win32\eclipse\features.)
  3. From a command line, restart your Eclipse IDE for Java EE Developers using the -clean option. For example, C:\eclipse-jee-helios-SR2-win32\eclipse\eclipse.exe -clean
  4. For Eclipse 3.6.2 only Download and install additional prerequisites:
    1. Download the following file: wtp-repo-R-3.2.5-20111027122637.zip
    2. In your Eclipse IDE for Java EE Developers workbench, click Help > Install new software.
    3. In the Add Repository window, click Archive.
    4. Browse to the location where you downloaded wtp-repo-R-3.2.5-20111027122637.zip. Select the file wtp-repo-R-3.2.5-20111027122637.zip and then click Open.
    5. In the list of results, select Web Tools Platform (WTP) 3.2.5.
    6. Click Next.
    7. On the Review Licenses page, review the license text. If you agree to the terms, click I accept the terms of the license agreement and then click Finish. The installation process starts.
    8. When the installation process completes, restart the workbench.

About this task

You can install the product into an existing Eclipse workbench from installation files that you downloaded to your computer.

Procedure

  1. Download the .zip file of IBM WebSphere Application Server Developer Tools for Eclipse to a directory on your computer. The .zip file is available at: http://public.dhe.ibm.com/ibmdl/export/pub/software/websphere/wasdev/V8.5/wdtupdate
  2. Start your Eclipse IDE for Java EE Developers workbench.
  3. Click Help > Install new software.
  4. In the Add Repository window, click Archive.
  5. Browse to the location of the .zip file of IBM WebSphere Application Server Developer Tools for Eclipse. Select the file and then click Open.
  6. In the list of results, select IBM WebSphere Application Server Developer Tools for Eclipse V8.5. If you do not want to install all features (for example, you are installing only the WebSphere Application Server V8.5 Liberty Profile Tools feature), then expand the IBM WebSphere Application Server Developer Tools for Eclipse V8.5.1 node and select the features that you want to install.
    You can install the following features:
    Feature Description
    Dojo Toolkit (optional) Provides Dojo Toolkit for building Web 2.0 applications.
    OSGi Application Development Tools Provides tools for developing and maintaining OSGi-based applications and bundles
    Web Development Tools Develop web applications using the latest web technologies such as HTML5, CSS3, Dojo Toolkit, Servlet 3.0 and JSP 2.2.
    WebSphere Application Server V7.0 Tools Tools for developing and administering WebSphere Application Server V7.0.
    WebSphere Application Server V8.0 Tools Tools for developing and administering WebSphere Application Server V8.0.
    WebSphere Application Server V8.5 - Liberty Profile Tools for developing and administering WebSphere Application Server V8.5 - Liberty Profile
    WebSphere Application Server V8.5 Tools Tools for developing and administering WebSphere Application Server V8.5 Tools
  7. Click Next.
  8. On the Review Licenses page, review the license text. If you agree to the terms, click I accept the terms of the license agreement and then click Finish. The installation process starts.
    Note: During the installation, a Security Warning dialog box might open and display the following message:
    Warning: You are installing software that contains unsigned content. The authenticity or validity of this software cannot be established. Do you want to continue with the installation?
    You can safely ignore the message and click OK to continue.
  9. When the installation process completes, restart the workbench.

What to do next

  1. Configure the installation.
  2. If you purchased a license for the product (for example, you purchased a WebSphere Application Server bundle that includes WebSphere Application Server Developer Tools for Eclipse), then you must install a supported license. For instructions, see Converting an unlicensed version of WebSphere Application Server Developer Tools for Eclipse into a licensed version.

Configuring the installation

About this task

After you install the software, you must complete the following required configuration steps. There are also optional configuration steps.
Attention: These configuration steps require you to modify files. Create a backup copy of the files before you modify them.
  • Required configuration steps:
    1. Stop the workbench.
    2. Locate the eclipse.ini file in the <Eclipse installation directory>\eclipse directory, where <Eclipse installation directory> is the directory where you installed Eclipse.
    3. Make a copy of the eclipse.ini file, or back it up.
    4. Open the eclipse.ini file in a text editor.
    5. Locate the line -vmargs and add the following text immediately after it according to the following cases:
      • If you are using an IBM 32-bit JRE, then add the following text after the -vmargs line:
        -Xms100m
        -Xmx1024m
        -Xscmx48m
        -Xshareclasses:name=IBMSDP_%u
        -Xquickstart
        -Xgcpolicy:gencon
        -Xmnx64m
        -Djava.util.Arrays.useLegacyMergeSort=true
        -Dcom.ibm.ws.management.event.max_polling_interval=1000
      • If you are using an IBM 64-bit JRE, then add the following text after the -vmargs line:
        -Xms100m
        -Xmx1024m
        -Xscmx48m
        -Xshareclasses:name=IBMSDP_%u
        -Xcompressedrefs
        -Xquickstart
        -Xgcpolicy:gencon
        -Xmnx64m
        -Djava.util.Arrays.useLegacyMergeSort=true  
        -Dcom.ibm.ws.management.event.max_polling_interval=1000
      • If you are using an Oracle 32-bit JRE, then add the following text after the -vmargs line:
        -Xms100m
        -Xmx960m
        -XX:MaxPermSize=320m   
        -Djava.util.Arrays.useLegacyMergeSort=true
        -Dcom.ibm.ws.management.event.max_polling_interval=1000
      • If you are using an Oracle 64-bit JRE, then add the following text after the -vmargs line:
        -Xms100m
        -Xmx1024m
        -XX:MaxPermSize=512m   
        -Xmx1024m
        -XX:+UseCompressedOops 
        -Djava.util.Arrays.useLegacyMergeSort=true
        -Dcom.ibm.ws.management.event.max_polling_interval=1000
    6. Locate the line --launcher.XXMaxPermSize and in the eclipse.ini file and modify the value:
      • If you are using an Oracle 32-bit JRE, then change the value to 320M as shown below:
        --launcher.XXMaxPermSize 
        320M
      • If you are using an Oracle 64-bit JRE, then change the value to 512M as shown below:
        --launcher.XXMaxPermSize 
        512M
    7. If you installed any of the WebSphere Application Server Tools features, insert the following text immediately before the line with the text -vmargs:
      • For Windows:
        -vm
        <WebSphere Application Server V8.5, V8.0 or V7.0 installation directory>\java\jre\bin\javaw.exe
      • For Linux:
        -vm
        <WebSphere Application Server V8.5, V8.0 or V7.0 installation directory>/java/jre/bin/java
    8. Save and close the eclipse.ini file.
    9. Restart the workbench.
  • Optional configuration steps:

    To enhance local server support, complete the following steps:

    1. Close the workbench.
    2. Locate and back-up the config.ini file in the <Eclipse installation directory>\eclipse\configuration directory, where <Eclipse installation directory> is the path to the Eclipse installation directory.
    3. Open the config.ini file in a text editor.
    4. Locate the line eclipse.product=org.eclipse.sdk.ide and replace it with the following line:
      eclipse.product=com.ibm.websphere.wdt.product.site.ide
    5. Delete the following line: eclipse.application=org.eclipse.ui.ide.workbench
    6. Locate the line osgi.splashPath=platform\:/base/plugins/org.eclipse.platform and replace it with the following line:
      osgi.splashPath=platform\:/base/plugins/com.ibm.websphere.wdt.product.site
    7. Save and close the config.ini file.
    8. Modify the eclipse.ini file:
      1. In the <Eclipse installation directory>\eclipse directory, open the eclipse.ini file in a text editor. <Eclipse installation directory> is the path to the Eclipse installation directory.
      2. Delete the following lines:
        -showsplash
        org.eclipse.platform
      3. Delete the following lines, if they exist:
        -product
        org.eclipse.epp.package.jee.product
      4. Save and close the eclipse.ini file.
      5. Restart the workbench.

Feedback