# GIPSensePortable Linux 版安裝說明

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

## 安裝 PostgreSQL 13 資料庫
- 更新 apt 套件資料庫

  sudo apt update && sudo apt upgrade

- 安裝 PostgreSQL 13

  sudo apt-get install postgresql-13

- 安裝 PostGIS

  sudo apt-get install postgresql-13-postgis-3

- 以 psql 修改帳號 postgres 之密碼

  #note: 請自行將指令中 ${postgres帳號的密碼} 取代為欲設定之密碼
  sudo -u postgres psql -c "alter user postgres with password '${postgres帳號的密碼}'"

## 安裝與啟動 uwb-rtls 與 uwb-engine 服務
- 將 GIPSensePortable_xxx.tar.gz 複製至欲安裝之路徑下，一般建議放在使用者 home 路徑下，並額外新增名為 uwb 的資料夾，即完整路徑為 ~/uwb

  #切換至目前帳號的 home 路徑
  cd ~
  #新增 uwb 資料夾
  mkdir uwb
  #切換至 ~/uwb 路徑下
  cd uwb
  #note: 可在此時將 GIPSensePortable_xxx.tar.gz 複製到目前路徑下，即 ~/uwb (可用 ls 指令確認檔案已存在)

- 解壓縮 GIPSensePortable_xxx.tar.gz 至目前路徑

  #note: 請記得將指令中的 GIPSensePortable_xxx.tar.gz 以實際檔名置換
  tar -C . -zxvf GIPSensePortable_xxx.tar.gz 

- 切換至解壓縮後的 GIPSensePortable_xxx 路徑下

  #note: 請記得將指令中的 GIPSensePortable_xxx 以實際路徑名稱置換 (可用 ls 指令確認路徑名稱)
  cd GIPSensePortable_xxx

- 安裝 uwb-rtls 服務並啟動

  #安裝 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 服務並啟動

  #安裝 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