WebSphere Application Server & Liberty

 View Only

Generating a Transformation Advisor Data Collection with the WebSphere wsadmin Commands

By Ralph Sanders posted Mon November 28, 2022 12:12 PM

  

With the release of WebSphere 9.0.5.14, you can now generate an IBM Cloud Transformation Advisor (TA) data collection for a profile directly from your WebSphere installation. This functionality is provided by a new set of wsadmin commands. These commands are simple to use, and you can also generate a data collection on a remote WebSphere installation through a wsadmin connection. See IBM Cloud Transformation Advisor for more information about TA, and see the wsadmin scripting tool documentation for more information about using wsadmin.

Creating a TA data collection

Use the createTADataCollection command to generate a TA data collection for the current profile. This command includes optional parameters to remove previously generated data collections, create a debug trace, or set the max heap for the JVM. If the data collection is interrupted before it completes, executing this command again will resume progress at the point of interruption. Executing this command from a stand-alone WebSphere application server will scan all the applications in the profile on that server. Executing this command from a WebSphere Network Deployment will scan all the applications in the deployment manager profile. The deployment manager profile will include all applications from any federated nodes. Once the data collection is complete, one or more zip files will be generated in the WAS_HOME/profiles/<profile_name>/libertyAdvisor/ directory. One zip file is generated for the applications in the profile, and an additional zip file is generated for each shared library included in the data collection. Upload the zip files to your Transformation Advisor workspace to view the results from this collection. See the createTADataCollection documentation for more information about using this command.

This image displays the resulting zip files from the data collection.

 

In this image, you can see the resulting zip files that are generated during a data collection for upload to TA.

 

Checking the status of a TA data collection

Use the getTADataCollectionSummary command to check the status of an ongoing or completed TA data collection. This command returns a JSON object with detailed information about the progress of the scan. You can use this to see the current status code, the number of applications and shared libraries scanned, the number of error or warning messages, the list of zip files generated for upload to TA, and other information. See the getTADataCollectionSummary documentation for more information and the full list of values returned in the JSON object.

{
    "summary": {
        "startTime": "2022.11.22.13.39.09",
        "endTime": "2022.11.22.13.40.27",
        "statusFilePath":"C:\WebSphere\WAS90\profiles\AppSrv01\libertyAdvisor\scan_status.json",
        "warnings": 0,
        "errors": 0,
        "profiles": {
            "total": 1,
            "completed": 1,
            "current": "AppSrv01"
        },
        "applications": {
            "total": 5,
            "completed": 5,
            "current": "query.ear"
        },
        "sharedLibraries": {
            "total": 2,
            "completed": 2,
            "current": "AppSrv01-pbwJNDI"
        },
        "zipFiles": {
            "total": 3,
            "completed": 3,
            "current": "AppSrv01-pbw-lib.zip"
        },
        "collectionFiles": ["C:\WebSphere\WAS90\profiles\AppSrv01\libertyAdvisor\AppSrv01.zip","C:\WebSphere\WAS90\profiles\AppSrv01\libertyAdvisor\AppSrv01-pbwJNDI.zip","C:\WebSphere\WAS90\profiles\AppSrv01\libertyAdvisor\AppSrv01-pbw-lib.zip"
        ],
        "status": 0
    }
}

This is a sample return value for the getTADataCollectionSummary command after a completed data collection.


Deleting an existing TA data collection

Use the deleteTADataCollection command to delete a previously generated TA data collection for the current profile. This will only remove files in the WAS_HOME/profiles/<profile_name>/libertyAdvisor/ directory that were generated by the createTADataCollection command. If you wish to delete an existing collection and immediately create a new one, use the createTADataCollection command with the clean parameter instead. See the deleteTADataCollection documentation for more information about using this command.

These new commands provide an easy way to generate a TA data collection from your WebSphere installation without the need for additional software. Take advantage of this built-in WebSphere feature to begin your process of application modernization with Transformation Advisor.

 


#ApplicationModernization
#appmigration
#TransformationAdvisor
#WebSphereLiberty

Permalink