Oracle Blockchain Platform 已知問題

瞭解在使用 Oracle Blockchain Platform 時可能會遇到的問題,以及如何解決這些問題。

支援的 Hyperledger Fabric 版本

Oracle Blockchain Platform 24.1.3 支援 Hyperledger Fabric 2.5.7。

支援的瀏覽器

如果主控台的行為無法如預期般運作,請檢查您是否使用支援的最新版本瀏覽器。

Oracle Blockchain Platform 支援下列瀏覽器:

  • Mozilla Firefox
  • Google Chrome
  • Safari
  • Microsoft Edge / Internet Explorer

Hyperledger Fabric 版本的互通性

Oracle Blockchain Platform 不支援在相同區塊鏈網路中使用以 Hyperledger Fabric v1.4.7 為基礎的執行處理,以及在 Hyperledger Fabric v2.x 上使用執行處理。

解決方法:請勿嘗試在相同的區塊鏈網路上執行不同主要版本的 Hyperledger Fabric。

先前版本的不支援功能

舊版的 Oracle Blockchain Platform Enterprise Edition 支援的負載平衡器和硬體安全模組。Oracle Blockchain Platform 24.1.3 不支援這些功能。

執行處理建立僅支援隨附的 OpenLDAP

當您建立 Oracle Blockchain Platform 執行處理時,即使有為不同類型的 LDAP 新增 LDAP 組態的選項,您也必須使用與產品組合的預設 OpenLDAP。

解決方法:將資料從外部 LDAP 系統同步至與 Oracle Blockchain Platform 組合的預設 OpenLDAP,然後繼續建立執行處理。

憑證驗證期間對等尋找失敗

如果您的從屬端應用程式使用 fabric-sdk-go 模組,您的應用程式可能會因為不支援的 fabric-sdk-go 版本,在對等尋找處理作業期間進行憑證驗證而失敗。
若要使用 fabric-sdk-go 模組,請更新至下列版本:
github.com/hyperledger/fabric-sdk-go v1.0.1-0.20240123083657-5d6ca326e01b

未更新節點的日誌顯示

在主控台 UI 中,如果您檢視特定節點的日誌,然後瀏覽至其他窗格,然後返回初始節點的日誌,則不會再次擷取日誌。

解決方法:重新整理瀏覽器頁面以擷取最新的日誌。

不支援自訂根 CA 憑證

Hyperledger Fabric CA 根 CA 憑證為自行簽署。此版本的 Oracle Blockchain Platform 不支援使用客戶提供的根 CA 憑證或中介 CA 憑證簽署這些憑證。

不支援從舊版升級

You cannot upgrade to Oracle Blockchain Platform Enterprise Edition 24.1 from Oracle Blockchain Platform Enterprise Edition 21.1 or Oracle Blockchain Platform Enterprise Edition 19.3.

解決方法:此問題沒有解決方法。

使用 Oracle Blockchain Platform XA 導入時的錯誤訊息

如果您下載實行 XA 協定的 Java 程式庫,然後在安裝 3.8.1 以前的 Maven 版本環境中使用該協定,則會顯示下列錯誤訊息:使用者自建物件資訊無效且包含無效字元

解決方法:可下載程式庫中的 .pom 檔案具有版本號碼的預留位置。更新 pom.xml 檔案,並將版本號碼變更為 24.1.3

登入時主控台沒有回應

當您嘗試登入服務主控台時,UI 可能沒有回應。

此行為由下列修補程式所修正:ORACLE BLOCKCHAIN PLATFORM ENTERPRISE EDITION (OBPEE) - 24.1.3 - PATCHSET-1 (修補程式編號 36929129)。如需有關安裝修補程式的詳細資訊,請參閱 修補 Oracle Blockchain Platform

無法重新安裝先前安裝失敗的鏈碼

如果您嘗試從先前失敗的安裝重新安裝與鏈碼相同名稱的鏈碼,安裝程序會再次失敗。先前嘗試建立鏈碼名稱為 Pod 且未刪除時,便會發生此情況。

此行為由下列修補程式所修正:ORACLE BLOCKCHAIN PLATFORM ENTERPRISE EDITION (OBPEE) - 24.1.3 - PATCHSET-1 (修補程式編號 36929129)。如需有關安裝修補程式的詳細資訊,請參閱 修補 Oracle Blockchain Platform

