docs(wiki): add zh-TW version for step-by-step-installation-ubuntu

Chinlinlee · Jan 25, 2024 · b02a941 · b02a941
1 parent 82896f8
commit b02a941
Show file tree

Hide file tree

Showing 2 changed files with 266 additions and 0 deletions.
diff --git a/wiki/locale/zh-TW/_Sidebar.md b/wiki/locale/zh-TW/_Sidebar.md
@@ -7,6 +7,7 @@
 - **[🏠 首頁](https://github.com/Chinlinlee/raccoon-dicom/wiki/Home.zh-TW)**
 - **[🔧 安裝手冊](https://github.com/Chinlinlee/raccoon-dicom/wiki/Installation.zh-TW)**
     - **[👨‍💻 從 0 開始部屬 Raccoon - Windows](https://github.com/Chinlinlee/raccoon-dicom/wiki/From-zero-to-deploy.zh-TW)**
+    - **[👨‍💻 從 0 開始部屬 Raccoon - Linux](https://github.com/Chinlinlee/raccoon-dicom/wiki/step-by-step-installation-ubuntu.zh-TW)**
 
 
 ## 開發人員

diff --git a/wiki/locale/zh-TW/step-by-step-installation-ubuntu.zh-TW.md b/wiki/locale/zh-TW/step-by-step-installation-ubuntu.zh-TW.md
@@ -0,0 +1,265 @@
+# Step by Step to installing - Ubuntu
+In the following, we will use `ubuntu 22.04` to install.
+
+## 安裝所需軟體
+以下是 Raccoon-DICOM 列出的需求軟體，接下來會一項一項進行安裝
+- git
+- Node.js
+- Imagemagick
+- openJDK >= 11
+
+## 安裝 git
+```bash
+sudo apt install -y git
+```
+
+## 安裝 Node.js
+```bash
+curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - &&\
+sudo apt-get install -y nodejs
+```
+
+## 安裝 MongoDB
+- 透過 Terminal 安裝 gnupg 和 curl
+```bash
+sudo apt-get install -y gnupg curl
+```
+- 運行以下命令，以從 https://pgp.mongodb.com/server-6.0.asc 導入 MongoDB 的公開 GPG 鑰匙
+```bash
+curl -fsSL https://pgp.mongodb.com/server-6.0.asc | \
+   sudo gpg -o /usr/share/keyrings/mongodb-server-6.0.gpg \
+   --dearmor
+```
+- 為你的 Ubuntu 版本創建列表文件 /etc/apt/sources.list.d/mongodb-org-6.0.list.
+```bash
+echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
+```
+- 重新載入 ubuntu 套件資料庫
+```bash
+sudo apt-get update
+```
+- 運行以下指令安裝 stable 版本的 MongoDB
+```bash
+sudo apt-get install -y mongodb-org
+```
+### Start MongoDB
+- 運行以下指令啟動 mongod
+```bash
+sudo systemctl start mongod
+```
+[當你有問題時，請參閱官方文件](https://www.mongodb.com/docs/v6.0/tutorial/install-mongodb-on-ubuntu/#start-mongodb)
+
+### 創建使用者帳號
+由於 Raccoon-DICOM 內的 MongoDB 連接需要帳號密碼，你必須創建 MongoDB 的帳號密碼以讓 Raccoon-DICOM 正常運作
+- connect to mongodb
+```bash
+mongosh --host localhost --port 27017
+```
+- 輸入以下指令切換到 admin 資料庫
+```bash
+use admin;
+```
+- 輸入以下指令創建 root 帳號
+
+> [!CAUTION]
+> 請自行更改成安全的帳號以及密碼！
+
+```bash
+db.createUser({
+    user : "root",
+    pwd : "root" ,
+    roles : [{role : "root" , db:"admin"}]
+});
+```
+
+> 出現 `{ ok: 1 }` 就代表創建成功囉！
+
+## Install Imagemagick
+```bash
+sudo apt install -y imagemagick
+```
+- 檢查安裝的 ImageMagick 版本
+```bash
+convert --version
+```
+- 應該會產生一個類似於以下的結果：
+```bash
+Version: ImageMagick 6.9.11-60 Q16 x86_64 2021-01-25 https://imagemagick.org
+Copyright: (C) 1999-2021 ImageMagick Studio LLC
+License: https://imagemagick.org/script/license.php
+Features: Cipher DPC Modules OpenMP(4.5) 
+Delegates (built-in): bzlib djvu fftw fontconfig freetype heic jbig jng jp2 jpeg lcms lqr ltdl lzma openexr pangocairo png tiff webp wmf x xml zlib
+```
+
+## Install JAVA JDK
+```bash
+sudo apt install -y openjdk-11-jdk
+```
+- 檢查安裝的 java jdk 版本
+```bash
+java -version
+```
+- 應該會產生一個類似於以下的結果：
+```bash
+openjdk version "11.0.21" 2023-10-17
+OpenJDK Runtime Environment (build 11.0.21+9-post-Ubuntu-0ubuntu122.04)
+OpenJDK 64-Bit Server VM (build 11.0.21+9-post-Ubuntu-0ubuntu122.04, mixed mode, sharing)
+```
+
+## Raccoon-DICOM 安裝
+### 下載 Raccoon
+#### 使用 git
+```bash
+git clone https://github.com/Chinlinlee/raccoon-dicom.git
+```
+
+### 安裝 Node.js 依賴套件
+- 進入 Raccoon-DICOM 資料夾
+```bash
+cd raccoon-dicom
+```
+- 安裝 node 依賴套件
+```bash
+npm install
+```
+### 複製 opencv_java
+```bash
+sudo cp models/DICOM/dcm4che/javaNode/dcm4chee/lib/linux-x86-64/*.so /usr/lib/jvm/java-11-openjdk-amd64/lib
+```
+
+### 設定 .env 檔案
+- 複製 `.env.template` 並命名為 `.env`
+```bash
+cp .env.template .env
+```
+- 更改 .env 檔案
+```text
+# MongoDB
+MONGODB_NAME="raccoon-dicom"
+MONGODB_HOSTS=["127.0.0.1"]
+MONGODB_PORTS=[27017]
+MONGODB_USER="root"
+MONGODB_PASSWORD="root"
+MONGODB_AUTH_SOURCE="admin"
+MONGODB_OPTIONS=""
+MONGODB_IS_SHARDING_MODE=false
+
+# Server
+SERVER_PORT=8081
+SERVER_SESSION_SECRET_KEY="secret-key"
+
+# DICOM Web
+DICOM_STORE_ROOTPATH="/home/test/dicomFiles"
+DICOMWEB_HOST="{host}"
+DICOMWEB_PORT=8081
+DICOMWEB_API="dicom-web"
+
+# DICOM DIMSE
+ENABLE_DIMSE=true
+DIMSE_AE_TITLE="RACCOONQRSCP" # default: RACCOONQRSCP
+DIMSE_HOSTNAME="0.0.0.0" # default: 127.0.0.1
+DIMSE_PORT=11112 # default: 11112
+DIMSE_MAX_PDULEN_RCV=16378
+DIMSE_MAX_PDULEN_SND=16378
+DIMSE_NOT_ASYNC=false
+DIMSE_MAX_OPS_INVOKED=0
+DIMSE_MAX_OPS_PERFORMED=0
+DIMSE_NOT_PACK_PDV=false
+DIMSE_CONNECT_TIMEOUT=0
+DIMSE_REQUEST_TIMEOUT=0
+DIMSE_ACCEPT_TIMEOUT=0
+DIMSE_RELEASE_TIMEOUT=0
+DIMSE_SEND_TIMEOUT=0
+DIMSE_STORE_TIMEOUT=0
+DIMSE_RESPONSE_TIMEOUT=0
+DIMSE_RETRIEVE_TIMEOUT=0
+DIMSE_RETRIEVE_TIMEOUT_TOTAL=0
+DIMSE_IDLE_TIMEOUT=0
+DIMSE_SOCLOSE_DELAY=50
+DIMSE_SOSND_BUFFER=0
+DIMSE_SORCV_BUFFER=0
+DIMSE_TCP_DELAY=false
+
+# DIMSE TLS
+DIMSE_TLS=false
+DIMSE_TLS_NULL=false
+DIMSE_TLS_3DES=false
+DIMSE_TLS_AES=false
+DIMSE_TLS_CIPHER=""
+
+DIMSE_TLS13=false
+DIMSE_TLS12=false
+DIMSE_TLS11=false
+DIMSE_TLS1=false
+DIMSE_SSL3=false
+DIMSE_SSL2HELLO=false
+DIMSE_TLS_PROTOCOL=""
+DIMSE_TLS_EIA_HTTPS=false
+DIMSE_TLS_EIA_LDAPS=false
+DIMSE_TLS_NOAUTH=false
+DIMSE_KEY_STORE="./config/certs/key.p12"
+DIMSE_KEY_STORE_TYPE="PKCS12"
+DIMSE_KEY_STORE_PASS="secret"
+DIMSE_KEY_PASS="secret"
+DIMSE_TRUST_STORE="./config/certs/cacerts.p12"
+DIMSE_TRUST_STORE_TYPE="PKCS12"
+DIMSE_TRUST_STORE_PASS="secret"
+
+# FHIR
+SYCN_TO_FHIR_SERVER=false
+FHIRSERVER_BASE_URL="http://localhost:8088/fhir"
+```
+
+### 啟動 Raccoon-DICOM
+- 啟動 raccoon-dicom
+```bash
+node server.js
+```
+
+## 測試 Raccoon-DICOM 功能
+### Upload DICOM Instance (STOW-RS)
+- 以下將使用來自 `test/dicomFiles/jpeg2000/example-jpeg-2000.dcm` 的檔案做上傳測試
+- 使用 curl 進行上傳
+
+```bash
+curl --location --request POST "http://localhost:8081/dicom-web/studies" \
+--header "Accept: application/dicom+json" \
+--header "Content-Type: multipart/related; type=\"application/dicom\"" \
+--form "file=@example-jpeg-2000.dcm; type=\"application/dicom\""
+```
+
+- 出現以下訊息則代表成功
+
+```json
+{"00081190":{"vr":"UT","Value":["http://localhost:8081/dicom-web/studies/1.3.46.670589.45.1.1.4993912214784.1.5436.1538560373543"]},"00081198":{"vr":"SQ","Value":[]},"00081199":{"vr":"SQ","Value":[{"00081150":{"vr":"UI","Value":["1.2.840.10008.5.1.4.1.1.77.1.6"]},"00081155":{"vr":"UI","Value":["1.3.6.1.4.1.5962.99.1.3002151337.1017604488.1540600476073.6.0"]},"00081190":{"vr":"UT","Value":["http://localhost:8081/dicom-web/studies/1.3.46.670589.45.1.1.4993912214784.1.5436.1538560373543/series/1.3.46.670589.45.1.1.4993912214784.1.5436.1538560606509.3/instances/1.3.6.1.4.1.5962.99.1.3002151337.1017604488.1540600476073.6.0"]}}]}}
+```
+
+### Get Image info (QIDO-RS)
+```bash
+curl http://localhost:8081/dicom-web/studies
+```
+- 應該會出現類似於以下的結果
+```json
+[{"00080020":{"vr":"DA","Value":["20181003"]},"00080030":{"vr":"TM","Value":["095253"]},"00080050":{"vr":"SH","Value":["D18-1001"]},"00080054":{"vr":"AE","Value":["RACCOONQRSCP"]},"00080061":{"vr":"CS","Value":["SM"]},"00080090":{"vr":"PN","Value":[]},"00081190":{"vr":"UR","Value":["http://localhost:8081/dicom-web/studies/1.3.46.670589.45.1.1.4993912214784.1.5436.1538560373543"]},"00100010":{"vr":"PN","Value":[{"Alphabetic":"Philips^Amy"}]},"00100020":{"vr":"LO","Value":["123456"]},"00100030":{"vr":"DA","Value":["20010101"]},"00100040":{"vr":"CS","Value":["O"]},"0020000D":{"vr":"UI","Value":["1.3.46.670589.45.1.1.4993912214784.1.5436.1538560373543"]},"00200010":{"vr":"SH","Value":[]},"00201206":{"vr":"IS","Value":["1"]},"00201208":{"vr":"IS","Value":["1"]}}]
+```
+
+### Retrieve Image (WADO-RS)
+- 調閱 frame
+```bash
+curl http://localhost:8081/dicom-web/studies/1.3.46.670589.45.1.1.4993912214784.1.5436.1538560373543/series/1.3.46.670589.45.1.1.4993912214784.1.5436.1538560606509.3/instances/1.3.6.1.4.1.5962.99.1.3002151337.1017604488.1540600476073.6.0/frames/1/rendered --output image.jpg
+```
+
+> 結果
+>
+> ![frame](https://user-images.githubusercontent.com/49154622/236471229-5ea2fad0-3781-4075-a755-66712d9ef44f.png)
+
+- 你也可以測試 imagemagick 是否正常運作
+```bash
+curl http://localhost:8081/dicom-web/studies/1.3.46.670589.45.1.1.4993912214784.1.5436.1538560373543/series/1.3.46.670589.45.1.1.4993912214784.1.5436.1538560606509.3/instances/1.3.6.1.4.1.5962.99.1.3002151337.1017604488.1540600476073.6.0/frames/1/rendered?iccprofile=rommrgb --output image.jpg
+```
+
+> 結果
+>
+> ![iccprofile-frame](https://user-images.githubusercontent.com/49154622/236471143-9af313c4-e6ca-42c8-a5e7-6a5de66e2005.png)
+
+