Skip to main content

Troubleshooting

The following sections provide step-by-step guidance for diagnosing and resolving common issues when deploying and operating the Cloud Scanner on Amazon Web Services.

Verify system logs​

When launching the Cloud Scanner's worker EC2 instances in your AWS account, you can confirm that the deployment and connection processes were completed successfully by examining the EC2 system logs. This inspection helps ensure that the instances are properly configured and are communicating as expected.

Accessing the system logs​

To access the system logs, follow these steps:

  1. Open the Amazon EC2 console .
  2. In the left navigation pane, choose Instances.
  3. Select the instance and then choose Actions > Monitor and troubleshoot > Get system log.
note

Please allow a few minutes for the logs to become available for a newly started instance.

Analyzing the system logs​

Once you have access to the system logs, you should look for specific entries that confirm the instance is performing as expected:

  1. Verify Userdata Execution: Search for the entry running 'modules:final'. This indicates that the userdata script has started executing. This is a crucial step where various initialization scripts configure the instance.
  2. Verify Initial Configuration: Search for the entry upwind credentials. This indicates that the instance has the necessary permissions to retrieve the client credentials from the SSM Parameter Store.

Following this, the logs should show that the instance is downloading and executing the installation script from Upwind. This is critical as it sets up the necessary software and configurations specific to your deployment.

[   15.318129] cloud-init[917]: Cloud-init v. 23.4.4-0ubuntu0~22.04.1 running 'modules:final' at Mon, 15 Apr 2024 08:31:29 +0000. Up 15.27 seconds.
<13>Apr 15 08:31:29 user-data: Getting upwind credentials from SSM for usc5-8f517ce4d4532b7cd ...
<13>Apr 15 08:31:29 user-data: Getting CloudScanner install script for usc5-8f517ce4d4532b7cd ...
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 20248  100 20248    0     0  161k      0 --:--:-- --:--:-- --:--:--  161k
<13>Apr 15 08:31:31 user-data: Executing CloudScanner install for usc5-8f517ce4d4532b7cd ...
<13>Apr 15 08:31:31 user-data: Beginning CloudScanner installer script ...
<13>Apr 15 08:31:31 user-data: [34m
<13>Apr 15 08:31:31 user-data: *** Upwind CloudScanner install script: latest*** [0m
<13>Apr 15 08:31:31 user-data: INFO: Running checks ...
<13>Apr 15 08:31:31 user-data: INFO: Finished checks ...
<13>Apr 15 08:31:31 user-data: INFO: Checking SubCommand ...
<13>Apr 15 08:31:31 user-data: INFO: 'install' detected ...
<13>Apr 15 08:31:31 user-data: INFO: Installing Upwind CloudScanner
<13>Apr 15 08:31:31 user-data: INFO: Generating config ...
<13>Apr 15 08:31:31 user-data: INFO: Creating config file: /etc/upwind/agent.yaml

Ubuntu 22.04.4 LTS ip-192-168-9-28 ttyS0