Skip to content

Commit 2364b7f

Browse files
Update IDE troubleshooting section in README
1 parent 6bb64d1 commit 2364b7f

File tree

1 file changed

+10
-16
lines changed

1 file changed

+10
-16
lines changed

README.md

Lines changed: 10 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -639,11 +639,7 @@ SageMaker Studio resources, if you don't need them anymore, e.g., launched noteb
639639
640640
* Check that the managed instance in AWS Console in Systems Manager -> Fleet Manager section appears as "Online". Check that you're able to connect to the node from the Console by selecting Node actions -> Start terminal session.
641641
642-
* Check that the instance ID your local machine tries to connect to and instance ID
643-
that `init-ssm` command produced in the notebook are the same.
644-
645-
If you initialized SSM multiple times in your kernel app, you can see this error message
646-
shortly after the re-initialization:
642+
If instance is "Offline", you might see this error message when calling an `sm-local-ssh-ide` command:
647643
648644
```text
649645
An error occurred (TargetNotConnected) when calling the StartSession operation: mi-1234567890abcdef0 is not connected.
@@ -655,28 +651,24 @@ or this one:
655651
An error occurred (InvalidInstanceId) when calling the SendCommand operation: Instances [[mi-1234567890abcdef0]] not in a valid state for account 555555555555
656652
```
657653
658-
The reason for this error is that CloudWatch logs arrive with some delay, and previous instance ID is fetched
659-
instead of a new one. Wait for 30-60 seconds to allow logs to come through and try again.
654+
* Check SSM agent logs inside SageMaker Studio. From the image terminal run:
655+
```text
656+
tail /var/log/amazon/ssm/*.log && date
657+
```
660658
661659
* Check that `sshd` process is started in SageMaker Studio notebook by running a command in the image terminal:
662660
663661
```shell
664662
ps xfa | grep sshd
665663
```
666664
667-
If it's not started, there might be some errors in the output of the notebook, and you might get this error on
668-
the local machine:
665+
If it's not started, there might be some errors in the output of the notebook, and you might get this error on the local machine:
669666
670667
```text
671668
Connection closed by UNKNOWN port 65535
672669
```
673670
674-
Check carefully the notebook output in SageMaker Studio and try to stop and start SSM & services again.
675-
676-
* Also check SSM agent logs inside SageMaker Studio. From the image terminal run:
677-
```text
678-
tail /var/log/amazon/ssm/*.log && date
679-
```
671+
Check carefully the notebook output in SageMaker Studio to see if there are any installation or configuration problems that have to be fixed.
680672
681673
* Sometimes you can see this error message on your local machine when trying to connect with SSM, even
682674
if you correctly completed all configuration steps, including the step to enable advanced tier:
@@ -697,4 +689,6 @@ or AWS config file:
697689
698690
```text
699691
region eu-west-1 config-file ~/.aws/config
700-
```
692+
```
693+
694+
* As the final effort, try to re-initialize the instance by restarting the notebook: Kernel -> Restart Kernel and Run All Cells.

0 commit comments

Comments
 (0)