---
# System prepended metadata

title: GIPSensePortable Linux 版安裝說明

---

# GIPSensePortable Linux 版安裝說明

## 系統需求與限制
  - 適用於 Debian、Ubuntu、CentOS 等作業系統
  - 執行安裝時需有網際網路連線
  - 操作時若非 root 帳號或群組則需要有 sudo 權限，需請作業系統管理人員提供。若為 root 則在指令前不需輸入 ```sudo```。

## 安裝 PostgreSQL 13 資料庫
- 更新 apt 套件資料庫
  ```bash
  sudo apt update && sudo apt upgrade
  ```
- 安裝 PostgreSQL 13
  ```bash
  sudo apt-get install postgresql-13
  ```
- 安裝 PostGIS
  ```bash
  sudo apt-get install postgresql-13-postgis-3
  ```
- 以 psql 修改帳號 postgres 之密碼
  ```bash
  #note: 請自行將指令中 ${postgres帳號的密碼} 取代為欲設定之密碼
  sudo -u postgres psql -c "alter user postgres with password '${postgres帳號的密碼}'"
  ```

## 安裝與啟動 uwb-rtls 與 uwb-engine 服務
- 將 GIPSensePortable_xxx.tar.gz 複製至欲安裝之路徑下，一般建議放在使用者 home 路徑下，並額外新增名為 uwb 的資料夾，即完整路徑為 ~/uwb
  ```bash
  #切換至目前帳號的 home 路徑
  cd ~
  #新增 uwb 資料夾
  mkdir uwb
  #切換至 ~/uwb 路徑下
  cd uwb
  #note: 可在此時將 GIPSensePortable_xxx.tar.gz 複製到目前路徑下，即 ~/uwb (可用 ls 指令確認檔案已存在)
  ```
- 解壓縮 GIPSensePortable_xxx.tar.gz 至目前路徑 
  ```bash
  #note: 請記得將指令中的 GIPSensePortable_xxx.tar.gz 以實際檔名置換
  tar -C . -zxvf GIPSensePortable_xxx.tar.gz 
  ```
- 切換至解壓縮後的 GIPSensePortable_xxx 路徑下
  ```bash
  #note: 請記得將指令中的 GIPSensePortable_xxx 以實際路徑名稱置換 (可用 ls 指令確認路徑名稱)
  cd GIPSensePortable_xxx
  ```
- 安裝 uwb-rtls 服務並啟動
  ```bash
  #安裝 uwb-rtls 服務
  sudo ./tomcats/uwb-rtls-standalone/bin/service.sh install 
  #啟動 uwb-rtls 服務 
  sudo ./tomcats/uwb-rtls-standalone/bin/service.sh start
  #可用以下指令測試 uwb-rtls，若顯示 OK 表示可連線且網頁回應正常
  wget -q http://127.0.0.1:8686/rtls -O /dev/null && echo OK || echo Failed
  #亦可使用以下指令確認網頁是否正常
  wget --spider http://127.0.0.1:8686/rtls
  ```
- 安裝 uwb-engine 服務並啟動
  ```bash
  #安裝 uwb-engine 服務
  sudo ./tomcats/uwb-engine-standalone/bin/service.sh install 
  #啟動 uwb-engine 服務 
  sudo ./tomcats/uwb-engine-standalone/bin/service.sh start
  #可用以下指令測試 uwb-engine，若顯示 OK 表示可連線且網頁回應正常
  wget -q http://127.0.0.1:8080/uwb-engine -O /dev/null && echo OK || echo Failed
  #亦可使用以下指令確認網頁是否正常
  wget --spider http://127.0.0.1:8080/uwb-engine
  ```