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. Select Help > Eclipse Marketplace or install 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 minimum system requirements. For more information, see System requirements for WebSphere Application Server Developer Tools for Eclipse.
  • If you have an earlier version of IBM WebSphere Application Server Developer Tools for Eclipse installed, you cannot update an earlier release 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 8.5 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 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 feature version cannot be installed in this environment because its filter is not applicable.
    If you install the developer tools for WebSphere Application Server version 8.5 or later on a form of Linux operating system that is not supported, you receive an error message during the installation and the tools do not work. For example, Ubuntu is not supported.

About this task

You can install the software by 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 the Install icon from the Eclipse Marketplace web page to your workbench.

      From the Eclipse Marketplace web page (http://marketplace.eclipse.org/), 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 Developer Tools for Eclipse
  • IBM WebSphere Application Server Liberty Developer Tools
  • IBM WebSphere Application Server traditional V9 Developer Tools
  • IBM WebSphere Application Server traditional V8.5 Developer Tools

Procedure

  1. Start your Eclipse workbench.
  2. Start the installation.
    • 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.
  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

Configure the installation

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.

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 WebSphere Application Server Developer Tools Releases.
  2. Locate the entry that matches the Eclipse version that you are using and click on Get it now!.

    If there is more than one download, then choose the one that includes the tools for WebSphere Application Server traditional.

  3. Start your Eclipse workbench.
  4. Click Help > Install new software > Add.
  5. In the Add Repository window, click Archive.
  6. Browse to the location of the .zip file of IBM WebSphere Application Server Developer Tools for Eclipse. Select the file and then click Open.
  7. 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.
    You can install the following features:
    Feature Description
    OSGi Application Development Tools Provides tools for developing and maintaining OSGi-based applications and bundles.
    Web Development Tools Develop web applications by using the latest web technologies, such as HTML5, CSS3, Servlet 4.0, and JSP 2.3.
    Web Services Development Tools - Liberty Tools for developing and testing JAX-WS Web services and clients for Liberty.
    WebSphere Application Server Tools Tools for developing and administering WebSphere Application Server.
    WebSphere Application Server Liberty Tools for developing and administering WebSphere Application Server - Liberty.
    WebSphere Application Server traditional V9 Tools Tools for developing and administering WebSphere Application Server traditional V9.
    WebSphere Application Server traditional V8.5 Tools Tools for developing and administering WebSphere Application Server traditional V8.5.
  8. Click Next.
  9. 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.
  10. When the installation process completes, restart the workbench.

What to do next

  1. Configure the installation.
  2. Optionally install tools by using the Install WebSphere Software wizard.

    These tools come from IBM WebSphere Application Server Developer Tools for Eclipse update sites or the Eclipse Marketplace.

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.
  • The configuration steps are as follows:
    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 V8.5 and later installation directory>\java\jre\bin\javaw.exe
      • For Linux:
        -vm
        <WebSphere Application Server V8.5 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 V8.5 and later installation directory>\java\jre\bin\javaw.exe
    • For Linux:
      -vm
      <WebSphere Application Server V8.5 and later installation directory>/java/jre/bin/java
  8. Save and close the eclipse.ini file.
  9. Restart the workbench.