Installing IBM Cloud Transformation Advisor on RHEL

Prerequisites

Before you begin go to the Registration and download site and download the Transformation Advisor Local install script. If you are using a Windows operating system, you must also download the docker-compose.yml and .env files. For details on using the signature to verify the downloaded zip, please see here.

Required Resources

Table 1. Minimum default configuration

System                   | Memory (GB) | CPU (cores) | Disk space (GB)
------------------------ | ----------- | ----------- | ---------------
Transformation Advisor   | 8           | 4           | 20

Installing IBM Transformation Advisor on RHEL

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 haven't already, go to the Registration and download site 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: unzip transformationAdvisor.zip

3. To install Transformation Advisor locally, run the following command: ./launchTransformationAdvisor.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: http://< host name >:3000
   • MacOS: http://< IP Address >:3000

Note: For Transformation Advisor to function correctly your system must be configured to allow ingress and egress on ports 3000 & 2220

Installing IBM Cloud Transformation Advisor on Windows v10 / v11

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

1. If you haven't already, go to the Registration and download site and download the windows10files.zip.

2. Install Docker Desktop for Windows. You can watch this short video for a detailed walk-through of the installation steps.

3. Extract the zip and if Docker Desktop uses volumes then rename the file docker-compose_volumes.yaml to docker-compose.yml, if Docker Desktop uses file share then rename the file docker-compose_fileShare.yaml to docker-compose.yml

4. Create a ta_local directory, for example C:\Users\ta_local\dockerCompose, and put the .env and docker-compose.yml files there.

5. Open a terminal session.

6. Change to the directory where the docker-compose.yml and .env files are located.

7. Make sure that Docker is running:

   docker ps

8. Pull the Transformation Advisor images:

   docker-compose pull

9. Start the containers and run them in the background:

   docker-compose up -d

10. Verify that four containers are created:

`docker ps`

11. Access the Transformation Advisor UI at the following URL:

    http://localhost:3000

Installing IBM Cloud Transformation Advisor on Windows v10 / v11 using podman

1. Install Windows Terminal

2. Install / enable WSL 2

3. Install Ubuntu (20.04)

4. Install Podman from the Add the Podman PPA and install Podman section

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

https://www.redhat.com/sysadmin/podman-windows-wsl2

cd /tmp  
rm -rf