| Table of Contents |
|---|
When you upload a large CSV file to IDAS, there is a chance that the upload will crash your workspace. Even after closing out of IDAS and opening it back up, the browser may still be unresponsive.
It will often look as follows...
...
Overview
A JupyterLab workspace contains the state of JupyterLab, including files that are currently open and tab layout. JupyterLab allows using URLs to manage workspaces. For more information about JupyterLab URLs, please see the official JupyterLab documentation.
This article demonstrates how to use URLs to reset a JupyterLab workspace in IDAS. This is helpful if, for example, you open a CSV file in IDAS, and the file doesn’t load completely. Your JupyterLab workspace might become unresponsive and look as follows.
...
After a few minutes, the page might crash:
...
The steps below will demonstrate how to resolve this issue.
Steps to Reset a JupyterLab Workspace
1. Login Log in to IDAS Log onto IDAS at https://notebooks.hpc.uiowa.edu/ and select either research . Select either “Interactive Research” or your class depending on which you usually use to logininstance.
2. Change the URL:
In order to save your current workspace. You'll need to change from the JupyterHub instance to the JupyterLab instance.
a. For research users:
- you'll change: https://notebooks.hpc.uiowa.edu/research-interactive/user/YOUR-HAWKID/tree
- to: https://notebooks.hpc.uiowa.edu/research-interactive/user/YOUR-HAWKID/lab
b. For class users:
you'll change: https://notebooks.hpc.uiowa.edu/YOUR-CLASS-NUMBER/user/YOUR-HAWKID/rstudio/tree
to: https://notebooks.hpc.uiowa.edu/YOUR-CLASS-NUMBER/user/YOUR-HAWKID/rstudio/lab
In general...
Go to the top of the screen to the URL that currently looks like: https://notebooks.hpc.uiowa.edu/research-interactive/user/HAWKID/lab
Then change "lab" to "tree" as follows...
This will take you out of your JupyterLab and into your JupyterHub which holds the same workspaces, just in different instances.
3. You'll need to save your open files. Start by going to the "Running" tab.
4. Once under the running tab, open a notebook If you have made changes to a Jupyter Notebook document and need to save your changes, follow the steps below. If you do not need to save changes to any notebook, skip to step 3.
2a. Open Jupyter Hub in IDAS
The default URL for JupyterLab ends with “lab”, as shown in the screenshot below.
...
In the URL, change “lab” to “tree” and press “Enter”. The page will refresh and open Jupyter Hub:
...
2b. In Jupyter Hub, you can manage your notebooks as needed.
To view a list of notebooks that are currently running, click the "Running" tab:
...
2c. Under “Notebooks”, click on the name of the notebook that you'd like to save.
...
52d. Click on the "Save and Checkpoint" icon to save any changes to the notebook.
6. Creating a clone workspace and deleting the crashed one:
...
| Warning |
|---|
Make sure you did steps 3 through 5 This will override the old workspace. |
...
Repeat as needed for any other running notebooks that you want to save.
| Warning |
|---|
The following step will close all open files in your JupyterLab workspace. If you need to save changes to your Jupyter Notebook documents, please follow steps 2a to 2d above. |
3. Return to the Jupyter Hub page. At this point, the URL will end with “tree#running”:
...
Edit the URL to replace “tree#running” with “lab?clone=foo” and press Enter. This will clone a non-existent workspace (called foo) into your default JupyterLab workspace, so that you can start JupyterLab with a blank slate.
Contact
If you have any questions or comments, please contact research-computing@uiowa.edu.