installing-cli-tool.adoc

Installing the {CLINameTitle}

You can install the {CLINameTitle} on Linux, Windows, or macOS operating systems.

Prerequisites

• 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 Red Hat Container Registry Authentication.

• Podman must be installed

  Note

  Podman Podman is a daemonless, open source, Linux native tool designed to make it easy to find, run, build, share and deploy applications using Open Containers Initiative (OCI) Containers and Container Images. Podman provides a command line interface (CLI) familiar to anyone who has used the Docker Container Engine. For more information on installing and using Podman, see Podman installation instructions.

Installing the {CLINameTitle} .zip file

Procedure

To install using the downloadable .zip file:

1. Navigate to the {ProductShortName} Download page and download the OS specific CLI file or the src file:

   • {ProductShortNameLower}-{ProductVersion}-cli-linux.zip

   • {ProductShortNameLower}-{ProductVersion}-cli-macos.zip

   • {ProductShortNameLower}-{ProductVersion}-cli-windows.zip

   • {ProductShortNameLower}-{ProductVersion}-cli-src.zip

2. Extract the .zip file to a directory of your choice. The .zip file extracts a single binary, called mta-cli.

   When you encounter <{ProductShortName}_HOME> in this guide, replace it with the actual path to your {ProductShortName} installation.

3. Copy or save the mta-cli binary to a known directory.

   Continue to Running the CLI to run the CLI command.

Installing the {CLINameTitle} using Podman

Prerequisites

• 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 Red Hat Container Registry Authentication.

Procedure

To install using podman pull:

1. To use Podman to authenticate to registry.redhat.io:

   podman login registry.redhat.io
   Username: <username>
   Password: <***********>

2. Issue:

   podman cp $(podman create registry.redhat.com/mta-toolkit/mta-mta-cli-rhel9:{ProductVersion}):/usr/local/bin/mta-cli ./

   This command will copy the binary PATH for system-wide use.

   Warning

   Although installation using Podman is possible, downloading installing the .zip file is the preferred installation.