Step 1: Install App2Container - AWS App2Container

Step 1: Install App2Container

To get started with App2Container, the first step is to download and install the application. To help ensure a successful installation, you can verify the integrity and authenticity of the binary file before installing it.

Choose the tab that matches your operating system (OS) platform to continue:

Linux

App2Container for Linux is packaged as a tar.gz archive. The archive contains an interactive shell script that installs App2Container on your server. If you use an application server and a worker machine, you must install App2Container on both.

To download and install App2Container for Linux

  1. Download the installation file in one of the following ways:

  2. Extract the package to a local folder on the server.

    $ sudo tar xvf AWSApp2Container-installer-linux.tar.gz
  3. Run the install script that you extracted from the package and follow the prompts.

    $ sudo ./install.sh

To check the downloaded tar.gz installer archive for integrity, you can validate the SHA256 hash of the local file against the published hash file.

Verify the integrity of the download

  1. Generate hashes to verify

    From the directory where you downloaded your tar.gz installer, run the following command to generate the hash of the downloaded tar.gz file.

    $ sha256sum AWSApp2Container-installer-linux.tar.gz 9482952019adb6df96c7be773aa20ecb8de559083b99c270c67c34da56dd8dee AWSApp2Container-installer-linux.tar.gz
  2. Verify hashes against the public file

    Download the App2Container hash file from Amazon S3 with the following link, and compare the contents to the hash that you generated in step 1:

To verify the authenticity of the download, run the following commands to download the certificate and signature files, and verify the signature.

Verify the authenticity of the download

  1. Download the App2Container certificate:

    curl -o app2container.cert https://app2container-keys.s3.us-east-1.amazonaws.com/latest/app2container.cert
  2. Download the App2Container signature file:

    curl -o app2container.sig https://app2container-release-us-east-1.s3.us-east-1.amazonaws.com/latest/linux/app2container.sig
  3. Verify the signature:

    openssl dgst -sha256 -verify app2container.cert -signature app2container.sig /usr/bin/app2container
Windows

App2Container for Windows is packaged as a zip archive. The package contains a PowerShell script that installs App2Container. If you use an application server and a worker machine, you must install App2Container on both.

To download and install App2Container for Windows

  1. Download the App2Container installation package, AWSApp2Container-installer-windows.zip.

  2. Extract the package to a local folder on the server and navigate to that folder.

    Note

    App2Container automatically enables NTFS long paths for all supported Windows versions so that you can use file paths longer than 260 characters. For more information about this setting, see How to enable NTFS Long Paths in Windows 10 / Windows Server 2016 / 2019 or newer (PDF).

  3. Run the install script from the folder where you extracted it, and follow the prompts.

    PS> .\install.ps1
  4. (Optional) To verify the authenticity of the download, use the Get-AuthenticodeSignature PowerShell command as follows to get the Authenticode Signature of the App2Container executable.

    PS> Get-AuthenticodeSignature C:\Users\Administrator\app2container\AWSApp2Container\bin\app2container.exe

To check the downloaded zip archive for integrity, you can validate the SHA256 hash of the local file against the published hash file.

To verify the integrity of the download

  1. Generate hashes to verify

    From the directory where you downloaded your zip archive, run the following command to generate the hash of the downloaded archive file.

    PS> Get-FileHash C:\Users\Administrator\Downloads\AWSApp2Container-installer-windows.zip -Algorithm SHA256
  2. Verify hashes against the public file

    Download the App2Container hash file from Amazon S3 with the following link, and compare the contents to the hash that you generated in step 1: