Migration Toolkit for Applications 5.0 Web Console Guide Use the Migration Toolkit for Applications web console to group your applications into projects for analysis. Last Updated: 2021-01-25 Migration Toolkit for Applications 5.0 Web Console Guide Use the Migration Toolkit for Applications web console to group your applications into projects for analysis. Legal Notice Copyright © 2021 Red Hat, Inc. The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/ . In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version. Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. Linux ® is the registered trademark of Linus Torvalds in the United States and other countries. Java ® is a registered trademark of Oracle and/or its affiliates. XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. MySQL ® is a registered trademark of MySQL AB in the United States, the European Union and other countries. Node.js ® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project. The OpenStack ® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community. All other trademarks are the property of their respective owners. Abstract This guide describes how to use the Migration Toolkit for Applications web console to simplify migration of Java applications. Table of Contents Table of Contents .M . A. .K . I.N . .G . .O . P. .E . N. S. .O . U. .R . C. .E . .M . .O . R. .E . .I N. .C . L. .U . S. .I V. .E . 3. .C . H. .A . P. .T .E . R. 1.. .I .N . T. .R .O . .D . U. .C . T. .I O. N. .4 . 1.1. ABOUT THE WEB CONSOLE GUIDE 4 1.2. ABOUT THE MIGRATION TOOLKIT FOR APPLICATIONS 4 What is the Migration Toolkit for Applications? 4 How does the Migration Toolkit for Applications simplify migration? 4 How do I learn more? 4 1.3. ABOUT THE WEB CONSOLE 4 .C . H. .A . P. .T .E . R. 2. I.N . .S .T . A. .L . L. .I N. .G . .T . H. .E . .W . .E . B. C. .O . N. .S . O. .L . E. 5. 2.1. INSTALLING THE WEB CONSOLE ON LINUX, WINDOWS, OR MACOS 5 2.2. INSTALLING THE WEB CONSOLE ON OPENSHIFT CONTAINER PLATFORM 6 2.2.1. Understanding the web console image 6 OpenShift template environment variables 8 2.2.2. Importing a web console template 8 2.2.3. Accessing the web console 9 2.2.4. Troubleshooting 10 2.2.4.1. Obtaining the latest image 10 2.2.4.2. Examining and collecting web console logs 11 2.2.4.3. Common issues 11 2.2.4.4. Reporting issues 13 .C . H. .A . P. .T .E . R. 3. A. .N . .A . L. Y. .Z . I.N . G. .A . P. .P .L . I.C . A. .T . I.O . .N . S. W. I.T . H. T. H. E. .W . .E . B. C. .O . N. S. O. L. .E . 1.4 . 3.1. ADDING A PROJECT 14 3.2. ADDING APPLICATIONS TO A PROJECT 15 3.3. CONFIGURING AN ANALYSIS 16 3.4. RUNNING AN ANALYSIS 18 3.5. VIEWING ANALYSIS RESULTS 18 3.5.1. Viewing analysis details 19 3.5.2. Reviewing reports 20 .C . H. .A . P. .T .E . R. 4. .U . S. .I N. .G . .C . U. .S . T. .O . M. .R . U. .L . E. .S . A. .N . D. .L .A . B. .E . L. .S . 2. .1 . 4.1. ADDING CUSTOM RULES 21 4.2. ADDING CUSTOM LABELS 21 .C . H. .A . P. .T .E . R. 5. C. .O . .N . F. .I G. .U . .R .I .N . G. A. .U . T. .H . E. .N . T. .I C. .A . T. .I O. N. F. O. R. T. H. E. .W . .E . B. C. .O . .N . S. .O . L. .E . .2 . 3. 5.1. ENABLING AUTHENTICATION FOR WEB CONSOLE 23 5.2. CHANGING THE ADMINISTRATIVE USER’S CREDENTIALS 23 5.3. REMOVING THE DEFAULT WEB CONSOLE USER 24 5.4. ADDING A WEB CONSOLE USER 25 1 Migration Toolkit for Applications 5.0 Web Console Guide 2 MAKING OPEN SOURCE MORE INCLUSIVE MAKING OPEN SOURCE MORE INCLUSIVE Red Hat is committed to replacing problematic language in our code, documentation, and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. Because of the enormity of this endeavor, these changes will be implemented gradually over several upcoming releases. For more details, see our CTO Chris Wright’s message . 3 Migration Toolkit for Applications 5.0 Web Console Guide CHAPTER 1. INTRODUCTION 1.1. ABOUT THE WEB CONSOLE GUIDE This guide is for engineers, consultants, and others who want to use the Migration Toolkit for Applications (MTA) to migrate Java applications or other components. It describes how to install and use the web console to manage migration projects and analyze applications. 1.2. ABOUT THE MIGRATION TOOLKIT FOR APPLICATIONS What is the Migration Toolkit for Applications? The Migration Toolkit for Applications (MTA) is an extensible and customizable rule-based tool that simplifies the migration of Java applications. The MTA examines application artifacts, including project source directories and application archives, then produces an HTML report that highlights areas needing changes. MTA can migrate Java applications from earlier versions of Red Hat JBoss Enterprise Application Platform or from other application servers, such as Oracle WebLogic Server or IBM WebSphere Application Server. How does the Migration Toolkit for Applications simplify migration? The Migration Toolkit for Applications looks for common resources and highlights technologies and known trouble spots when migrating applications. The goal is to provide a high-level view into the technologies used by the application and provide a detailed report organizations can use to estimate, document, and migrate enterprise applications to Java EE and Red Hat JBoss Enterprise Application Platform. How do I learn more? See the Introduction to the Migration Toolkit for Applications to learn more about the features, supported configurations, system requirements, and available tools in the Migration Toolkit for Applications. 1.3. ABOUT THE WEB CONSOLE The web console for the Migration Toolkit for Applications allows a team of users to assess and prioritize migration and modernization efforts for a large number of applications. It allows you to group applications into projects for analysis and provides numerous reports that highlight the results. 4 CHAPTER 2. INSTALLING THE WEB CONSOLE CHAPTER 2. INSTALLING THE WEB CONSOLE You can install the web console on Linux, Windows, macOS, or OpenShift Container Platform. 2.1. INSTALLING THE WEB CONSOLE ON LINUX, WINDOWS, OR MACOS 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 macOS: The value of maxproc must be 2048 or greater. Procedure 1. Download the installation archive file from the MTA Download page . 2. Extract the .zip file to a directory of your choice. NOTE If you are installing on a Windows operating system, extract the .zip file to a folder named mta to avoid a Path too long error. The directory is referred to as <MTA_HOME> in this guide. 3. Start the web console: Linux operating system: $ <MTA_HOME>/run_mta.sh Windows operating system: C:\<MTA_HOME>\run_mta.bat 4. Open a browser and navigate to http://localhost:8080/mta-web. Figure 2.1. Welcome Page 5 Migration Toolkit for Applications 5.0 Web Console Guide Figure 2.1. Welcome Page The web console installation creates a default mta user with a default password, password. You can add additional users to the web console. 2.2. INSTALLING THE WEB CONSOLE ON OPENSHIFT CONTAINER PLATFORM You can install the MTA web console on Red Hat OpenShift Container Platform and access the web console in a browser. 2.2.1. Understanding the web console image Red Hat offers containerized images for MTA that are designed for use with OpenShift Container Platform. Using these images developers can quickly and easily manage migration projects and analyze applications. The MTA image installs the following Pods: The Executor Pod runs analyses and generates reports The Web Console + Red Hat Single Sign-on (SSO) Pod provides access to the web console The PostgreSQL Pod stores the project’s configuration and analysis tracking information A separate persistent volume is used for the web console interface and the PostgreSQL Pods. The Executor Pod’s storage is dependent on the template used. The web-template-empty-dir-executor.json is the recommended template. It configures the Executor Pod to use temporary storage on a single machine and has no defined persistent volume.