Skill Level: Any Skill Level

The Transformation Advisor is a free developer tool to help you quickly modernize your existing middleware deployments. This recipe describes how to use Transformation Advisor on ICP for IBM MQ.


IBM Cloud Private(ICP) Installed

Transformation Advisor installed on ICP( Installation steps here)

IBM MQ Installed


  1. Introduction of Transformation Advisor

    IBM Cloud Transformation Advisor helps you identify the cloud readiness of your middleware deployments by running a data collector that inventories and identifies any changes that are needed to migrate to the cloud. IBM Cloud Transformation Advisor also helps prepare you to rapidly deploy to the cloud.

    IBM Cloud Transformation Advisor can scan and analyze the following middleware deployments. The list is frequently expanding, so check back often for what’s new. You can also contact IBM on Slack or by email if you’re yearning for something specific.

    Java application servers

    • WebSphere Application Server v7+ (application scanning v6.1+)
    • Oracle ™ WebLogic v6x+
    • Red Hat ™ JBoss v4.x+
    • Java EE applications directly without config


    • IBM MQ v7+


    IBM Cloud Transformation Advisor collects     

    • Inventory of on-premises workloads
    • Configuration and dependencies
    • Usernames for connections

    IBM Cloud Transformation Advisor does not collect

    • Message content or data processed by workload
    • Any Log data
    • Password information


    Next Step – The next step will detail out how to get started with the Transformation Advisor.

  2. Getting Started with the Transformation Advisor

    If you do not yet have the Transformation Advisor installed follow the installation instructions here first. Once installed access the URL from your browser as described in the installation instructions, you will see the following screen.



    You should get started by creating a new workspace that will be used to house your recommendations, this can be any string you want, such as the project name or the name for the portfolio of applications you will be analysing, basically anything that will help you to easily identify your work when you return to it at a later date.


    You will then be asked to enter a collection name, this is an opportunity for you to sub-divide your work even further into a more focused grouping – it would typically be associated with a single run of the datacollector and may be the name of the individual MQ setup that you will be running the datacollector on. It can be any string and can be deleted later.


    Hit ‘Let’s Go’ and get started with the Data Collector.

  3. Download and run the Data Collector

    Now click on DataCollector button.


    In order to Download the appropriate DataCollector, please specify the source operating system.

    In this recipe as MQ is installed on a LINUX machine hence selected LINUX.





    Download the zip file to your browsers download directory and copy/ftp to your target server, then follow the directions as described on the page to unzip and run the data collector.

    WARNING – This is tool should not be run on production servers


  4. Directions to execute the Data Collector

    Once data collector is downloaded, follow the steps below. These steps are very well documented in the Transformation Advisor page also.

    1. Copy and place the file to your system in a directory where it has read-write-execute access.

    Then decompress the downloaded file:

    tar xvfz transformationadvisor-Linux_WorkspaceMQ_col1.tgz


    2. Go to the Data Collector directory:

    cd transformationadvisor*

    TIP: View command-line options that are available for the Data Collector run:

    ./bin/transformationadvisor –help

    Running into issues-

    If you encounter the issue “No java installations was detected” or “bad major version,” it means that the Java we have provided is not suitable for your architecture.

    You can solve this issue as follows:

    1. Explode the Data Collector archive as normal
    2. cd into transformationadvisor
    3. Replace the jre directory with the jre directory from the Java application/MQ machine itself
    4. Run the Data Collector command again

    Run tool

    Select your domain and analysis type below and run the generated command from the data collector directory to begin scanning.

    In this case, I have MQ – One installation. But you can select the depending on the domain and select the Analysis accordingly.




    Then select the Analysis of

    Run the data collector as a user in the mqm groupScreen-Shot-2019-03-15-at-12.38.08

    Run the data collector as a user in the mqm group

    usermod -G mqm <username>

    getent group mqm


    To get the installation name – Type the following command on the MQ setup machine.


    InstName:      Installation1


    Identifier:    1

    InstPath:      /opt/mqm


    Primary:       Yes

    State:         Available

    Execute the command listed in the above screenshot on the MQ setup.

    ./bin/transformationadvisor -m <installation>

    <installation>- is the InstName from the dspmqinst output.

    Running into issues

    1) Unable to find the MQ installation find with the installation name given

    ./bin/transformationadvisor -m  Installation1

    Start to collect data for IBM MQ installation ……

    Error: No MQ installation find with name:  Installation1

    To resolve this issue – 

    setmqinst -i -n Installation1

    Refreshing settings for primary installation ‘Installation1’


    143 of 143 tasks have been completed successfully.

    ‘Installation1’ (/opt/mqm) set as the primary installation.

    2) Unable to copy mqs.ini file

    ./bin/transformationadvisor -m  Installation1

    Start to collect data for IBM MQ installation ……

    Error: Error copying mqs.ini (src:null/mqs.ini) (target:/home/fyre/transformationadvisor-1.9.2/Installation1/mqs.ini)

    To resolve this issue –

    Go the MQ installation directory

    chmod 777 Installation1



    Depending on the number, size and complexity of your applications the Data Collector may take quite some time to execute and upload results. During this process, you can keep track of its progress by checking your command line.

    If there is a connection between your system and your new collection, the Data Collector will send your application data for you.

    If there is no connection, the Data Collector will return a .zip file containing your application data in which you will need to manually upload to your Recommendations page.



  5. UI of Transformation Advisor with Analysis


    On the TA UI you can view the recommendations.



    Click on the Queue Manager Name Q1 and get the Analysis. Depending on the Q1 the Analysis reults will be different.

    The given screen shot is just a sample. 



  6. Conclusion

    In this recipe we have learned:

    1. To setup Transfomation Advisor 

    2. Run the TA data collector on the MQ setup

    3. Some issues resolution on MQ while executing TA command.

    4. Viewing the recommendations on Transformation Advisor UI.

  7. Co-author of this recipe

    Shishir Narain (nshishir@in.ibm.com) is co-author of this recipe. He is Senior IT Architect for Middleware Technologies, API Connect and IBM Cloud.



Join The Discussion