1 Introduction
This tutorial will guide you through setting up your environment to run Jupyter Lab on Oracle Cloud Infrastructure.
2 Prerequisites
You’ll need a Virtual Machine 2.1 with Oracle Linux 7.9 (OEL7) deployed in Oracle Cloud Infrastructure (OCI).
- Oracle Linux 7.9 using pip3.6 by default.
- Python 3.6 or higher installed
- Access to root, either directly or via sudo. By default in OCI, you are connected as the “opc” user with sudo privilege.
The install is pretty simple. It consists of setting up python and installing python components and libraries.
Lets start with setting up the Python Environment
3 Python Setup
By default, OEL7 runs Python 3. The first step is to install pip
and virtualenv
.
-
Install
virtualenv
Virtualenv enables us to create isolated sandboxes for developing Python applications without running into module or library conflicts. It’s very simple to install:
sudo pip3.6 install virtualenv
-
Next we can create a virtual environment called “myvirtualenv”
virtualenv -p /usr/bin/python3 myvirtualenv # Activate the env source myvirtualenv/bin/activate
-
Check list of Python Libraries in your environment
Running the following command will show what Python models we have installed at this point.
(myvirtualenv)$ pip3 list Package Version ---------- ------- pip 21.1.3 setuptools 57.1.0 wheel 0.36.2 WARNING: You are using pip version 21.1.3; however, version 21.2.1 is available. You should consider upgrading via the '/home/opc/myvirtualenv/bin/python -m pip install --upgrade pip' command.
-
Upgrade your PIP Environment for this virtual environment:
/home/opc/myvirtualenv/bin/python -m pip install --upgrade pip
4 Jupyter Lab Setup
-
Use
pip
to install Jupyter Lab:pip3 install jupyterlab
-
Install Python Libraries for Machine Learning or ETL Process:
pip install pandas pip install pandarallel pip install dask pip install seaborn pip install matplotlib pip install plotly pip install -lxml==4.6.3 pip install selenium pip install beautifulsoup4 pip install scikit-learn
-
Install other Python libraries for Kafka Access and WEB Server Access:
pip install kafka-python (v2.0.0) pip install Flask pip install gunicorn
-
Install extensions for Jupyter Lab environment:
pip install jupyter_contrib_nbextensions jupyter contrib nbextension install --user jupyter nbextension enable execute_time/ExecuteTime
5 Configure Jupyter Lab like an OEL7 Linux Service
-
Create a script to instantiate automatically and reboot jupyterlab with the
opc
user.vi /home/opc/launchjupyterlab.sh
-
Add the contents below to
launchjupyterlab.sh
. You must use thevirtualenv
you created, and you can launch Jupyter Lab on a specific port (for example: 8001) and listen on your VM’s public IP.#!/bin/bash # Activate myvirtualenv Environment source myvirtualenv/bin/activate cd /home/opc if [ "$1" = "start" ]; then nohup jupyter-lab --ip=0.0.0.0 --port=8001 > ./nohup.log 2>&1 & echo $! > /home/opc/jupyter.pid else kill $(cat /home/opc/jupyter.pid) fi
-
Make the script executable so it can be run from the jupyterlab service:
chmod 777 /home/opc/launchjupyterlab.sh
-
Connect to “root” user:
sudo -i
-
Create a script to start and stop the “jupyterlab” service:
vi /etc/systemd/system/jupyterlab.service
-
Add the following to
jupyterlab.service
:[Unit] Description=Service to start jupyterlab for opc Documentation= [Service] User=opc Group=opc Type=forking WorkingDirectory=/home/opc ExecStart=/home/opc/launchjupyterlab.sh start ExecStop=/home/opc/launchjupyterlab.sh stop [Install] WantedBy=multi-user.target
-
Test the Jupyter Lab Service
systemctl start jupyterlab systemctl status jupyterlab systemctl enable jupyterlab
6 Reboot your VM
-
Reboot your machine to check if
jupyterlab
script is enabled by default on port we defined (8001). -
Open port 8001 to your virtual machine VM 2.1 so you can access Jupyter Lab using your Public IP.
firewall-cmd --permanent --zone=public --list-ports firewall-cmd --get-active-zones firewall-cmd --permanent --zone=public --add-port=8001/tcp firewall-cmd --reload
-
If you’re running directly on a virtual machine and have a browser installed, it should take you directly into the Jupyter environment. Connect to
http://xxx.xxx.xxx.xxx:8001/
(replacingxxx
with your public IP).
You should now see the Python Web environment “Jupyter Lab”.