Looking for information about migration? Start here…
As we continuously deliver Liberty, the Liberty zero migration vision is alive and well. We strive to never break an existing application or configuration by introducing a behavior change.
But sometimes you need to upgrade an application with new server features or move to a different edition. And moving between other servers, like WebSphere Application Server (WAS) classic or non-IBM application servers, can require some migration. The last thing you want is to be caught by surprise by unanticipated migration difficulties. This is where the WebSphere Application Server Migration Toolkit can help. With static analysis we can scan your application source or application binaries to find those gotchas that can occur between different application servers, different Java SE versions, and between different Java EE levels.
The WebSphere migration toolkit provides a rich set of tools that help you migrate between versions of WAS classic, to Liberty, to cloud platforms such as Liberty for Java on IBM Bluemix, and from non-IBM application servers. We do this by scanning your source, binaries, and configurations.
Our WebSphere Application Server Migration Toolkit provides an Eclipse-based migration experience. With one easy installation, you can access the following migration tools:
- Cloud Migration Tool
- WebSphere Version to Version Application Migration Tool
- Apache Tomcat to WebSphere Application Migration Tool
- JBoss to WebSphere Application Migration Tool
- Oracle to WebSphere Application Migration Tool
- WebLogic to WebSphere Application Migration Tool
- Apache Tomcat to Liberty Profile Configuration Migration Tool
These application migration tools are Eclipse features that you install into an existing Eclipse or Rational IDE where you develop your source code. Once installed, the tools can scan your applications for migration issues that you might have to address so that your application can run on the targeted version of WebSphere Application Server. Where possible, the Eclipse-based tools provide quick fixes to programmatically make application changes for you.
Moving to the cloud
When moving an application to Liberty for Java on IBM Bluemix or to a non-IBM Cloud PaaS environment, the Cloud Migration Tool offers additional advice, suggestions, and best practices to ensure the application will run correctly. For example, it will warn about using the Java File I/O API for storing persistent information on the local file system or suggest using the IBM Bluemix SessionCache service for storing HTTP session data. When migrating an application to a cloud environment running WAS Liberty, we recommend you get the application running on a standalone WAS Liberty server first, then move it to the cloud.
Moving between WebSphere versions
The WebSphere Version to Version Application Migration Tool scans your application source code and highlights Java EE programming model and WebSphere API differences between WAS classic versions (Version 5.1 or later to Version 8.5.5) and to WAS Liberty. It also informs you about any implementation differences that could affect your applications.
Moving from a non-IBM app server
You can install the migration tools for non-IBM application servers from the WebSphere Application Server Migration Toolkit to help you migrate applications to WAS classic or Liberty from:
- Apache Tomcat Server
- Red Hat JBoss Application Server
- Oracle Application Server
- Oracle WebLogic Server
Moving between Java versions
The tools include Java migration support for moving up from an earlier version of Java. Our newest Java 8 migration rules allow you to check your application for Java 8 readiness as it scans for known compatibility issues. The Eclipse interface for Software Analysis Results and Help is shown below.
The Migration Toolkit for Application Binaries is our command-line tool that allows you to scan your application binaries quickly and easily without source code. It contains many of the same rules as the Eclipse-based migration toolkit and provides application technology evaluation as well as detailed migration analysis. It helps you with application migrations between versions of WAS classic (Version 7 and later), from WAS classic to Liberty, and to Liberty PaaS environments such as Liberty for Java on IBM Bluemix.
All you need to start evaluating is the installed command-line tool and your application archives, such as EAR, JAR, WAR, or class files. If you have hundreds of applications, you can write a simple script to evaluate each and save the output to separate reports. For the administrator, planner, or developer not using Eclipse, this is a great addition to the toolkit!
Both the Eclipse-based migration tools and the binary scanner can examine your application and generate the Application Evaluation Report, which shows which editions of WebSphere Application Server are best suited to run the application. The report provides an inventory of Java EE programming models that are used by the application, and it indicates whether the application can be supported by WAS classic or Liberty. The report has been updated to indicate the latest levels of Java EE 7 support available on Liberty.
The Apache Tomcat to Liberty Profile Configuration Migration Tool helps you move server configuration and application configuration to Liberty by automatically migrating portions of the configuration. The tool supports:
- Migrating from Apache Tomcat 6.0 or 7.0
- Migrating to Liberty V8.5.5
- Migrating Apache Tomcat context, server, and web XML information contained in the server
- Migrating Apache Tomcat context and web XML information contained in the application
Use the WebSphere Configuration Migration Tool to migrate server configuration from JBoss or WebLogic to WAS classic or Liberty. It also assists in migrating resource configuration from WAS classic to Liberty. When migrating to WAS classic, the tool generates scripts to be used with the configuration. When migrating to Liberty, the tool generates server.xml configuration.
Check out our downloads, videos, and additional information, and let us know how we can help.
- WebSphere Application Server Migration Toolkit documentation
- Migration Toolkit for Application Binaries documentation
- What is the Migration Toolkit for Application Binaries?
- Move applications to WAS Liberty using the Migration Toolkit
- Updating to Java EE 7
- The Liberty zero migration vision
- Making the move to the Liberty profile, Part 1: Determining migration suitability using the Liberty Technology Preview
- Making the move to the Liberty profile, Part 2: Migrating Java EE resources with the Configuration Migration Toolkit
- Measuring performance with the Daytrader 3 benchmark sample
- Porting a Liberty MongoDB application to run on WebSphere Application Server Full Profile
- Migrating your apps to WebSphere the easy way