1. 簡介

EII全稱Open Edge Insights for Industrial，開源工業邊緣洞見平臺。該平臺由Intel公司研發并開源，開源倉庫位于Github(https://github.com/open-edge-insights)。EII通常部署在工業邊緣節點，用于視頻數據/時序數據的采集，分析和可視化。EII采用Docker容器化的部署方式，具有很好的靈活性和可擴展性。EII采用源碼發布的方式，用戶可以下載EII源代碼進行二次開發。

EII的架構圖如下，主要包含了機器視覺和時序數據相關的兩類功能模塊，各個模塊可以通過EII消息總線(EII Message Bus)進行通訊。

EII目前有2種下載安裝方式。1) 通過Github下載EII源碼，2) 通過EII官方網站下載EII源碼包。

• EII官方網站：https://intel.com/edge-insights-industrial
• EII官方Github倉庫：https://github.com/open-edge-insights
• EII官方Docker Hub倉庫：https://hub.docker.com/u/openedgeinsights
• EII開發手冊：https://open-edge-insights.github.io/

對于開發者而言，筆者更推薦使用Github下載EII源碼進行安裝，這樣在二次開發過程中，方便用Git工具管理源碼。所以本文將介紹在Ubuntu 20.04系統上通過Github安裝EII 3.0的方法。

2. 預先步驟

• 在設備上安裝Ubuntu 20.04 LTS。

• 將設備連接互聯網。本文假設用戶是在國內網絡(PRC網絡)環境下進行安裝，國內網絡訪問國外資源時，經常會遇到訪問失敗的問題，導致安裝EII失敗。所以本文會介紹一些"換源"的操作來幫助國內用戶解決安裝失敗的問題。若用戶有網絡代理(proxy)等服務能夠直接訪問國外資源，則本文很多"換源"操作可以跳過。

• (For PRC網絡) 將apt源設置為國內源(如阿里源)，可加速apt依賴包的下載。

  • 設置方法：點擊Ubuntu桌面左下角"九個點" -> 打開"Software & Updates"應用程序 -> 在"Ubuntu Software"標簽欄下的"Download from"選項，選擇"Other…" : “China” : “mirrors.aliyun.com” -> 點擊"Choose Server" -> 點擊"Close" -> 在彈出的對話框中點擊"Close" -> 等待"Cache Refresh"結束(若Cache Refresh失敗可忽略)。

  • 打開命令行，執行如下命令更新apt源。

  $ sudo apt update

• (For PRC網絡) 將pip源設置為國內源(如清華源)，可加速python依賴包的下載。

  • 新建"pip.conf"文件
  $ mkdir -p ~/.pip $ gedit ~/.pip/pip.conf
  • 在"pip.conf"文件中添加如下內容：
  [global]index-url=https://pypi.tuna.tsinghua.edu.cn/simple/ [install]trusted-host=pypi.tuna.tsinghua.edu.cn
  • 更新pip工具。
  $ sudo apt install python3-pip $ pip3 install --upgrade pip

3. 開始安裝

3.1 安裝依賴工具

• 安裝預備工具。

$ sudo apt update && sudo apt install -y curl git

• 配置git參數。

# Set email and name $ git config --global user.email [Your Email] $ git config --global user.name [Your Name]# Disable CA verify $ git config --global http.sslverify false# Remember username and password $ git config --global credential.helper store

• 配置python軟鏈接(后續使用的"repo"工具需要這項配置)。

$ sudo ln -s /usr/bin/python3 /usr/bin/python

• 安裝repo工具。

$ curl https://storage.googleapis.com/git-repo-downloads/repo > repo $ sudo mv repo /bin/repo $ sudo chmod a+x /bin/repo

• 執行如下命令，若成功打印repo的版本信息，則說明repo安裝成功。

$ repo --version

• (For PRC網絡) 設置repo url，國內網絡可能無法訪問repo某些位于國外的源，可通過如下命令，將repo url修改為國內的源。

$ export REPO_URL="https://gerrit-googlesource.lug.ustc.edu.cn/git-repo"

3.2 拉取EII源碼

• 新建一個工作目錄(例如"~/eii")，并進入。

$ mkdir -p ~/eii && cd ~/eii

• 拉取EII倉庫清單(以v3.0版本為例)。清單文件保存在目錄".repo/manifests"下。

$ repo init -u "https://github.com/open-edge-insights/eii-manifests.git" -b refs/tags/v3.0

若需要拉取EII其他版本，修改"-b"參考后的tag標簽即可。

