Skip to content

Deploy

Jump to bottom
Carlos Downie edited this page Jan 22, 2020 · 43 revisions

There are many ways to deploy VCDAT on your system

From Source

To install VCDAT 2.0 on your own computer or a local network, clone the jupyter-vcdat github repo:

git clone https://github.com/CDAT/jupyter-vcdat.git

Change into the directory containing the repo and type in the following commands:

./install_script.sh

For more info see our README file.

Launch VCDAT 2.0 on your computer

If you haven't already, activate the jupyter-vcdat environment since it includes the code to run JupyterLab and your base environment likely does not have it installed.

conda activate jupyter-vcdat

If this command fails, try:

source activate jupyter-vcdat

Navigate to a parent folder that contains data you want to examine or notebooks you want to run, then type:

jupyter-lab

This should launch a web page which displays the JupyterLab interface. If this does not occur, look at the message that is displayed, copy the URL in the message and paste it into your browser.

Note: you must launch JupyterLab from the highest level folder you want to be able to access. Jupyter can see folders below the directory from which it was launched, but it cannot see directories above its launch directory.

Using Docker

First install docker on your system.

Here we choose port 9000 just in case you already have a local one running at the default 8888 Then run:

docker run -p 9000:9000 -it  cdat/vcdat:latest jupyter-lab --port=9000

Look in the output for the token value, for example:

Serving notebooks from local directory: /home/jovyan
0 active kernels
The Jupyter Notebook is running at:
http://(55161a793285 or 127.0.0.1):9000/?token=20bbbe820ddf95d0e269cbec61e131ead96e3ea3020db8c2

Point your browser to:

http://localhost:9000/?token=INSERT_YOUR_TOKEN_VALUE_HERE

for example:

http://localhost:9000/?token=20bbbe820ddf95d0e269cbec61e131ead96e3ea3020db8c2

Make sure to match the token value.

NOTE: Google Chrome is the preferred browser.

To access your local files simply mount them in the docker command line:

docker run -p 9000:9000 -v $PWD:/home/jovyan/my_data -it  cdat/vcdat:latest jupyter-lab

This will mount your current directory into ~/my_data in the container.

Clone this wiki locally