Contents


IBM WebSphere Application Server Migration Toolkit

A developer's guide to tools and resources for WebSphere migration

Comments

The IBM® WebSphere® Application Server Migration Toolkit is a suite of tools and knowledge collections. It enables your organization to quickly and cost-effectively migrate to the latest releases of traditional WebSphere Application Server and Liberty. You can migrate from a previous version of WebSphere Application Server or from competitive application servers, such as Apache Tomcat Server, JBoss Application Server, Oracle® Application Server, and Oracle WebLogic Server.

Whether you are moving your workloads to a later release on-premises or exploring cloud platforms, tools are available to help. Learn more about these tools and find additional resources in the Migration article in the WASdev Developer Center.

New and noteworthy

The WebSphere Application Server Migration Toolkit is updated quarterly and supports migrations to WebSphere Application Server V8.5.5 and V9. For information about the most recent enhancements to the tools, see the Migration page and the What is the Migration Toolkit for Application Binaries? article in the WASdev Developer Center. Also in this developer center, you can find the latest versions of the migration tools on the migration toolkit downloads page.

Migration tools and resources

The migration toolkit includes tools and resources for planning, development, and administration.

  • Planning
    • WebSphere Migration Knowledge Collection: Planning and resources
      Use the publications on this site to plan your migration from previous versions of WebSphere Application Server to WebSphere Application Server V8.5.5 or V9.
    • Migration toolkit for Application Binaries
      Evaluate applications quickly with this command-line tool using application archive files. You can evaluate the right-fit platform or perform detailed migration analysis for moving to Liberty and between traditional WebSphere releases either on-premises or in the cloud.
    • WebSphere Migration Discovery Tool
      Thinking about migrating to the IBM WebSphere platform? You can use this web-based tool at no charge to help gain insight into the size and scope of your migration project. This tool works for migrations to WebSphere Application Server, WebSphere Application Server Liberty, and WebSphere Application Server Liberty on IBM Bluemix®. Learn more about the tool in this IBM Advantage Blog post.
    • WebSphere Application Server V8.5 Migration Guide
      Use this IBM Redbooks publication to plan your migration from competitive application servers to WebSphere Application Server V8.5.
  • Development
    • WebSphere Application Migration Toolkit
      This Eclipse-based tool helps you migrate application source code from WebSphere Application Server V5.1 through V9 to Liberty or traditional WebSphere Application Server V8.5.5 through V9. It also helps to migrate applications from Apache Tomcat Server, JBoss Application Server, Oracle Application Server, and Oracle WebLogic Server to WebSphere Application Server V8.5.5 through V9 or Liberty. And, it helps to migrate an Apache Tomcat Server configuration to Liberty.
    • Migration Toolkit for Application Binaries
      If you do not use Eclipse for development, this command-line tool provides the same detail for traditional WebSphere version-to-version migrations and traditional WebSphere version migrations to Liberty.
  • Administration

Competitive migration

When you perform migrations from third-party application servers, use the following tools and resources to provide the help and insights you need to make the move:

Application migration tools

The WebSphere Migration Toolkit includes the following tools to speed the migration of applications from competitive application servers to WebSphere Application Server V8.5.5 through V9:

  • 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

The application migration tools use static analysis to locate application elements that should be updated to ensure optimal compatibility and performance with traditional WebSphere Application Server and Liberty. These tools also include unique editing features so that you can review and appropriately change the code. The Application Migration Tools are packaged as features that you can install in an Eclipse or IBM Rational Application Developer for WebSphere Software IDE. The tools are also compatible with the IBM WebSphere Application Server Developer Tools for Eclipse. The following figure shows a view of the application migration tools.

View of application                     migration tools
View of application migration tools

The competitive application migration tools focus on the following migration issues when you move applications from third-party application servers to Liberty or traditional WebSphere Application Server:

  • Differences in Java SE versions and in Oracle versus IBM Java
  • Proprietary deployment descriptor configuration in Java EE extension files
  • Proprietary Java API package references
  • Proprietary Java annotations
  • Proprietary server startup and shutdown interfaces
  • Non-portable JNDI lookup strings and Initial Context configuration
  • Thread creation within containers
  • Proprietary server-specific MBeans JAX-RPC web services migration for JBoss, WebLogic, and Oracle
  • WebLogic-specific Java EE 5 issues that are related to JPA, JDBC, XML, and JTA
  • Non-standard JSP file usage and constructs
  • Proprietary JSP file tag libraries
  • Taglib prefix redefinition
  • Java keyword use within JSP expression language elements
  • Class path setup that does not comply with Java EE specifications
  • Best practices for using Spring within WebSphere
  • Detection of Spring, Hibernate, SEAM, and Quartz scheduler third-party software.

Configuration migration tools

Apache Tomcat configuration migration to Liberty is included with the Eclipse-based application migration tool. For a step-by-step example, see Migrating from Apache Tomcat to the WebSphere Application Server Liberty Profile. The tool enables:

  • Migrating from Apache Tomcat 6, 7, or 8
  • Migrating to Liberty
  • Migrating Apache Tomcat context, server, and web XML information in the server
  • Migrating Apache Tomcat context and web XML information in the application

WebLogic and JBoss configuration migration is included in the Eclipse-based WebSphere Configuration Migration Tool.

WebSphere migration

When you perform WebSphere upgrades or consider the move to cloud platforms, use the following tools and resources for the help and insights you need to make the move:

Application migration tools

With the WebSphere Application Server Migration Toolkit and Migration Toolkit for Application Binaries, organizations that are deploying to Liberty or the latest release of traditional WebSphere Application Server can more easily migrate applications from WebSphere Application Server V5.1 through V9.0. Upgrading to a more recent version of WebSphere Application Server is less time-consuming than migrating from another application server. The reason is that IBM has made significant investments in upward compatibility, configuration, and management process upgrades, in addition to API preservation and consistency between versions. However, in some cases, applications must be changed in order to support or exploit new levels of industry standard specifications that are delivered with new versions of WebSphere Application Server.

The version-to-version application migration tools focus on the following migration issues when upgrading applications to Liberty or the latest traditional WebSphere Application Server:

  • Java SE version differences between Java SE 6, 7, and 8
  • Java EE behavior differences when moving up Java EE levels or specification clarifications
  • WebSphere deprecations
  • WebSphere removals
  • API differences between traditional WebSphere and Liberty

Configuration migration tools

Traditional WebSphere version-to-version configuration migration support is included within the WebSphere Application Server product. The associated tools are provided on all operating systems that are supported by WebSphere Application Server, including distributed, z/OS®, and IBM i™ platforms.

For information about the following new migration features, see What is new for migration in V9:

  • Clone migration
  • Migration options properties files
  • Improved port assignment
  • Integrated Compute Grid migration
  • Integrated WebSphere Virtual Enterprise migration
  • WASMigrationAppInstaller application installation tool

The configuration migration tools do not alter the configuration of your existing WebSphere Application Server installation. The tools provide a two-phased approach to migration as illustrated in the following figure:

  1. The configuration from your existing WebSphere Application Server is copied into a backup directory.
  2. The content of the configuration backup directory is merged into a new profile that is in your new WebSphere Application Server installation. By default, all of the configuration objects, including servers, resources, and virtual hosts, are merged into the new profile. Also, all applications are deployed to your new WebSphere Application Server environment. Two-phased approach                     to migration
    Two-phased approach to migration

An intuitive migration wizard is provided that guides you through the local migration process. A remote migration process is also supported for distributed systems using the command-line tools. For more information, see Migrating, coexisting, and interoperating in the IBM Knowledge Center.

The WebSphere Configuration Migration Tool supports:

  • Migrating traditional WebSphere configuration to Liberty by using a properties-based configuration file
  • Creating traditional WebSphere scripts by using a properties-based configuration file

Help and feedback

If your organization has a support agreement in place for WebSphere Application Server V7 or later, as part of that agreement, IBM will provide support for the application migration tools and the included migration rules. Assistance with application coding or design issues requires a Services engagement.

To ask questions, search for solutions, and provide feedback to the development team, you can use the Migration Toolkit Forum. Support for the WebSphere Configuration Migration Tool is available in the WCMT forum.

Downloads


Downloadable resources


Related topics


Comments

Sign in or register to add and subscribe to comments.

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Middleware
ArticleID=1042392
ArticleTitle=IBM WebSphere Application Server Migration Toolkit
publish-date=01302017