網路的 Oracle Blockchain Platform 執行處理無法管理撤銷的憑證

如果 Oracle Blockchain Platform 網路包含 Hyperledger Fabric 組織及其憑證被撤銷,則撤銷的憑證不會套用至、不會顯示於網路的 Oracle Blockchain Platform 執行處理,也無法從該執行處理撤銷。

解決方法:使用原生 Hyperledger Fabric CLI 或 SDK 匯入組織的憑證撤銷清單 (CRL) 檔案。

通路建立者無法更新通路的組態

當您使用原生 Hyperledger Fabric CLI 或 SDK 建立通道時, configtx.yaml 檔案中不會包含 Creator 原則。Oracle Blockchain Platform 需要建立者原則,才能允許通路建立者編輯通路的組態。

解決方法:手動編輯 configtx.yaml 檔案以新增 Creator 原則。

對等方無法從另一個對等方提取專用資料

如果專用資料收集的 blocktolive 值小於 10 且其 maxPeerCount 小於對等 (不包括背書對等) 的總數,對等體就無法從另一個對等體提取專用資料。當您使用主控台建立專用資料收集定義或使用原生 Hyperledger Fabric CLI 或 SDK 時,就會設定這個值。

解決方法:確認 blocktolive 值設為大於或等於 10。或確認 maxPeerCount 設為不少於對等體總數,但不包括背書對等體。如有需要,您可以重新建立或升級鏈碼,以重設這些值。

通路建立者組織與通路政策設定不一致

您可以使用主控台來建立通道,並將組織的 ACL 設為 ReaderOnly。儲存新通道之後,您就無法從通道的編輯通道組織選項更新此 ACL 設定。

不過,您可以使用主控台的管理通道原則選項,將您的組織新增至 Writers 原則,此原則會覆寫通道的 ReaderOnly ACL 設定。

解決方法:此問題沒有解決方法。

匯出與匯入的檔案不相容

您無法在主控台與 REST API 之間匯出及匯入檔案 (CRL、憑證、排序服務設定值及對等)。

主控台和 REST API 匯出的檔案僅與相同元件的匯入相容。例如,如果您使用主控台匯出對等體,則無法使用 REST API 匯入對等體 (只能透過主控台匯入)。如果您匯出具有 REST API 的對等體,則無法與主控台匯入 (只能與 REST API 一起匯入)。

解決方法:此問題沒有解決方法。

鏈碼名稱需求

Oracle Blockchain Platform 鏈碼名稱和版本需求與 Hyperledger Fabric 需求不同。從主控台或 Hyperledger Fabric 用戶端部署鏈碼時,您必須使用 Oracle Blockchain Platform 需求。如果您在從 Hyperledger Fabric 用戶端部署時未遵循這些需求,則鏈碼可能會在主控台中不正確地列出。

解決方法:部署鏈碼名稱和版本時,請使用下列規則。

  • 使用 ASCII 文數字字元、破折號 (-) 以及底線 (_)。
  • 名稱的開頭和結尾只能是 ASCII 文數字字元。例如,您無法使用 _mychaincodemychaincode_ 等名稱。
  • 破折號 (-) 和底線 (_) 後面必須接著 ASCII 文數字字元。例如,您無法使用 my--chaincodemy-_chaincode 等名稱。
  • 名稱和版本最多可有 64 個字元。
  • 鏈碼版本也可以包含句號 (.) 與加號 (+)。

日期與時間選擇器行為

Oracle Blockchain Platform 日期和時間選擇器未如預期般運作。您可以使用日期和時間選擇器來篩選項目,例如日誌檔或分類帳活動。

解決方法:使用下列資訊來協助您使用日期和時間選擇器。

  • 如果您選取特定期間 (例如,最後一天 ),然後再次選取以重新執行查詢,則不會重新執行查詢。若要取得最新資訊,請按一下重新整理按鈕。
  • 如果您尚未在電腦上設定時區,則當您選取自訂選項時,必須以 GMT 指定開始時間和結束時間。不過,如果您在「偏好設定」中將「時區設定」設為 GMT (在主控台中選取您的執行處理名稱,然後按一下「偏好設定」,然後按一下「時區設定」),主控台上的時區會自動轉換成 GMT。

說明文件協助工具

取得 Oracle 支援