Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 2. Installing the web console

You can install the web console on Linux, Windows, macOS, or Red Hat OpenShift Container Platform.

You can install the web console on Linux, Windows, or macOS operating systems and access the web console in a browser.

The web console has been tested with Chrome and Firefox.

Prerequisites

  • OpenJDK 1.8, OpenJDK 11, Oracle JDK 1.8, or Oracle JDK 11
  • 8 GB RAM
  • If you are installing on macOS, the value of maxproc must be 2048 or greater.

Procedure

  1. Navigate to the MTA Download page and download the web console Local install & OpenShift file.

  2. Extract the .zip file to a directory of your choice.

    Note

    If you are installing on a Windows operating system:

    1. Extract the .zip file to a folder named mta to avoid a Path too long error.
    2. If a Confirm file replace window is displayed during extraction, click Yes to all.

    The installation directory is referred to as <MTA_HOME> in this guide.

  3. Start the web console:

    • Linux operating system: 

      $ <MTA_HOME>/run_mta.sh
      Copy to Clipboard Toggle word wrap

    • Windows operating system: 

      C:\<MTA_HOME>\run_mta.bat
      Copy to Clipboard Toggle word wrap

  4. Open a browser and navigate to http://localhost:8080/mta-web. The web console login page is displayed in your browser.

    Figure 2.1. Web console login page

    web console login page
    View larger image
    web console login page

    The default user is mta and the default password is password.

You can install the web console on OpenShift Container Platform 4.6 and later versions with the Migration Toolkit for Applications Operator.

You can install the web console on OpenShift Container Platform 4.2-4.5 by importing a template and instantiating it to create the web console application.

You can install the web console on OpenShift Container Platform 4.6 and later versions with the Migration Toolkit for Applications Operator.

Note

The Migration Toolkit for Applications Operator is a Community Operator. Red Hat provides no support for Community Operators.

Prerequisites

  • 4 vCPUs, 8 GB RAM, and 40 GB persistent storage.

  • One or more projects in which you can install the web console.

    Important

    Do not install the web console in a default project.

  • cluster-admin privileges to install the Migration Toolkit for Applications Operator.
  • project-admin-user privileges to install the web console application in a project.

Installing the Migration Toolkit for Applications Operator

  1. Log in to the OpenShift web console as a user with cluster-admin privileges.
  2. Click Operators OperatorHub.
  3. Use the Search by keyword field to locate the Migration Toolkit for Applications Operator.
  4. Click Install.
  5. Select a project from the Installed Namespace list and click Install.
  6. Click Operators Installed Operators to verify that the Operator is installed.

Installing the web console application

  1. Log in to the OpenShift web console as a user with project-admin-user privileges.
  2. Switch to the Developer perspective and click +Add.
  3. In the Add view, click Operator Backed.
  4. Click the Migration Toolkit for Applications Operator.
  5. Click Create.
  6. Review the application settings and click Create.
  7. In the Topology view, click the mta-web-console application and then click the Resources tab.
  8. Click the secure-mta-web-console route to open the web console in a new browser window.
  9. Enter the user name mta and the password password and click Log in.

Figure 2.2. Web console login page

web console login page
View larger image
web console login page

You can install the web console on OpenShift Container Platform 4.2-4.5 by importing a template and instantiating it to create the web console application.

Prerequisites

  • 4 vCPUs, 8 GB RAM, and 40 GB persistent storage.

  • One or more projects in which you can install the web console.

    Important

    Do not install the web console in a default project.

Procedure

  1. Navigate to the MTA Download page and download the web console Local install & OpenShift file.
  2. Extract the .zip file to a directory, for example, MTA_HOME.
  3. Launch the OpenShift web console.
  4. Click the Import YAML button in the upper-right corner of the web console.
  5. Select mta from the Project list.

  6. Copy the contents of the appropriate template from the MTA_HOME/openshift/templates/ directory into the Import YAML field.

    Two templates are provided, one for shared storage and one without shared storage.

  7. Click Create.
  8. Switch to the Developer perspective and click +Add.
  9. In the Add view, click From Catalog.
  10. Click the Migration Toolkit for Applications template.
  11. Click Instantiate Template.
  12. Review the application settings and click Create.
  13. In the Topology view, click the mta-web-console application and then click the Resources tab.
  14. Click the secure-mta-web-console route to open the web console in a new browser window.
  15. Enter the user name mta and the password password and click Log in.

