# 2021 JupyterLab 橋接服務
###### tags: `人體微生物相資料平台教學`
https://port.biobank.org.tw/
## :memo: Where do I start?
## Step 1 登入HPC
您可以直接用您熟悉的ssh client **(方法一)** 軟體登入以下登入節點,或利用下方網頁介面的webssh **(方法二)** 登入, 登入後請跳到 Step 2 繼續操作
:rocket: 登入節點: t3-c2.nchc.org.tw
### 先取得MOTP KEY 鑰使
網址: https://iservice.nchc.org.tw/
OTP桌面軟體下載: https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai
### 方法一 利用ssh client登入
```
ssh c00cjz00@t3-c2.nchc.org.tw
```
### 方法二 利用webssh登入 (:dart:操作部分)
WebSSH 為網頁介面之SSH Client, 經由此介面, 可輕易完成一行指令安裝JupyterLab的程序, 請填入下列內容再送出
:rocket: 啟動webssh網址: https://port.biobank.org.tw:9000/
:A:**01** 請選擇登入節點 t3-c2.nchc.org.tw
:A:**02** 輸入HPC帳號
:A:**03** 輸入密碼
:A:**04** 輸入MOTP

## Step 2 安裝 jupyterLab 指令
完成Step1 登入終端機後, 請執行下方安裝jupyterlab指令
### 安裝指令
:A:**01** 登入後執行下方指令列
**你可輸入下方指令, 選擇只安裝基本jupyterlab**
```
export PATH=/work/c00cjz002/jupyter:$PATH
jpy_install.sh
```
**依照指示步驟輸入**
:A:**02** 請按 Y 同意安裝
:A:**03** PORT NUMBER 在10,000-60,000之間選一個
:A:**04** PASSWORD 即可完成安裝

:rocket: **完成後畫面如下**

## 連線失敗重啟
若jupyterlab 啟動失敗或關閉, 請重新入您的HPC主機, 輸入以下指令
```
/work/c00cjz002/jupyter/jpy_restart_jupyterLab.sh
```
## Step 3 啟動 ssh tunnel 連線作業
完成step2安裝jupyterlab後, 請打開 https://port.biobank.org.tw/automatic.php
進行橋接服務 (最上方有介紹何謂橋接服務)
### :A:**01** 帳號登入
1. 請輸入您的HPC帳號
2. 密碼或MOTP二擇一輸入即可

### :A:**02** 啟動連接阜服務
1. 請選擇您剛剛建立jupyterlab的那一台登入節點
2. 請輸入您剛剛在安裝jupyterlab所啟動的port, 如12345

### :A:**03** 啟動成功,點選連接阜
1. 完成連線後, 左側會出現藍色按鈕, 點選連線到jupyterlab
2. 若要刪除此連線, 請點選下方紅色Destroy activated tunnel按鈕

### :A:**04** 輸入jupyterLab密碼
1. 輸入您安裝jupyterlab所自行設定的一組密碼

### :A:**05** 啟動 jupyterLab
1. jupyterlab如何操作, 請上google查詢
