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 인증서로 이러한 인증서 서명을 지원하지 않습니다.

지원되지 않는 이전 릴리스에서 업그레이드

Oracle Blockchain Platform Enterprise Edition 24.1은 Oracle Blockchain Platform Enterprise Edition 21.1 또는 Oracle Blockchain Platform Enterprise Edition 19.3에서 업그레이드할 수 없습니다.

해결 방법: 이 문제에 대한 임시해결책이 없습니다.

Oracle Blockchain Platform XA 구현을 사용하는 경우 오류 메시지

XA 프로토콜을 구현하는 Java 라이브러리를 다운로드하여 Maven 3.8.1 이후 버전이 설치된 환경에서 사용할 경우 다음 오류 메시지가 표시됩니다. 아티팩트 정보가 부적합하고 부적합한 문자가 포함되어 있습니다.

해결 방법: 다운로드 가능한 라이브러리의 .pom 파일에 버전 번호에 대한 위치 표시자가 있습니다. pom.xml 파일을 업데이트하고 버전 번호를 24.1.3으로 변경합니다.

로그인할 때 콘솔이 응답하지 않음

서비스 콘솔에 로그인하려고 시도하면 UI가 응답하지 않을 수 있습니다.

이 동작은 패치 번호 36929129인 ORACLE BLOCKCHAIN PLATFORM ENTERPRISE EDITION(OBPEE) - 24.1.3 - PATCHSET-1 패치로 수정되었습니다. 패치 설치에 대한 자세한 내용은 패치 Oracle Blockchain Platform를 참조하십시오.

이전에 설치하지 못한 체인코드를 다시 설치할 수 없음

이전에 실패한 설치의 체인 코드와 동일한 이름의 체인 코드를 다시 설치하려고 하면 설치 프로세스가 다시 실패합니다. 이 오류는 이전 설치 시도에 대해 체인코드 이름을 가진 POD가 생성된 후 삭제되지 않은 경우에 발생할 수 있습니다.

이 동작은 패치 번호 36929129인 ORACLE BLOCKCHAIN PLATFORM ENTERPRISE EDITION(OBPEE) - 24.1.3 - PATCHSET-1 패치로 수정되었습니다. 패치 설치에 대한 자세한 내용은 패치 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 파일에 포함되지 않습니다. Oracle Blockchain Platform에서 채널 생성자가 채널의 구성을 편집할 수 있도록 하려면 생성자 정책이 필요합니다.

해결 방법: configtx.yaml 파일을 수동으로 편집하여 Creator 정책을 추가합니다.

상대방이 다른 피어로부터 개인 데이터를 가져오지 못함

개인 데이터 수집의 blocktolive 값이 10보다 작고 해당 maxPeerCount이 보증 피어를 포함하지 않는 총 피어 수보다 작은 경우 피어가 다른 피어로부터 개인 데이터를 가져오지 못할 수 있습니다. 이 값은 콘솔을 사용하여 개인 데이터 수집 정의를 생성하거나 고유 Hyperledger Fabric CLI 또는 SDK를 사용할 때 설정됩니다.

임시해결책: blocktolive 값이 10보다 크거나 같은 값으로 설정되었는지 확인하십시오. 또는 maxPeerCount가 배서 피어를 포함하지 않고 총 피어 수보다 작지 않게 설정되었는지 확인합니다. 필요한 경우 체인코드를 다시 인스턴스화하거나 업그레이드하여 이러한 값을 재설정할 수 있습니다.

채널 생성자 조직 및 채널 정책 설정 불일치

콘솔을 사용하여 채널을 만들고 조직의 ACL을 ReaderOnly로 설정할 수 있습니다. 새 채널을 저장한 후에는 채널의 채널 조직 편집 옵션에서 이 ACL 설정을 업데이트할 수 없습니다.

하지만 콘솔의 채널 정책 관리 옵션을 사용하여 작성기 정책에 조직을 추가할 수 있습니다. 그러면 채널의 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 영숫자로만 시작하고 끝나야 합니다. 예를 들어, _mychaincode 또는 mychaincode_와 같은 이름은 사용할 수 없습니다.
  • 대시(-) 및 밑줄(_) 뒤에 ASCII 영숫자가 와야 합니다. 예를 들어, my--chaincode 또는 my-_chaincode와 같은 이름은 사용할 수 없습니다.
  • 이름과 버전은 각각 64자까지 사용할 수 있습니다.
  • 체인코드 버전에는 마침표(.) 및 더하기 기호(+)도 포함될 수 있습니다.

날짜 및 시간 선택기 동작

Oracle Blockchain Platform 날짜 및 시간 선택기가 예상대로 작동하지 않습니다. 일자 및 시간 선택기를 사용하여 로그 파일 또는 원장 활동과 같은 항목을 필터링합니다.

해결 방법: 다음 정보를 사용하여 날짜 및 시간 선택기를 사용할 수 있습니다.

  • 특정 기간(예: 지난 날)을 선택한 다음 다시 선택하여 질의를 재실행하면 질의가 재실행되지 않습니다. 최신 정보를 얻으려면 Refresh 버튼을 누릅니다.
  • 컴퓨터에서 시간대를 설정하지 않은 경우 사용자 정의 옵션을 선택할 때 GMT에서 시작 시간과 종료 시간을 지정해야 합니다. 하지만 [환경설정]에서 [시간대 설정]을 GMT로 설정하면(콘솔에서 인스턴스 이름을 선택하고 [환경설정], [시간대 설정] 순으로 누르면) 콘솔의 시간대가 자동으로 GMT로 변환됩니다.

설명서 접근성

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

오라클 고객지원센터 액세스

오라클 고객의 오라클 지원 서비스 접근 및 이용은 해당 서비스의 오라클 주문서에 명시된 조항들에 따릅니다.