Figure 2.3. Web console login page

web console login page
View larger image
web console login page

This section describes how to troubleshoot a web console installation on OpenShift Container Platform.

You can download pod logs using the OpenShift console.

Procedure

  1. Open the OpenShift console and navigate to Applications Pods.
  2. Click the mta-web-console pod.
  3. Click Logs.
  4. Click Download to download and save a log.

2.2.3.2. Downloading logs using the CLI
Copy link

You can download pod logs using the CLI.

Procedure

  1. Obtain the pod names: 

    $ oc get pods -n <project-name>
    Copy to Clipboard Toggle word wrap

    The output resembles the following: 

    NAME                       READY     STATUS      RESTARTS   AGE
eap-builder-1-build        0/1       Completed   0          1d
mta-postgresql-1-hfbdn     1/1       Running     0          1d
mta-sso-1-build            0/1       Completed   0          1d
mta-web-console-1-build    0/1       Completed   0          1d
mta-web-console-1-vt7s5    1/1       Running     1          1d
sso-1-wjl2n                1/1       Running     1          1d
    Copy to Clipboard Toggle word wrap

  2. Use oc logs to examine the pod log: 

    $ oc logs <pod>
    Copy to Clipboard Toggle word wrap
    Note

    You can redirect the output to obtain a copy of the current log: 

    $ oc logs <pod> > ./<pod>.log
    Copy to Clipboard Toggle word wrap

2.2.3.3. No route to host error
Copy link

The No route to host error in the mta-web-console-executor log indicates that the mta-web-console-executor pod cannot connect to the mta-web-console pod: 

13:44:03,501 SEVERE [org.jboss.windup.web.messaging.executor.ExecutorBootstrap] (main) Could not start messaging listener due to: Failed to connect to any server. Servers tried: [http-remoting://192.0.2.4:8080 (java.net.NoRouteToHostException: No route to host)]: javax.naming.CommunicationException: Failed to connect to any server. Servers tried: [http-remoting://192.0.2.4:8080 (java.net.NoRouteToHostException: No route to host)]
Copy to Clipboard Toggle word wrap

This error occurs because the mta-web-console-executor pod starts running before the mta-web-console pod.

Check the mta-web-console-executor log after the mta-web-console pod has been running for a few minutes.

2.2.3.4. Insufficient resources
Copy link

The following conditions indicate insufficient resources:

  • The mta-web-console pod is not running and the following error is displayed on the Events tab of the Pod Details screen in the OpenShift console: 

    0/9 nodes are available: 4 Insufficient cpu, 4 MatchNodeSelector, 9 Insufficient memory.
    Copy to Clipboard Toggle word wrap

  • The mta-web-console-deploy, mta-web-console-executor-deploy, and mta-web-console-postgresql-deploy pods time out and the following error is displayed in the logs: 

    error: update acceptor rejected mta-web-console-executor-1: Pods for rc 'mta/mta-web-console-executor-1' took longer than 600 seconds to become available
    Copy to Clipboard Toggle word wrap

To resolve these problems:

  1. Install and run the cluster capacity tool to determine how many pods you can schedule.

  2. Change the load on the cluster resources by performing one of the following actions:

    • Increase the limit ranges or the resource quotas of your project.
    • Reduce the requested resources of your project. The web console requires a minimum of 4 vCPUs and 8 GB RAM.
    • Run fewer jobs.
  3. Redeploy the web console.

2.2.3.5. Reporting issues
Copy link

MTA uses Jira as its issue tracking system. If you encounter an issue executing MTA, submit a Jira issue.

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat