Download aapctl

Download the aapctl command-line tool from the Red Hat Customer Portal. Use aapctl to install and manage automation orchestrator on your OpenShift cluster.

Before you begin

  • An active Red Hat subscription that includes Ansible Automation Platform.
  • A Red Hat Customer Portal account with download permissions.

About this task

Important:

aapctl is a Technology Preview feature. Technology Preview features provide early access to upcoming product innovations, enabling you to test functionality and provide feedback during the development process. Technology Preview features are not fully supported under Red Hat production SLA and may not be functionally complete. Red Hat does not recommend using Technology Preview features in production. For more information on the support scope for Technology Preview features, see Technology Preview Features Support Scope.

Procedure

  1. Log in to the Red Hat Customer Portal.
  2. Navigate to Downloads > Ansible Automation Platform.
  3. From the Version dropdown, select an Ansible Automation Platform version.
    • 2.7 for RHEL 9
    • 2.7 for RHEL 10

    Both version pages list identical aapctl binaries. Select either version page.

  4. Locate the aapctl binary for your workstation operating system (Linux or macOS) and architecture (x86_64 or aarch64).
  5. Click the filename to download the .tar.gz archive to your workstation.
  6. Extract the binary from the archive.

    On Linux:

    $ tar xzf aapctl-stable-linux-arch-version.tar.gz

    On macOS:

    $ tar xzf aapctl-stable-darwin-arch-version.tar.gz
  7. Make the binary executable. 
    $ chmod +x aapctl
  8. If your workstation runs macOS, remove the quarantine attribute so that Gatekeeper does not block the binary. 
    $ xattr -d com.apple.quarantine aapctl
  9. Move the binary to a directory in your PATH. 
    $ sudo mv aapctl /usr/local/bin/
  10. Verify that aapctl is available. 
    $ aapctl version