對 MDM Express 安裝及設定進行疑難排解

本主題提供暫行解決方法及指引，以協助您克服在 IBM MDM Express 安裝與設定期間可能會發生的問題。

Mac OS 及 Microsoft Windows Download and Go 應用程式中的已知問題

使用 Download and Go (D&G) 應用程式來安裝「IBM MDM Express 基本訂閱」或「IBM MDM Express 試用」版本時，存在下列已知問題。

如果前一個 Docker 映像檔版本仍存在，則安裝會失敗
在安裝 1.0.0.1 版之前，請確定 1.0 版 Docker 映像檔已解除安裝且無法使用。
若要在 Mac 上解決此問題，請執行下列動作：
  1. 解除安裝 MDM Express 1.0 版 Docker 儲存器、映像檔及 D&G 應用程式。
  2. 刪除 ~/Library/Preferences/ 中的 MDM Express .plist 檔案：
    • com.ibm.mdmdg.plist
    • com.ibm.dgmdm.plist
若要在 Windows 上解決此問題，請執行下列動作：
  1. 解除安裝 MDM Express 1.0 版 Docker 儲存器、映像檔及 D&G 應用程式。
  2. 刪除 MDM Express 相關的資料夾及檔案：
    • <user-home>/AppData/Local/ibmbigmatch
    • <user-home>/AppData/Roaming/IBM MDM Express DG
    • <user-home>/AppData/Roaming/comibmmdmdg.log
    • <user-home>/AppData/Roaming/comibmdgmdm.log
授權檢查期間發生延遲
在 D&G 應用程式的後續啟動期間，在授權檢查完成時與顯示下一個畫面之間，會有一點延遲。
沒有可用的網際網路連線時發生錯誤
在 D&G 應用程式的後續啟動期間，如果沒有可用的網際網路連線，則應用程式會顯示非敘述性的錯誤訊息。
取消按鈕行為
「新增使用者」和「配置主機名稱」畫面上的取消按鈕，實際上並不會取消在該階段作業中所做的變更。
只有在儲存器在執行時，才能在安裝後新增使用者
在起始安裝之後，若要能夠將使用者新增至 MDM Express，則 Docker 儲存器必須在執行中。

為了避免此問題發生，請確定在嘗試新增使用者之前已啟動儲存器。

Windows Firewall 可能會封鎖 D&G 應用程式
如果 Windows Firewall 已啟用，則可能會阻止 D&G 應用程式運作。

若要解決此問題，請在防火牆規則中將 D&G 應用程式新增為例外情況。

配置給儲存器的裝置儲存體空間太小

說明
MDM Express requires that the Docker base image size used for Storage Driver 'devicemapper' to be at least 20GB. The current value is <xxx>. Please increase the base image size before attempting to install MDM Express. See the pre-requirements documentation for further details.

如果 Docker 主機使用預設的 devicemapper 裝置驅動程式，則儲存器的預設儲存體大小為 10 GB。MDM Express 需要至少 20 GB 的總儲存體大小。

解決方案
若要解決此問題，請執行下列動作：
  1. 停止 Docker 服務：
    systemctl stop docker
  2. 套用基本裝置大小增加量：
    dockerd --storage-opt dm.basesize=20G
  3. 按 CTRL+C 以結束。
  4. 重新啟動 Docker 服務：
    systemctl start docker
  5. 重新執行 MDM Express 設定應用程式。

MDM Express Docker 映像檔下載失敗

說明
MDM Express Docker image download failed.

MDM Express 設定應用程式無法從儲存庫中下載 Docker 映像檔。

解決方案
請檢查 Docker 主機與儲存庫之間的網路連線功能 (registry.ng.bluemix.net)。

儲存器無法啟動

說明
Container failed to start.

docker run 指令無法啟動 MDM Express Docker 儲存器。

解決方案
請檢查畫面上的 Docker 失敗訊息以取得指引。在某些情況下，舊的 Docker 版本可能無法支援較新的 docker run 參數。

