Skip to content

Commit

Permalink
Added the troubleshooting.md
Browse files Browse the repository at this point in the history
  • Loading branch information
ahsimb committed Apr 10, 2024
1 parent 8fa9dee commit 8485c6a
Show file tree
Hide file tree
Showing 3 changed files with 20 additions and 1 deletion.
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,3 +18,4 @@ After downloading the required files and having started the AI-Lab you can conne
## Additional Links

* [Developer Guide](https://github.com/exasol/ai-lab/blob/2.0.0/doc/developer_guide/developer_guide.md)
* [Troubleshooting](doc/user_guide/troubleshooting.md)
2 changes: 1 addition & 1 deletion doc/changes/changes_2.1.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ n/a

## Documentation

n/a
* #249: Mitigate or document died kernel for transformers/te_init.ipynb. Started the troubleshooting section in the user guide.

## Refactoring

Expand Down
18 changes: 18 additions & 0 deletions doc/user_guide/troubleshooting.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
# Troubleshooting

## Kernel died when initializing the Transformers Extension

### Problem

Running the Transformers Extension Initialization in the transformers/te_init.ipynb notebook results
in a popped up error message similar to this: "Kernel Restarting. The kernel for transformers/te_init.ipynb
appears to have died. It will restart automatically."

### Cause

The issue is caused by an insufficient memory, either RAM or the free disk space. This, for example,
can be observed when running the AI-Lab from certain restricted EC2 instances, e.g.T2.medium.

### Solution

Make sure the available resources satisfy the minimum [system requirements](system-requirements.md).

0 comments on commit 8485c6a

Please sign in to comment.