• (For PRC網絡) 修改".repo/manifests/default.xml"文件，將Github地址修改為Gitee。repo工具在國內網絡環境下拉取Github代碼時會超時，故將代碼庫從Github修改為Gitee (EII在Gitee有一個與Github保持同步的鏡像倉庫)。

  用編輯器(如gedit)打開".repo/manifests/default.xml"文件

  $ gedit .repo/manifests/default.xml

  參考如下內容進行修改：

  # 將"default.xml"的第3，4行 <remote name="origin" fetch="https://github.com/open-edge-insights" /> <remote name="github-origin" fetch="https://github.com/intel" /># 修改為如下內容 <remote name="origin" fetch="https://gitee.com/open-edge-insights" /> <remote name="github-origin" fetch="https://gitee.com/mirrors_intel" />

• 拉取EII源碼。

$ repo sync

• 拉取成功后，EII源碼即保存在目錄"~/eii/IEdgeInsights中。

3.3 安裝EII運行環境

• 安裝docker和docker-compose

通過如下命令，安裝和設置docker，docker-compose

# 創建一個目錄用來存放安裝包，并進入 $ mkdir -p ~/eii/installer && cd ~/eii/installer# 下載安裝包 (從docker官網下載安裝包速度較慢，故選擇從gitee上下載) $ wget https://gitee.com/open-edge-insights/eii-install-guide/attach_files/873577/download/docker-ce_20.10.9_3-0_ubuntu-focal_amd64.deb $ wget https://gitee.com/open-edge-insights/eii-install-guide/attach_files/873579/download/docker-ce-cli_20.10.9_3-0_ubuntu-focal_amd64.deb $ wget https://gitee.com/open-edge-insights/eii-install-guide/attach_files/873578/download/containerd.io_1.4.11-1_amd64.deb $ wget https://gitee.com/open-edge-insights/eii-install-guide/attach_files/873576/download/docker-compose-Linux-x86_64-v1.29.0# 安裝docker $ sudo dpkg -i docker-ce_*.deb docker-ce-cli_*.deb containerd.io_*.deb# 安裝docker-compose $ sudo cp docker-compose-Linux-x86_64-v1.29.0 /usr/local/bin/docker-compose $ sudo chmod +x /usr/local/bin/docker-compose $ sudo ln -sf /usr/local/bin/docker-compose /usr/bin/docker-compose# 將當前用戶添加到"docker"用戶組，使得當前用戶不加"sudo"也可以使用docker命令 $ sudo groupadd docker $ sudo usermod -aG docker $USER $ newgrp docker

• 安裝EII依賴環境，安裝腳本位于"IEdgeInsights/build/pre_requisites.sh"。

  • (For PRC網絡) 如果是國內網絡環境下安裝，需要對"pre_requisites.sh"腳本做一些修改：該腳本會通過嘗試連接google官方來測試網絡是否暢通，這個步驟在國內網絡環境會失敗，導致腳本退出，估將google修改為baidu。

  用編輯器(如gedit)打開"IEdgeInsights/build/pre_requisites.sh"文件

  $ cd ~/eii/IEdgeInsights/build $ gedit pre_requisites.sh

  參考如下內容進行修改：

  # 將"pre_requisites.sh"的第161行 wget http://www.google.com > /dev/null 2>&1 # 修改為如下內容 wget http://www.baidu.com > /dev/null 2>&1# 將"pre_requisites.sh"的第196行 pip3 install -r requirements.txt # 修改為如下內容 pip3 install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/
  • 執行腳本，安裝EII所需依賴環境。
  $ sudo ./pre_requisites.sh

• 修改EII配置文件"IEdgeInsights/build/.env".

$ gedit .env

參考如下內容進行修改：

# 第36行, 開發階段建議將dev_mode設置為true DEV_MODE=true# 第106-110行, 設置相關服務模塊的用戶名和密碼 (具體的用戶名和密碼用戶可自行調整) # Service credentials # These are required to be updated in both DEV mode & PROD mode ETCDROOT_PASSWORD=admin123 INFLUXDB_USERNAME=admin INFLUXDB_PASSWORD=admin123 MINIO_ACCESS_KEY=admin@123 MINIO_SECRET_KEY=admin@123

• 重啟機器使得docker相關的配置生效。

$ sudo reboot

3.4 運行PCBA缺陷檢測案例

• 查看“video-streaming.yml”文件，檢查PCBA案例中包含哪些服務模塊。

