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 ( ) 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:
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.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
About this task
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.
- 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
What to do next
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
- For Eclipse Mars, complete the following steps:
- Download the following prerequisite files for Version 4.5:
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.)
- 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
Procedure
What to do next
- Configure the installation.
- 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
- Required configuration steps:
- Stop the workbench.
- Locate the eclipse.ini file in the <Eclipse installation directory>\eclipse directory, where <Eclipse installation directory> is the directory where you installed Eclipse.
- Make a copy of the eclipse.ini file, or back it up.
- Open the eclipse.ini file in a text editor.
- 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
- If you are using an IBM 32-bit
JRE, then add the following text after the -vmargs line:
- 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
- If you are using an Oracle 32-bit JRE, then change the
value to 320M as shown in the following text:
- If you installed any of the WebSphere Application
Server Tools features, insert the following text immediately before
the line with the text -vmargs:
:
-vm <WebSphere Application Server V7.0 and later installation directory>\java\jre\bin\javaw.exe
:
-vm <WebSphere Application Server V7.0 and later installation directory>/java/jre/bin/java
- Save and close the eclipse.ini file.
- Restart the workbench.