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.
  • Your Eclipse workbench must be Eclipse IDE for Java™ EE Developers version:
    • 4.5
    • 4.4.2
    • 4.4.1
    • 4.4.0
    • 4.3.2
    • 4.3.1
    • or equivalent

    For more information, see the system requirements.

  • If you have an earlier version of IBM WebSphere Application Server Developer Tools for Eclipse older than 8.5.5 installed (e.g. 8.0.4), you cannot update to version 8.5.5 or later. Uninstall all features of the earlier version and then install version 8.5.5 or later into your Eclipse workbench.
  • The developer tools for WebSphere Application Server version 7.0 and later 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
    If you install the developer tools for WebSphere Application Server version 7.0 or later 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:
  • Install from a remote repository.
    • 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.5 and later from Eclipse Marketplace.

    • Drag an Install icon from the Eclipse Marketplace or WASdev Community web page to your workbench.

      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), you can start the installation of WebSphere Application Server Developer Tools for Eclipse V8.5.5 and later by dragging the Install icon (This is a graphical icon of the Install icon.) for the tools version that you want to install from your web browser to your running workbench.

  • Install 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.5 and later and then install the product into an existing Eclipse workbench.

Installing from a remote repository

Before you begin

Ensure that your computer is connected to the Internet.

About this task

You can install the product from installation files 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 Liberty Developer Tools
  • IBM WebSphere Application Server V8.5 Developer Tools
  • IBM WebSphere Application Server V8.0 Developer Tools
  • IBM WebSphere Application Server V7.0 Developer Tools

Procedure

  1. Start your Eclipse 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.5 (and later) and then click Install. The Confirm Selected Features page opens.
    • 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.

Installing from downloaded installation files

You can download installation files and, if needed, install the downloaded installation files while not connected to the internet.

Before you begin

If you are not connected to the internet during the installation, then you must first download and install prerequisite Eclipse files before you install WebSphere Application Server Developer Tools for Eclipse.
  • For Eclipse Mars, complete the following steps:
    1. Download the following prerequisite files for Version 4.5:
    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.

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

      Note: You can overwrite any files that have the same name.

      When you are finished, the extracted files will be in the existing directories of your Eclipse IDE:

      • eclipse (For example, C:\eclipse-jee-mars-1-win32-x86_64\eclipse.)
      • eclipse\plugins (For example, C:\eclipse-jee-mars-1-win32-x86_64\eclipse\plugins.)
      • eclipse\features (For example, C:\eclipse-jee-mars-1-win32-x86_64\eclipse\features.)
    3. From a command line, restart your Eclipse IDE for Java EE Developers using the -clean option. For example, C:\eclipse-jee-mars-1-win32-x86_64\eclipse\eclipse.exe -clean

About this task

Perform the following steps to install the product into an existing Eclipse workbench from downloaded installation files.

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: https://www.ibm.com/developerworks/mydeveloperworks/blogs/wasdev/entry/download.
  2. Start your Eclipse workbench.
  3. Click Help > Install new software > Add.
  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.5 (and later) . If you do not want to install all features (for example, you are installing only the WebSphere Application Server V8.5 Liberty Tools feature), then expand the IBM WebSphere Application Server Developer Tools for Eclipse V8.5.5 (and later) node and select the features that you want to install.
    Tip: Ensure that you do not select IBM WebSphere Application Server Liberty Server Adapter.
    You can install the following features:
    Feature Description
    Dojo Toolkit (optional) Provides Dojo Toolkit for building Web 2.0 applications.
    Important: If you are installing from Eclipse Marketplace, then this option is not listed. If you are installing from the Eclipse Marketplace and want install Dojo Toolkit:
    1. Install IBM WebSphere Application Server Developer Tools for Eclipse.
    2. Start the product.
    3. Click Help > Install new software.
    4. In the Work with field, select All Available Sites from the list.
    5. Expand the WebSphere Application Server Developer Tools for Eclipse category and select Dojo Toolkit.
    6. Follow the prompts in the wizard to install the software.
    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.
    Web Services Development Tools - Liberty Tools for developing and testing JAX-WS Web services and clients for Liberty.
    WebSphere Application Server - Liberty Tools for developing and administering WebSphere Application Server - Liberty.
    WebSphere Application Server V8.5 Tools Tools for developing and administering WebSphere Application Server traditional V8.5.
    WebSphere Application Server V8.0 Tools Tools for developing and administering WebSphere Application Server traditional V8.0.
    WebSphere Application Server V7.0 Tools Tools for developing and administering WebSphere Application Server traditional V7.0.
  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.

Configuring the installation

About this task

After you install the software, you must complete the following required 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
        -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
        -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   
        -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 
        -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 in the following text:
        --launcher.XXMaxPermSize 
        320M
      • If you are using an Oracle 64-bit JRE, then change the value to 512M as shown in the following text:
        --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 V7.0 and later installation directory>\java\jre\bin\javaw.exe
      • For Linux:
        -vm
        <WebSphere Application Server V7.0 and later installation directory>/java/jre/bin/java
    8. Save and close the eclipse.ini file.
    9. Restart the workbench.

Procedure

  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
      -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
      -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   
      -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 
      -Dcom.ibm.ws.management.event.max_polling_interval=1000
  6. Locate the line --launcher.XXMaxPermSize and in theeclipse.ini file and modify the value:
    • If you are using an Oracle 32-bit JRE, then change the value to 320M as shown in the following text:
      --launcher.XXMaxPermSize 
      320M
    • If you are using an Oracle 64-bit JRE, then change the value to 512M as shown in the following text:
      --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 V7.0 and later installation directory>\java\jre\bin\javaw.exe
    • For Linux:
      -vm
      <WebSphere Application Server V7.0 and later installation directory>/java/jre/bin/java
  8. Save and close the eclipse.ini file.
  9. Restart the workbench.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: July 17, 2017 21:58

File name: t_install_wdt_eclipse.html