Traditional WebSphere - Analyze
This section covers how to use IBM Cloud Transformation Advisor to analyze an existing traditional WebSphere application. For this scenario the traditional WebSphere Application Server runtime is chosen as the target runtime and the intention is to migrate this application without code changes. Migrating to the containerized version of traditional WebSphere Application Server will prepare the organization for:
- moving workloads to the cloud.
- improving DevOps and speed-to-market.
- receiving the benefits of the consistency and reliability of containers.
This section has the following steps:
Introduction to IBM Cloud Transformation Advisor
Install IBM Cloud Transformation Advisor
Download and run the Data Collector
Upload and analyze the results
Determine the migration/modernization path and next steps
Introduction to IBM Cloud Transformation Advisor
IBM Cloud Transformation Advisor helps you access, analyze and modernize middleware based apps into IBM Cloud(s). It categorizes Java EE apps and MQ queue managers as simple, medium and complex based on migration complexity and provides guidance for modernization. IBM Cloud Transformation Advisor can accelerate the process to move your on-premises apps to cloud, minimize migration errors and risks, and reduce time to market in five steps.
You can use IBM Transformation Advisor for these activities:
- Identify the Java EE programming models in an app
- Determine the complexity of apps by reviewing a high-level inventory of the content and structure of each app
- Highlight the Java EE programming model and WebSphere API differences between the profile types
- Learn any Java EE specification implementation differences that might affect the app
The tool also provides suggestions for the right-fit IBM WebSphere Application Server edition and offers advice, practices, and potential solutions to move apps to Liberty or to newer versions of WebSphere Application Server.
Install IBM Cloud Transformation Advisor
IBM Cloud Transformation Advisor is split in to two components (the
analysis engine and the
data collector). Access Transformation Advisor from IBM Cloud Pak for Applications. You can also run it locally on a machine with Docker. See Installing IBM Cloud Transformation Advisor Beta Edition locally.
Download the Data Collector
Once IBM Cloud Transformation Advisor is installed, it is necessary to create a new Workspace and Collection and then download the Data Collector that will be used to examine the existing environment and applications.
- Open IBM Cloud Transformation Advisor in a browser and click the button to create a new Workspace
- Enter a Workspace name such as
CloudPak_for_Applicationsand click Next
- Enter a Collection name such as
WAS855_AppSrv01and click Let’s go
- When the No recommendations available page is displayed, click the Data Collector button
- When the Data Collector page is displayed, select the Source Operating System for your environment and click the Download button to download the Data Collector.
This results in a file with a name similar to
transformationadvisor-Linux_CloudPak_for_Applications_WAS855_AppSrv01.tgz being downloaded.
Run the Data Collector
Upload the Data Collector zip file that was downloaded from IBM Cloud Transformation Advisor in the previous step to the machine that the WebSphere ND Deployment Manager or the Standalone WebSphere Application Server is installed. The directory used arbitrary.
- Navigate to the directory you uploaded the
transformationadvisor-Linux_CloudPak_for_Applications_WAS855_AppSrv01.tgzfile to and issue the following commands to extract the Data Collector:
mkdir datacollector cd datacollector mv transformationadvisor-Linux_CloudPak_for_Applications_WAS855_AppSrv01.tgz . tar -zxvf transformationadvisor-Linux_CloudPak_for_Applications_WAS855_AppSrv01.tgz cd transformationadvisor-*
- It is necessary to modify the scan performed by the Data Collector to include the
org.pwtepackage as the Data Collector doesn’t scan
org.*packages by default. Open the
conf/customCmd.propertiesfile and modify it as shown below:
evaluation=--evaluate --excludePackages=com.ibm,com.informix,com.microsoft,com.sybase,com.sun,java,javax,net,oracle,sqlj,_ibmjsp --includePackages=org.pwte migration_liberty=--analyze --sourceAppServer=was855 --targetAppServer=liberty --targetCloud=dockerIBMCloud --includePackages=org.pwte --excludePackages=com.ibm,com.informix,com.microsoft,com.sybase,com.sun,java,javax,net,oracle,sqlj,_ibmjsp migration_was=--analyze --sourceAppServer=was855 --targetAppServer=was90 --targetCloud=vmIBMCloud --includePackages=org.pwte --excludePackages=com.ibm,com.informix,com.microsoft,com.sybase,com.sun,java,javax,net,oracle,sqlj,_ibmjsp #inventory=--inventory --excludeFiles=".*/directory/LargeXMLFileName.xml" #featureList=--featureList --excludeFiles=".*/directory/LargeXMLFileName.xml" #java_opt=-Xmx2g
- The following command assumes that WebSphere Application Server v855 is installed to
/opt/IBM/WebSphere/AppServer855with a profile named
AppSrv01and that the administration user is
wasadminwith a password of
wasadmin. Modify and issue the following command as necessary to execute the Data Collector against the WebSphere environment:
./bin/transformationadvisor -w /opt/IBM/WebSphere/AppServer855 -p AppSrv01 wasadmin wasadmin
When prompted, accept the license agreement. The Data Collection process will now start and will analyze all of the applications installed in the WebSphere Application Server environment and will also collect the related Java EE artifacts such as Data Sources and JMS definitions.
When the analysis is complete, the Data Collector will attempt to upload the collection results to IBM Cloud Transformation Advisor. If this is successful, you can skip to the Analyze the Recommendations section. If not, you will receive an error at the end of Data Collection and will find a file named
AppSrv01.zipin your current directory as shown below.
~/datacollector/transformationadvisor-1.9.6# ls -la *.zip -rw-r--r-- 1 root root 625493 Jun 12 12:58 AppSrv01.zip
Download this Data Collector Results zip file ready for uploading to IBM Cloud Transformation Advisor in the next section
Upload the Data Collector results
In this section the results from the Data Collector will be uploaded to IBM Cloud Transformation Advisor.
- In the IBM Cloud Transformation Advisor web browser session, click the Recomendations link in the top left corner and then click the Upload data button as shown below
- When the Upload data dialog is displayed, use the Drop or Add File button to select the Data Collector Results zip file that was downloaded in the previous section. Click Upload
After a few moments the upload of the data collector results will be completed.
Analyze the Recommendations
Once the Data Collector Results have been uploaded to IBM Cloud Transformation Advisor a set of recommendations will be created and shown on the Recommendations page. In this section the recommendations will be analyzed and interpreted.
- The default recommendations are based on a target runtime of Liberty on Private Cloud. In this scenario the desired target runtime is WebSphere Traditional on Private Cloud. Use the Preferred migration drop down to select WebSphere Traditional on Private Cloud as shown below.
- The Data Collector analyzed all of the applications running on the traditional WebSphere profile a displays a row in the chart for each application.
In the case of the CustomerOrderServicesApp.ear application, IBM Cloud Transformation Advisor has determined that the migration to WebSphere Traditional on Private Cloud is of Moderate complexity and that there are four Severe Issues that have been detected. Click on the CustomerOrderServicesApp.ear application name to see more information.
- Review the analysis results and scroll down to the Technology Issues section. Note that IBM Cloud Transformation Advisor has detected that there are issues with JPA, specifically that the second-level cache and the JPA configuration properties must be migrated and with JAX-RS (missing Apache and Wink packages). These issues are related to a decision that was taken by IBM to allow WebSphere Application Server V9 to run in either JPA 2.0 or JPA 2.1 mode as described here and in either JAX-RS 2.0 or JAX-RS 1.1 mode as described here. In order to run in JPA 2.1 mode and JAX-RS 2.0 mode, the changes highlighted by IBM Cloud Transformation Advisor must be made to the application. However, this application can run in JPA 2.0 mode and JAX-RS 1.1 mode with no changes.
- In order to review the IBM Cloud Transformation Advisor results in more detail, scroll to the bottom of the analysis page and click on the Analysis Report link
- When the warning dialog is displayed, click OK
- The Detailed Migration Analysis Report will be displayed which show the results of the migration rules that were executed by the Data Collector and returned results. Scroll down to the Severe Rules section and click on the Show rule help link for each of the results. Review the recommendations.
The intention of this traditional WebSphere V855 –> traditional WebSphere V9 (Private Cloud) scenario is to migrate the Customer Order Services application to the new runtime without code changes.
IBM Cloud Transformation Advisor was used to analyze the application for compatibility with traditional WebSphere V9 (Private Cloud) and determined that code changes would be required.
IBM Cloud Transformation Advisor took the approach that the application should be modified to run with the JPA 2.1 runtime and the JAX-RS 2.0 runtime instead of giving the option to use the JPA 2.0 runtime and the JAX-RS 1.1 runtime which would have resulted in not requiring any code changes to the application.
The remainder of this scenario is based on the decision to use the JPA 2.0 runtime option and the JAX-RS 1.1 runtime option in traditional WebSphere V9 (Private Cloud) and as such no code changes will be required to this application.