Information about this tool can be obtained from the Geronimo development tools site and from the tool's on-line help. The following tips supplement that information.
About the WASCE WTP Server Adapters
WebSphere Application Server Community Edition Version 2 provides a new WASCE WTP server adapter which supports Version 1.1.0.x and Version 2.0.0.0 WebSphere Application Server Community Edition servers. These server runtimes can be downloaded from within eclipse after the appropriate WTP server adapter is installed. The Version 2 WASCE WTP server adapter may also be used to run Apache Geronimo Version 1.1.x and Version 2.0 servers, although this is not supported.
Compatible platforms
IBM has tested the WASCE WTP server adapter on Windows and Linux development environments supported by the Server runtime, running on Intel and AMD platforms with the provided IBM 32-bit Java software development kits (SDKs). The Eclipse IDE does support other platforms, which were not tested and therefore, cannot be recommended.
The tool may be compatible with other system platforms and operating system levels, but to obtain support for a suspected defect, you must demonstrate the defect on one of the recommended development platforms.
Installing the WASCE WTP Server Adapter
There are four options for installing the WASCE WTP Server Adapter:
- the "Download additional server adapters" link
- the Eclipse Update Manager
- the updatesite.zip file
- the deployable.zip file
Installing the WASCE WTP Server Adapter using the "Download additional server adapters" link
- In the Servers View panel at the bottom of the screen, right-click, select New and click Server.
- To show the Servers View panel:
- On the Eclipse menu bar, click on Window, select Show View, and click Other....
- In the Show View panel, expand Server, select Servers and click OK.
- In the New Server panel, click the "Download additional server adapters" link.
- In the Install New Server Adapter panel, select "WASCE v2.0 Server Adapter", and click "Next>".
- Accept the license agreement, and click Finish.
- Click OK to install the server adapter, and restart eclipse for the changes to take effect.
Installing the WASCE WTP Server Adapter using the Eclipse Update Manager
Note: Be sure to install the
Prerequisite Software before you attempt to install the WASCE WTP server adapter.
Instructions for users familiar with using the Eclipse Update Manager
- Add the URL of the WASCE Eclipse Update site (http://download.boulder.ibm.com/ibmdl/pub/software/websphere/wasce/updates/) as a remote site in your Eclipse update manager, and search for features to install from it.
- To install the Eclipse WTP server adapter for version 2.0 of the WebSphere Application Server Community Edition server, select this WTP Server Adapter:
- WASCE v2.0 Server Adapter 2.0.0
- To additionally install the Eclipse WTP server adapter for version 1.1.0.x of the WebSphere Application Server Community Edition server, also select:
- WASCE v1.1.x Server Adapter 2.0.0
- It is not necessary or recommended to install a server for development and test from the IBM WASCE Runtimes in the update manager list at this time. The appropriate server will be downloaded the first time you click the Download and install button when you define a new server.
Detailed Instructions
- Open the Eclipse Update Manager as follows:
- Help, Software Updates, Find and Install....
- Select Search for new features to install and click Next.
- Create a WASCE Eclipse Update Site as follows:
- Click the New Remote Site... button in the upper right corner.
- Type WASCE Eclipse Update Site (or other suitable unique name) in the Name: field.
- Put the URL of the WASCE Eclipse Update site (http://download.boulder.ibm.com/ibmdl/pub/software/websphere/wasce/updates/) in the URL: field.
- Click OK.
- Select only the WASCE Eclipse Update Site in the Sites to include in search selection box and click Finish.
- Select a mirror and click OK if prompted to do so.
- Expand WASCE Eclipse Update Site, and WTP Server Adapters.
- Install the desired WTP server adapters
- To install the Eclipse WTP server adapter for version 2.0 of the WebSphere Application Server Community Edition server, select this WTP Server Adapter:
- WASCE v2.0 Server Adapter 2.0.0
- To additionally install the Eclipse WTP server adapter for version 1.1.0.x of the WebSphere Application Server Community Edition server, also select:
- WASCE v1.1.x Server Adapter 2.0.0
- It is not necessary or recommended to install a server for development and test from the IBM WASCE Runtimes in the update manager list at this time. The appropriate server will be downloaded the first time you click the Download and install button when you define a new server.
- Click Next.
- Accept the license agreement and click Next.
- Click Finish.
- Click Yes to restart eclipse for the changes to take effect.
Installing the WASCE WTP Server Adapter using the updatesite.zip file
Note: This installation option is only recommended if you can not use the Eclipse Update Manager to install code from the Internet due to firewall or proxy restrictions.
- Visit the welcome page from the Eclipse Update Site for IBM WebSphere Application Server Community Edition.
- Click the link at the bottom of the page to download the updatesite.zip package.
- Extract this package to a directory on your machine, and follow the instructions in Installing the WASCE WTP Server Adapter using the Eclipse Update Manager.
- Instead of using a remote update site, create a local update site from the directory to which you extracted the updatesite.zip package.
Detailed Instructions
- Open the Eclipse Update Manager as follows:
- Help, Software Updates, Available Software
- Add Site
- Create a WASCE Eclipse Update Site as follows:
- Click the Local Site... button in the upper right corner.
- Browse the Local site(extracted folder)
- Click OK
- Expand WASCE Eclipse Update Site, and WTP Server Adapters.
- Install the desired WTP server adapters
- To install the Eclipse WTP server adapter for version 2.0 of the WebSphere Application Server Community Edition server, select this WTP Server Adapter:
- WASCE v2.0 Server Adapter 2.0.0
- To additionally install the Eclipse WTP server adapter for version 1.1.0.x of the WebSphere Application Server Community Edition server, also select:
- WASCE v1.1.x Server Adapter 2.0.0
- It is not necessary or recommended to install a server for development and test from the IBM WASCE Runtimes in the update manager list at this time. The appropriate server will be downloaded the first time you click the Download and install button when you define a new server.
- Click Next.
- Accept the license agreement and click Next.
- Click Finish.
- Click Yes to restart eclipse for the changes to take effect.
Installing the WASCE WTP Server Adapter using the deployable.zip file
Note: Use this installation option only if all other options fail.
- Visit the welcome page from the Eclipse Update Site for IBM WebSphere Application Server Community Edition.
- Click the link at the bottom of the page to download the deployable.zip package.
- Stop Eclipse.
- Extract this package to your Eclipse directory.
- Use the eclipse -clean option after installing the WTP server adapter.
Troubleshooting the WASCE WTP Server Adapter
Use the eclipse -clean option after installing the WTP server adapter
After installing the WTP server adapter, whether it is the first installation or a subsequent installation of a newer version, start Eclipse with the -clean option. This allows Eclipse to recognize and use the newest version of the WTP server adapter.
Views synchronize when saved
While using the WTP server adapter to customize deployment plans, you may want to use both the form view and the source view. When you are using both views, remember that changes made in one view will not be reflected in the other view until the changes are saved. Be sure to save your changes before switching to a different view.
An IP address change can orphan the server
If the server is running on a host where the IP address has been assigned using DHCP, be sure to stop the server before the IP address changes. For example, you are using a laptop with an Ethernet connection, stop the server before you disconnect and switch to a wireless connection. If you don't, Eclipse will not be able to send a shutdown request to the hidden process where the server is running and if the server is not stopped gracefully, some of the server's configuration changes may be lost.
If the IP address changes while the server is running, you will need to stop the javaw process that contains the server or restart the host. In either case, you will have to repeat any configuration changes that were not saved correctly.
Unable to open Deployment plan editor in Eclipse
This error can occur when opening a WASCE- or geronimo-specific deployment plan without having a WASCE server specified as a "Targeted Runtime". An "IllegalArgumentException" may be thrown. To fix the problem, specify a WASCE runtime as the "Targeted Runtime" for the asset as described in
Deploying in Eclipse.