Installing IBM Transformation Advisor on RHEL

Before you begin go to the IBM Cloud Transformation Advisor - Trial (Business Contact Information) page and download the Transformation Advisor Local install script.

For more information on using the signature to verify the downloaded zip, see Security Considerations.

Table 1. Minimum default configuration

You might also follow these instructions for an installation on MacOS, subject to the SUPPORTED PLATFORMS note on this page regarding support.

Before you start, ensure that you have docker or podman installed.

• Podman greater than 3.4

• Docker on RHEL 7

• Docker on RHEL 8/9:

  Docker is not shipped or supported by Red Hat for Red Hat Enterprise Linux (RHEL) 8/9. Docker Community Edition may be installed on RHEL 8/9 from the Docker CE package repository here: https://download.docker.com/linux/centos/docker-ce.repo

1. If you have not, go to the IBM Cloud Transformation Advisor - Trial (Business Contact Information) page and download the Transformation Advisor Local install script.

2. Create a directory for the Transformation Advisor files, for example, ta_local. Copy the .zip file that you downloaded during the registration step into this directory and extract it:

3. To install Transformation Advisor locally, run the following command:

   ./launch.sh
    

4. Select 1 if you agree with the terms of the License.

5. Select 1 to install Transformation Advisor

6. After the installation is complete, you can access Transformation Advisor locally at the following URLs. The host name or IP address and port are provided by the installation program.

Linux: https://< host name >:443 MacOS: https://< IP Address >:443

For Transformation Advisor to function correctly your system must be configured to allow ingress and egress on ports `3000` & `2220`.
{: note}



## Installing IBM Transformation Advisor on Windows 11

Installation on Windows is subject to the **SUPPORTED PLATFORMS** note on this page.

1. Download the Transformation Advisor Local install script from the [IBM Cloud Transformation Advisor - Trial (Business Contact Information) page](https://www.ibm.com/account/reg/us-en/signup?formid=urx-52234).

2. Extract the downloaded script into a directory.

3. Install [Podman Desktop for Windows](https://podman-desktop.io/docs/installation/windows-install).

4. After Podman Desktop is installed, open a command prompt and verify that Podman is running:  

 ```batch {: codeblock}
 podman ps
 

1. From the command prompt, go to the directory where you extracted the script, then change to the scripts/windowsPodmanDesktop directory:

   cd <extracted_script_directory>\scripts\windowsPodmanDesktop
    

2. Launch the installation:

   launch.bat
    

3. Accept the license from the menu.

4. After accepting the license, select option 1 to install.

1. Before you start, ensure that you have podman installed.

   brew install podman
    

2. Check its version to confirm installation.

   podman --version

   Important: Podman versions 5.6.0 and later are not supported on macOS. Rosetta support in Podman machine VMs is disabled by default in Podman 5.6.x due to issues with newer Linux kernels. Podman plans to re-enable Rosetta support in a future release once the fix becomes widely available.

3. Initialize the podman machine and set the minimum required resources (4 CPUs, 4 gigs RAM)

   podman machine init --cpus 4 --memory 8192

4. Allow podman to run as root.

   podman machine set --rootful
    

5. Start the podman machine.

   podman machine start
    

6. Now install IBM Transformation Advisor as normal.

   Note: If you have already installed podman you need to cleanup the existing podman machine.

   podman machine rm
    

7. To install Transformation Advisor locally, run the following command:

   ./launch.sh
    

8. Select 1 if you agree with the terms of the License.

9. Select 1 to install Transformation Advisor

10. After the installation is complete, you can access Transformation Advisor locally at the following URLs. The host name or IP address and port are provided by the installation program.

    Linux: https://< host name >:443
    MacOS: https://< IP Address >:443
     

1. Install Windows Terminal.

2. Install and enable WSL 2.

3. Install Ubuntu 20.04.

4. Install Podman. You can follow the general Podman installation steps in the Podman for Windows tutorial.

5. Install Transformation Advisor using the script transformation-advisor-local-<version>.zip.

On a reboot, you might see the following error message:

error retrieving network namespace
 

Github podman issue.

cd /tmp  
rm -rf
 

Run the launch script again and select 5 to start the Transformation Advisor.