Step 2 – Install the AWS PCS agent

To install the AWS PCS agent

1. Connect to the instance you launched. For more information, see Connect to your Linux instance.

2. (Optional) To ensure that all of your software packages are up to date, perform a quick software update on your instance. This process may take a few minutes.

   • Amazon Linux 2, RHEL 9, Rocky Linux 9

     sudo yum update -y

   • Ubuntu 22.04

     sudo apt-get update && sudo apt-get upgrade -y

3. Reboot the instance and reconnect to it.

4. Download the AWS PCS agent installation files. The installation files are packaged into a compressed tarball (.tar.gz) file. To download the latest stable version, use the following command. Substitute region with the AWS Region where you launched your temporary instance, such as us-east-1.

   curl https://aws-pcs-repo-region.s3.amazonaws.com/aws-pcs-agent/aws-pcs-agent-v1.2.0-1.tar.gz -o aws-pcs-agent-v1.2.0-1.tar.gz

   You can also get the latest version by replacing the version number with latest in the preceding command (for example: aws-pcs-agent-v1-latest.tar.gz).

   Note

   This might change in future releases of the AWS PCS agent software.

5. (Optional) Verify the authenticity and integrity of the AWS PCS software tarball. We recommend that you do this to verify the identity of the software publisher and to check that the file has not been altered or corrupted since it was published.

   1. Download the public GPG key for AWS PCS and import it into your keyring. Substitute region with the AWS Region where you launched your temporary instance. The command should return a key value. Record the key value; you use it in the next step.

      wget https://aws-pcs-repo-public-keys-region.s3.amazonaws.com/aws-pcs-public-key.pub && \
          gpg --import aws-pcs-public-key.pub

   2. Run the following command to verify the GPG key's fingerprint.

      gpg --fingerprint 7EEF030EDDF5C21C

      The command should return a fingerprint that is identical to the following:

      1C24 32C1 862F 64D1 F90A  239A 7EEF 030E DDF5 C21C

      Important

      Don't run the AWS PCS agent installation script if the fingerprint doesn't match. Contact AWS Support.

   3. Download the signature file and verify the signature of the AWS PCS software tarball file. Replace region with the AWS Region where you launched your temporary instance, such as us-east-1.

      wget https://aws-pcs-repo-region.s3.amazonaws.com/aws-pcs-agent/aws-pcs-agent-v1.2.0-1.tar.gz.sig && \
          gpg --verify ./aws-pcs-agent-v1.2.0-1.tar.gz.sig

      The output should be similar to the following:

      gpg: assuming signed data in './aws-pcs-agent-v1.2.0-1.tar.gz'
      gpg: Signature made Fri Dec 13 18:50:19 2024 CEST
      gpg:                using RSA key 4BAA531875430EB0739E6D961BA7F0AF6E34C496
      gpg: Good signature from "AWS PCS Packages (AWS PCS Packages)" [unknown]
      gpg: WARNING: This key is not certified with a trusted signature!
      gpg:          There is no indication that the signature belongs to the owner.
      Primary key fingerprint: 1C24 32C1 862F 64D1 F90A  239A 7EEF 030E DDF5 C21C
         Subkey fingerprint: 4BAA 5318 7543 0EB0 739E  6D96 1BA7 F0AF 6E34 C496

      If the result includes Good signature and the fingerprint matches the fingerprint returned in the previous step, proceed to the next step.

      Important

      Don't run the AWS PCS software installation script if the fingerprint doesn't match. Contact AWS Support.

6. Extract the files from the compressed .tar.gz file and navigate to the extracted directory.

   tar -xf aws-pcs-agent-v1.2.0-1.tar.gz && \
       cd aws-pcs-agent

7. Install the AWS PCS software.

   sudo ./installer.sh

8. Check the AWS PCS software version file to confirm a successful installation.

   cat /opt/aws/pcs/version

   The output should be similar to the following:

   AGENT_INSTALL_DATE='Fri Dec 13 12:28:43 UTC 2024'
   AGENT_VERSION='1.2.0'
   AGENT_RELEASE='1'