aws / aws/aws-toolkit-vscode

OS Not Recognized - Oracle Linux 8 - Failure to Connect Remote Workspace in VSCode

Open
#7,452 2 comments 0 reactions 0 assignees View on GitHub
bug remote-execute service:ec2 service:ecs
Dominant language
TypeScript
Stars
2k
Forks
807
Avg merge
10h 12m
Merged PRs (30d)
7

Description

## Problem

AWS Toolkit works fine to access remote ec2/ecs instances through ssm, giving access to the shell using ssm-user. However, when we try to attach the workspace to the remote instance, it fails complaining that cannot recognize the OS Name "Oracle Linux 8", which is based on RHEL and similar (or even identical) to CentOS 8.

## Steps to reproduce the issue
1. Connect to AWS Toolkit.
2. Navigate to EC2 -> (any instance) -> click on Connect VS Code to EC2 Instance.

Error message:
```
Unrecognized OS name Oracle Linux Server on instance i-1234567890abcdefg
```

Full log:
```
[info] Command: (not started) [/usr/local/bin/bash -i -l -c '/home/ndsadmin/.vscode-server/bin/(...)/node' -p '"(...)" + JSON.stringify(process.env) + "(...)"']
2025-06-09 13:31:41.358 [warning] getUnixShellEnvironment#stderr:bash: cannot set terminal process group (-1): Inappropriate ioctl for device
bash: no job control in this shell
2025-06-09 13:31:41.358 [info] Command: (not started) [sessionmanagerplugin/bin/session-manager-plugin --version]
2025-06-09 13:31:41.374 [info] Command: (not started) [/home/ndsadmin/.vscode-server/data/User/globalStorage/amazonwebservices.aws-toolkit-vscode/tools/Amazon/sessionmanagerplugin/bin/session-manager-plugin --version]
2025-06-09 13:32:06.436 [info] telemetry: sent batch (size=20)
2025-06-09 13:32:06.531 [info] telemetry: sent batch (size=20)
2025-06-09 13:32:06.590 [info] telemetry: sent batch (size=15)
2025-06-09 13:32:35.080 [error] aws.ec2.openRemoteConnection: Error: Unrecognized OS name Oracle Linux Server on instance i-1234567890abcdefg [UnknownEc2OS]
```

## Expected behavior

To be able to connect with workspace to any EC2 instances or ECS tasks' containers.

## System details (run `AWS: About` and/or `Amazon Q: About`)

- OS: Oracle Linux 8 / RHEL (similar to CentOS)
- Visual Studio Code version: 1.85.2 (Universal)
- AWS Toolkit version: v3.64.0
- Amazon Q version: N/A

Details found in the `/etc/release-os`:
```
NAME="Oracle Linux Server"
VERSION="8.10"
ID="ol"
ID_LIKE="fedora"
VARIANT="Server"
VARIANT_ID="server"
VERSION_ID="8.10"
PLATFORM_ID="platform:el8"
PRETTY_NAME="Oracle Linux Server 8.10"
ANSI_COLOR="0;31"
CPE_NAME="cpe:/o:oracle:linux:8:10:server"
HOME_URL="https://linux.oracle.com/"
BUG_REPORT_URL="https://github.com/oracle/oracle-linux"

ORACLE_BUGZILLA_PRODUCT="Oracle Linux 8"
ORACLE_BUGZILLA_PRODUCT_VERSION=8.10
ORACLE_SUPPORT_PRODUCT="Oracle Linux"
ORACLE_SUPPORT_PRODUCT_VERSION=8.10
```

Command `uname -a`:
```
Linux ip-10-XXX-XX-XXX.ec2.internal 4.18.0-553.51.1.el8_10.x86_64 #1 SMP Wed Apr 30 02:25:35 PDT 2025 x86_64 x86_64 x86_64 GNU/Linux
```

Contributor guide

Open the contributing guide

Research direction

Start by tracing the aws.ec2.openRemoteConnection failure and the OS detection used for EC2 remote workspace connections. Reproduce with an Oracle Linux 8 instance, compare its release information with supported systems, and verify that the workspace connection succeeds without the UnknownEc2OS error.

Written by the indexing model from the issue text.

Assessment

Tech stack
aws, linux, typescript, vscode
Domain
cloud, devtools, operating-systems
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.