Skip to content

Latest commit

 

History

History
84 lines (60 loc) · 2.5 KB

howto-setup-jupyterlab-on-rivanna.md

File metadata and controls

84 lines (60 loc) · 2.5 KB

Howto setup Jupyter Lab for ESCAPE development on Rivanna

Setup ray-hpc-workflows

Please follow the instructions to setup ray-hpc-workflows on Rivanna. As part of the process you will install Jupyter Lab for which we can install extensions.

Install ESCAPE and Jupyter Lab extensions

If you already have a jupyter lab session running (check using squeue command) you need to first stop it (using scancel). Please ensure that you do not have a jupyter lab session running before proceeding.

We will install jupyterlab_esl (for ESL file type support), escape_abm (for ESL language server), and jupyterlab-lsp (for allowing Jupyter Lab to use the language server).

Ensure you are logged into Rivanna via ssh. Also ensure that myenv is still activated.

pip install jupyterlab_esl escape_abm jupyterlab-lsp

Configure jupyterlab-lsp

Note the location of the ESCAPE command line frontend

which esc
/path/to/envs/escape/bin/esc

Create jupyterlab-lsp config file for ESL. Ensure config directory exits.

mkdir -p $HOME/.jupyter/jupyter_server_config.d

Create $HOME/.jupyter/jupyter_server_config.d/esl-ls.json with the following contents

{
    "LanguageServerManager": {
        "language_servers": {
            "escape": {
                "version": 2,
                "argv": [
                    "/path/to/envs/escape/bin/esc",
                    "language-server",
                    "io-server"
                ],
                "languages": [
                    "esl"
                ],
                "mime_types": [
                    "text/esl"
                ]
            }
        }
    }
}

Replace /path/to/envs/escape/bin/esc with the real path of the esc executable.

Jupyter Lab should now be configured for opening ESL files.

Start Jupyter from ray-hpc-workflows

First start Jupyter Lab from ray-hpc-workflows.

Next a socks proxy over ssh is not already running start the socks proxy.

You should now be able to connect to the Jupyter lab on Rivanna