Merge pull request #142 from anarnold97/MTA-4887-MTA-CLI-JDK-requirements-for-Linux-devel-package

MTA-4887: Ensure that JDK requirements for RHEL & Fedora indicate to install Development package

Author: anarnold97

docs/topics/installing-cli-tool.adoc

@@ -11,17 +11,45 @@ You can install the {CLINameTitle} on Linux, Windows, or macOS operating systems
 
 [IMPORTANT]
 ====
-Starting from {ProductShortName} 7.2.0, you can run the application analysis for Java applications  in the containerless mode.
+Starting from {ProductShortName} 7.2.0, you can run the application analysis for Java applications in the containerless mode.
 
 The containerless mode is set by default and is used automatically if all requirements are met. For more information, see xref:running-the-containerless-mta-cli_cli-guide[Running the containerless CLI].
 
 However, if you want to analyze applications in languages other than Java or, for example, use xref:mta-cli-transform_cli-guide[transformation commands], you still need to use containers.
 ====
 
-.Prerequisites
+.Prerequisites for containerized CLI
+
+The following are the prerequisites for the {ProductFullName} CLI installation (container):
 
 * Red Hat Container Registry Authentication for `registry.redhat.io`. Red Hat distributes container images from `registry.redhat.io`, which requires authentication. For more details, see link:https://access.redhat.com/RegistryAuthentication[Red Hat Container Registry Authentication].
 
+* link:https://podman.io/[Podman] must be installed.
+
+* 8 GB of RAM is required for the {ProductShortName} {CLIName}.
+
+.Prerequisites for containerless CLI
+
+The following are the prerequisites if you want to to run {ProductShortName} {CLIName} as in xref:running-the-containerless-mta-cli_cli-guide[containerless CLI] mode:
+
+* Java Development Kit (JDK) is installed.
++
+{ProductShortName} supports the following JDKs:
+
+** Oracle JDK 17 or later
+** Eclipse Temurin™ JDK 17 or later
+** OpenJDK 17 or later
++
+If you install OpenJDK on {op-system-base-full} or Fedora, the JDK requires a compiler provided by the `devel` package to also be installed, as having only the Java Runtime (JRE) installed causes issues during analysis. For more information about installing Red Hat build of OpenJDK 17 on {op-system-base-full}, see link:https://docs.redhat.com/en/documentation/red_hat_build_of_openjdk/17/html-single/installing_and_using_red_hat_build_of_openjdk_17_on_rhel/index#installing-jre-on-rhel-using-archive_openjdk[Installing Red Hat build of OpenJDK on RHEL by using yum].
+
+* You must set the `JAVA_HOME` and the `PATH` environment variables.
+
+* Maven 3.9.9 installed, and the bin directory is added to the `PATH` environment variable. Setting the path and environment variables depends on the operating system you are using. For more information about installing Maven, see link:https://maven.apache.org/install.html[Apache Maven installation].
+
+* macOS installation requires:
+
+** The value of `maxproc` must be `2048` or greater.
+
 [id="installing-downloadable-cli-zip_{context}"]
 == Installing the {CLINameTitle} `.zip` file
 
@@ -45,7 +73,12 @@ When you encounter `<{ProductShortName}_HOME>` in this guide, replace it with th
 [id="installing-using-podman_{context}"]
 == Installing the {CLINameTitle} by using Podman
 
-You can install the {CLINameTitle} using `podman pull`.
+You can install the containerized {CLINameTitle} using `podman pull`.
+
+[NOTE]
+====
+You cannot install the containerless {CLINameTitle} using Podman as this procedure does not include pulling and unpacking the dependencies that are included in the `.zip` file.
+====
 
 .Prerequisites
 

docs/topics/snippet_jdk-hardware-mac-prerequisites.adoc

@@ -4,12 +4,10 @@ The following are the prerequisites for the {ProductFullName} installation:
 
 * Java Development Kit (JDK) is installed. {ProductShortName} supports the following JDKs:
 
-** OpenJDK 11
-** OpenJDK 17
-** Oracle JDK 11
-** Oracle JDK 17
-** Eclipse Temurin™ JDK 11
-** Eclipse Temurin™ JDK 17
-
-* 8 GB RAM
+** Oracle JDK 17 or later
+** Eclipse Temurin™ JDK 17 or later
+** OpenJDK 17 or later
+
+* 8 GB of RAM is required for {ProductShortName}.
+
 * macOS installation: the value of `maxproc` must be `2048` or greater.

docs/topics/templates/document-attributes.adoc

@@ -40,6 +40,8 @@ ifdef::mta[]
 :ocp: OCP
 :ocp-version: 4.18
 :ocp-supported: 4.18, 4.17, 4.16
+:op-system-base-full: Red Hat Enterprise Linux (RHEL)
+:op-system-base: RHEL
 endif::[]
 
 ifdef::mtr[]