Installing IBM Application Modernization Accelerator on RHEL

Prerequisites

Before you begin go to the Application Modernization Accelerator Trial and download the Application Modernization Accelerator Local install script. For details on using the signature to verify the downloaded zip, please see here.

Required Resources

Table 1. Minimum default configuration

Installing IBM Application Modernization Accelerator 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 Application Modernization Accelerator Local install script.
2. Create a directory for the Application Modernization Accelerator files, for example, ama_local. Copy the .zip file that you downloaded during the registration step into this directory and extract it:
3. To install Application Modernization Accelerator locally, run the following command:

   ./launch

4. Select 1 if you agree with the terms of the License.
5. Select 1 to install Application Modernization Accelerator.
6. After the installation is complete, you can access Application Modernization Accelerator 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

Installing IBM Application Modernization Accelerator on Windows v11

1. If you haven't already, go to the Registration and download site and download the install script.
2. Extract the script into a directory
3. Install Podman Desktop for Windows.
4. Once podman desktop has been installed, open command prompt and type podman ps to make sure podman is running
5. Open command prompt and goto directory where you have extracted the script and cd into scripts/windowsPodmanDesktop
6. Type launch.bat
7. Accept the license from the menu
8. After accepting the license, select option 1 to install.

Installing IBM Application Modernization Accelerator on macOS using podman

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 Application Modernization Accelerator as normal.
7. If you have already installed podman you need to cleanup the existing podman machine.

   podman machine rm

8. To install Application Modernization Accelerator locally, run the following command:

   ./launch.sh

9. Select 1 if you agree with the terms of the License.
10. Select 1 to install Application Modernization Accelerator.
11. After the installation is complete, you can access Application Modernization Accelerator 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
              

Installing IBM Application Modernization Accelerator on Windows v11 using podman running on Ubuntu

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 Application Modernization Accelerator using the script application-moderniztion-acclerator-<version>.zip.

Known issue

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

error retrieving network namespace

Github podman issue.

Workaround

cd /tmp  
rm -rf
        

Run the launch script again and select 5 to start the Application Modernization Accelerator.