Merge pull request #29 from anarnold97/mta-disconnected-install

MTA-3245: Document disconnected usage of MTA CLI

Author: raoradhika

docs/cli-guide/master.adoc

@@ -40,6 +40,9 @@ include::topics/about-cli.adoc[leveloffset=+2]
 // Install the CLI
 include::topics/installing-cli-tool.adoc[leveloffset=+2]
 
+// Install in disconnected environment
+include::topics/installing-mta-disconnected-environment.adoc[leveloffset=+2]
+
 // CLI known issues
 include::topics/cli-tool-known-issues.adoc[leveloffset=+3]
 

docs/topics/installing-mta-disconnected-environment.adoc

@@ -0,0 +1,91 @@
+// Module included in the following assemblies:
+//
+// * docs/cli-guide/master.adoc
+
+:_content-type: PROCEDURE
+[id="installing-mta-disconnected-environment_{context}"]
+= Installing {ProductShortName} on a disconnected environment
+
+On a connected device, first download and save the {ProductShortName} binary. Then download and save the Podman images, the {ProductShortName} CLI image and the provider image that you need.
+
+* Download the required {ProductShortName} CLI binary from the link:https://developers.redhat.com/products/mta/download[{ProductName} Red Hat Developer page]:
+** CLI for Linux x86_64 
+** CLI for Linux aarch64
+** CLI for MacOS x86_64
+** CLI for MacOS aarch64
+** CLI for Windows x86_64
+** CLI for Windows aarch64
+
+* On a connected device, download and save the images.
+
+* Copy the binary to the disconnected device.
+
+* In addition, you must save and import the associated container images by using Podman.
+
+== Downloading the Podman images
+
+.Prerequisites
+
+* Podman installed. For more information, see link:https://podman.io/[Podman].
+
+.Procedure
+
+. Use Podman to authenticate to link:registry.redhat.io[registry.redhat.io]:
++
+[source,terminal]
+----
+$ podman login registry.redhat.io
+----
+
+. Enter your username and then your password for registry.redhat.io:
++
+[source,terminal]
+----
+Username: <registry_service_account_username>
+Password: <registry_service_account_password>
+----
++
+You should see the following output:
++
+[source,terminal]
+----
+Login Succeeded!
+----
+
+. Use Podman to pull the image from the registry:
++
+[source,terminal]
+----
+$ podman pull registry.redhat.io/mta/mta-cli-rhel9:7.1.0
+----
+
+. Use Podman to pull the provider image that you need from the registry:
+
+.. For Java, run:
++
+[source,terminal]
+----
+$ podman pull registry.redhat.io/mta/mta-java-external-provider-rhel9:7.1.0
+----
+.. For .NET, run:
++
+[source,terminal]
+----
+$ podman pull registry.redhat.io/mta/mta-dotnet-external-provider-rhel9:7.1.0
+----
+
+. Save the images:
++
+[source,terminal]
+----
+$ podman save <image> -o <my_image.image>
+----
+
+. Copy the `.image` file and the binary onto a USB or directly to the file system of the disconnected device.
+
+. On the disconnected device, run
++
+[source,terminal]
+----
+$ podman load --input <my_image.image>
+----

docs/topics/mta-cli-run.adoc

@@ -39,7 +39,7 @@ The following command analyzes the link:https://github.com/windup/windup/blob/ma
 ----
 $ <{ProductShortName}_HOME>/{mta-cli} analyze \
     --input /path/to/jee-example-app-1.0.0.ear \
-    --output /path/to/report-output/ --source eap5 --target eap7 \
+    --output /path/to/report-output/ --source eap5 --target eap7
 ----
 []