$ cd ~/eii/IEdgeInsights/build $ cat usecases/video-streaming.yml

• 執行編譯腳本。該腳本會在當前目錄生成一系列配置文件，如docker-compose.yml等(docker-compose.yml用于后續啟動PCBA案例，其中包含了該案例包含的服務模塊信息)。

$ sudo -E python3 builder.py -f usecases/video-streaming.yml

• 通過如下命令，從docker hub倉庫拉取PCBA案例所需的docker鏡像。(用戶也可以通過EII提供命令自行build所需的docker鏡像，不過耗時較久，故這里選擇從docker hub倉庫直接下載)

#/bin/bashpre_name=openedgeinsights tag=3.0 image_name=( ia_configmgr_agent ia_etcd_ui ia_video_ingestion ia_video_analytics ia_visualizer ia_web_visualizer ia_grafana )for i_name in ${image_name[@]}; dodocker pull $pre_name/$i_name:$tag done

創建一個腳本"pull_vision_image.sh"，拷貝如上命令行，然后修改權限并執行，拉取EII docker鏡像。

$ mkdir -p ~/eii/script && cd ~/eii/script $ gedit pull_vision_image.sh# 拷貝上述命令行，保存并退出$ chmod a+x pull_vision_image.sh $ ./pull_vision_image.sh

• 打開圖形界面訪問權限

$ xhost +

• 啟動EII服務。

$ cd ~/eii/IEdgeInsights/build $ ./eii_start.sh

• 啟動成功后，可通過"docker ps"命令查看容器運行情況。

$ docker ps

• 若啟動成功，PCBA檢測案例運行窗口會自動彈出，如圖所示。
  

• 通過如下命令，可關閉EII服務。

$ docker-compose down

3.5 運行溫度監控案例

• 查看“time-series.yml”文件，檢查溫度監控案例中包含哪些服務模塊。

$ cd ~/eii/IEdgeInsights/build $ cat usecases/time-series.yml

• 執行編譯腳本。該腳本會在當前目錄生成一系列配置文件，如docker-compose.yml等(docker-compose.yml用于后續啟動溫度監控案例，其中包含了該案例需要的服務模塊信息)。

$ sudo -E python3 builder.py -f usecases/time-series.yml

• 通過如下命令，從docker hub倉庫拉取PCBA案例所需的docker鏡像。

#/bin/bashpre_name=openedgeinsights tag=3.0 image_name=( ia_configmgr_agent ia_etcd_ui ia_telegraf ia_influxdbconnector ia_kapacitor ia_grafana ia_opcua_export ia_rest_export )for i_name in ${image_name[@]}; dodocker pull $pre_name/$i_name:$tag done

創建一個腳本"pull_ts_image.sh"，拷貝如上命令行，然后修改權限并執行。

$ mkdir -p ~/eii/script && cd ~/eii/script $ gedit pull_ts_image.sh# 拷貝上述命令行，保存并退出$ chmod a+x pull_ts_image.sh $ ./pull_ts_image.sh

• 修改ia_mqtt_publisher的Dockerfile文件，方便在國內網絡環境下編譯。

$ gedit ~/eii/IEdgeInsights/tools/mqtt/publisher/Dockerfile

參考如下信息進行修改：

# 將"Dockerfile"的第30行 RUN pip3 install -r requirements.txt # 修改為如下內容 RUN pip3 install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/

• 編譯ia_mqtt_publisher鏡像。(由于docker hub倉庫不包含ia_mqtt_publisher的docker鏡像，故此處需要手動編譯)

$ cd ~/eii/IEdgeInsights/build $ docker-compose -f docker-compose-build.yml build ia_mqtt_publisher

• 啟動EII服務。

$ ./eii_start.sh

• 啟動成功后，可通過"docker ps"命令查看容器運行情況。

$ docker ps

• 若啟動成功，打開瀏覽器，輸入網址：localhost:3000，進入Grafana界面。(默認登錄賬號：admin, 密碼：admin)
  

• 進入Grafana主界面后，打開"EII Video and Time Series Dashboard"。
  

• 若看到如下溫度信息，即說明啟動成功。
  

• 關閉EII服務。

$ docker-compose down

后記
以上就是EII 3.0版本的完整安裝過程，大家參照以上安裝步驟若遇到問題，可留言。
筆者會在后續文章中，詳細分析EII的架構設計和各個模塊的運行原理，敬請關注。

總結

以上是生活随笔為你收集整理的(1)英特尔工业边缘洞见平台(EII)安装指南的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。