1 Troubleshooting FAQ

first edited this page 2025-07-07 04:12:29 +00:00

• Error: externally-managed-environment

  • Cause: Your Linux distribution is protecting its system-wide Python environment.
  • Solution: You must use a Python virtual environment (venv) as described in the Getting Started guide. Do not use --break-system-packages.

• Error: Unable to locate credentials

  • Cause: The script, via the boto3 SDK, could not find any AWS credentials.
  • Solution: Verify your setup from Step 4: Configure Server Permissions. If on EC2, ensure the IAM Instance Profile is correctly attached. If external, ensure the ~/.aws/credentials file exists, is correctly formatted, and is readable by the user running the script.

• Error: AccessDenied on s3:PutObject

  • Cause: Authentication was successful, but the IAM policy does not authorize the user/role to write to the specific S3 path.
  • Solution: This is a policy mismatch. Edit the IAM policy in the AWS console. Ensure the Resource ARN in the policy statement (e.g., arn:aws:s3:::your-bucket/your-prefix/*) exactly matches the bucket and prefix the script is trying to upload to.

1. Project Wiki: regularbm
2. Introduction
3. Core Concepts
   • Pattern A
   • Pattern B
4. Getting Started - A Step-by-Step Guide
   • Step 1: System Prerequisites
   • Step 2: Deploy Cloud Infrastructure
   • Step 3: Configure the Script Environment
   • Step 4: Configure Server Permissions
   • Step 5: Test and Automate
5. Technical Deep Dive
   • The Backup Process
   • Packaging
   • Configuration: Script Arguments
6. Troubleshooting FAQ