MDM Express 設定不完整

說明
MDM Express Setup is incomplete.

其中一個伺服器處理程序未在 Docker 儲存器內順利啟動。

解決方案
請檢查 System D 日誌訊息：
  1. 取得在設定期間無法啟動的服務名稱。這會是下列其中一項：
    • yarn.service
    • hbase.service
    • mapred.service
    • solr.service
    • spark.service
    • mdmexpress.service
  2. 從 Docker 主機中，執行下列指令，將 <containerID> 及 <service name> 取代為適當的值：
    platform systemd log
docker exec <containerID> bash -l -c "systemctl status -l <service name>"
  3. 在日誌中尋找失敗訊息。

儲存 MDM Docker 映像檔失敗

說明
Save MDM docker image failed.

在離線安裝模式中，設定應用程式無法將 MDM Express Docker 映像檔儲存至本端磁碟。

解決方案
  • 請檢查目錄路徑許可權。該目錄必須是可寫入的，這樣設定應用程式才能儲存 mdm_express_offline_setup.tar.gz。
  • 請檢查磁碟空間，特別是在磁碟空間用量接近 100% 時。
  • 如果 docker save 指令無法完成，請檢閱畫面上的失敗訊息。

MDM Express 映像檔載入失敗

說明
MDM Express image load failed.

在離線安裝模式下，無法從本端磁碟中讀取及載入 MDM Express Docker 映像檔。

解決方案
  • 目錄路徑許可權。該目錄必須是可讀取的，這樣設定應用程式才能載入 mdm_express_offline_setup.tar.gz。
  • 驗證已順利複製 mdm_express_offline_setup.tar.gz：
    md5sum mdm_express_offline_setup.tar.gz
  • 如果 docker load 指令無法完成，請檢閱畫面上的失敗訊息。

MDM Express 設定應用程式指出 "Installation is incomplete"

說明
not accessible. Installation is incomplete
如果無法使用主機名稱來存取主機，或已錯誤配置主機名稱，則無法使用主機名稱來存取 MDM Express 設定應用程式，而且安裝程式將顯示下列錯誤：
curl: (35) TCP connection reset by peer
https://<hostname>:9443/insight not accessible. Installation is incomplete

如果未適當地配置完整網域名稱 (FQDN)，則會發生此問題。

當 MDM Express 設定應用程式嘗試驗證它預期找到 MDM Express 儲存器的完整 URL 時，則會在安裝結束時顯示此錯誤。

解決方案
若要解決此問題，請確定已在系統及 /etc/hosts 檔案中適當地設定 FQDN 主機名稱。

如需 FQDN 需求及其他必要條件的相關資訊，請參閱 MDM Express（無限制版本）必要條件。

使用者管理：每位使用者只能有一個角色

說明
MDM Express 不支援同時具有管理者（資料管理者）與商業使用者角色的單一使用者。
解決方案
為每個角色建立不同的使用者。

使用者管理：確保在部署至正式作業之前已先刪除預設使用者

說明
MDM Express 包括在安裝時自動設定的兩個預先配置的使用者。
  • Admin - Demo 使用者是具有管理者角色的預設使用者。 此使用者的密碼為 Demo。
  • Test - test 使用者是具有商業使用者角色的預設使用者。 此使用者的密碼為 test。
基於安全考量，在將 MDM Express 使用者介面部署到正式作業環境之前，必須先刪除這些使用者。

Docker 未安裝

說明
在執行設定應用程式之前，IBM MDM Express 需要安裝 Docker CE 或 EE。
解決方案
安裝 Docker CE 或 EE，並確保在要安裝 MDM Express 的主機上啟動 Docker。

無法刪除 Docker 儲存器

說明
IBM MDM Express 設定應用程式找到現有的儲存器，但無法予以刪除。
解決方案
  1. 請檢查儲存器狀態。
  2. 執行下列 Docker 指令，以手動移除儲存器：
    docker rm -f <container name>

前次更新： 2018 年 11 月