문제 해결 MicroStrategy Library 설치

문제: 나의 Library 비었다

열기 Library 관리 제어판 Intelligence Server가 구성되어 실행 중인지 확인하세요.
귀하의 콘텐츠가 추가되지 않았습니다. Library.
REST API 오류 모니터링
때 Library 웹 애플리케이션이 오류 메시지 없이 예기치 않게 작동합니다. MicroStrategy 웹 브라우저 디버깅 도구를 사용하는 REST API입니다.
1. Chrome에서 개발자 도구를 엽니다.
2. 네트워크 탭을 엽니다.
3. 재현 단계를 수행합니다.
4. 모든 요청이 캡처되었는지 확인하십시오.
5. 관심 있는 네트워크 요청을 클릭하세요.
6. 요청 정보 창 내에서 미리보기 탭을 엽니다. 그러면 응답이 JSON 형식으로 표시됩니다.
7. 빨간색으로 표시된 네트워크 요청을 찾으세요. 이는 REST API 요청이 실패했음을 의미합니다. API 오류만 찾는 경우 XHR 네트워크 탭에 API를 포함한 모든 http(s) 호출이 표시되도록 하는 옵션입니다.
MicroStrategyLibrary 오류 로그를 검토하고 브라우저 디버깅 도구에서 콘솔 오류를 찾아보세요.
용도가 있는지 확인하세요 Library 모든 프로젝트에 대한 권한(참조 권한 Library 편물), 모든 프로젝트 내의 대시보드에 액세스할 수 있습니다.

문제: 협업 서버를 사용할 수 없습니다

알림 아이콘을 사용할 수 없는 경우:
- 로 이동 Library 관리 제어판 협업 서버를 구성합니다.
- 협업 서비스 사용 권한이 있는지 확인하십시오(참조: 권한 Library 편물).
알림 아이콘을 사용할 수 있지만 비활성화된 경우 Collaboration 서버가 연결되지 않은 것입니다. 아이콘을 클릭하고 오류 메시지 대화 상자를 사용하여 관리자에게 문의하십시오.
웹 소켓 오류 모니터링
Collaboration 서버 기능이 Library 자세한 오류 메시지 없이 실패하는 경우 웹 브라우저 디버깅 도구를 사용하여 웹 소켓 메시지에서 직접 오류 메시지를 모니터링하세요.
1. Chrome에서 엽니다. 개발자 도구.
2. 네트워크 탭을 엽니다.
3. 재현 단계를 수행합니다.
4. 요청 유형을 "WS"(WebSocket)로 필터링합니다.
5. 네트워크 요청을 클릭하세요.
6. 요청 정보 창 내에서 프레임 탭을 엽니다. 그러면 요청과 응답이 JSON 형식으로 표시됩니다.
- 요청이 표시되지 않으면 페이지를 새로 고치세요. 웹 소켓 연결이 설정된 후 브라우저 디버깅 도구가 네트워크 호출 캡처를 시작했을 수 있습니다.
- 새로 고친 후에도 요청이 표시되지 않으면 Library 귀하 환경의 웹 및 협업 서버는 환경 제한으로 인해 웹 소켓 대신 HTTP 폴링을 통해 이루어집니다.

일반적인 구성 오류

다음과 같이 연결이 거부되었음을 나타내는 오류:

인증 서버 방법을 호출할 수 없습니다. 오류: ECONNREFUSED 127.0.0.1:8443 연결(코드=ECONNREFUSED) 인증 서버에 연결할 수 없습니다.
"authorizationServerUrl"이 인증서와 연결된 "일반 이름"과 동일한 컴퓨터 이름을 사용하는지 확인하세요. 즉, 동일한 시스템에 대한 인증서가 없고 신뢰할 수 있는 인증 기관에서 인증서에 서명하지 않은 경우 해당 시스템에 대한 보안 연결을 열 수 없습니다.

다음과 같은 인증서 문제를 나타내는 오류:
- 인증 서버 메소드를 호출할 수 없습니다. 오류: 첫 번째 인증서 <code=UNABLE_TO_VERIFY_LEAF_SIGNATURE>를 확인할 수 없습니다. 인증 서버에 연결할 수 없습니다.
- Collaboration 서버에 지정된 인증서가 있는지 확인하세요. config.json 파일은 Tomcat에서 사용되는 키 저장소 파일을 만드는 데 사용된 것과 동일합니다.

Collaboration Server 연결 문제 진단

MicroStrategy 설치에서는 Collaboration 서버 연결 문제를 해결하기 위한 명령줄 진단 도구를 제공합니다.

진단 도구를 호출하려면:

Windows:

현재 작업 디렉터리를 다음으로 변경합니다. <MicroStrategy_commonFiles_path>\nodejs.

다음 명령을 실행합니다.

복사

node "<MicroStrategy_installed_path>\Collaboration Server\node_modules\mstr-collab-svc\diagnose.js" "<MicroStrategy_installed_path>\Collaboration Server\config.json"

Linux:

다음 명령을 실행하세요. /opt/mstr/MicroStrategy/install/CollaborationServer Collaboration 서버의 진단 도구를 실행하기 위한 디렉터리:

복사

./collaborationServer.sh diagnose

실행 중인 시스템에서 진단 도구를 호출하면 다음이 반환됩니다.

두 종속 서버 모두 연결됨으로 표시됩니다.
협업 서버는 시작됨 및 실행 중 상태로 표시됩니다.
이름과 만료 날짜가 포함된 신뢰할 수 있는 인증서 목록(신뢰할 수 있는 인증서가 설정된 경우에만 해당) config.json 파일)

진단 도구의 일반적인 오류

Collaboration Server가 중지된 것으로 표시됨

이는 Collaboration 서버가 실행되고 있지 않음을 의미합니다. Collaboration 서버를 시작하고 진단 도구를 다시 실행해야 합니다.

Collaboration Server 상태가 일시 중지된 것으로 표시됩니다. 인증 서버가 연결되지 않음

신뢰할 수 있는 CA 인증서 파일

진단 도구는 다음에 구성된 각 파일 경로를 읽으려고 시도합니다. config.json 파일을trustedCert로 저장하세요. 단일 파일에 여러 인증서가 있을 수 있습니다. 가능한 결과는 다음과 같습니다.

성공
지원되지 않는 형식
경고: 만료된 인증서가 포함되어 있습니다.
잘못된 PEM 블록
성공: 인증서 2개
경고: 만료된 인증서가 포함되어 있습니다(이 파일에는 2개의 인증서가 있습니다. 하나는 유효하고 하나는 만료되었습니다.)

Collaboration Server 로깅을 통한 문제 해결

Collaboration 서버 로깅이 활성화된 경우 Collaboration 서버에서 생성된 로그는 다음을 포함한 더 자세한 정보를 제공합니다.

경고 및 오류 실행
활동 요청
통지기록

Library 서버에서 Collaboration Server로의 오류 및 경고

경고: 비밀 키가 일치하지 않습니다

Library 상대 서버의 신원을 확인하려면 서버와 협업 서버를 동일한 비밀 키(최소 5자 문자열)로 설정해야 합니다. 비밀키가 일치하지 않는 경우 Library 서버가 Collaboration 서버와 통신할 수 없습니다. Collaboration 서버 구성 업데이트와 같은 기능 Library 관리 제어판이 실패합니다. 그만큼 Library 서버 자체는 사용해도 괜찮습니다.

경고: Truststore가 누락되었습니다. Library 섬기는 사람

Collaboration 서버가 TLS가 활성화된 상태로 실행 중이고 개인 루트 CA 서명 인증서를 사용하는 경우 Library 서버는 보안 통신을 설정하기 위해 해당 인증서를 제시해야 합니다. 관리자는 다음에서 신뢰 저장소 파일을 구성할 수 있습니다. Library 서버(참조 MicroStrategy Library 서버 구성 속성). 신뢰 저장소에서 필요한 인증서를 참조하지 못하면 이 경고가 발생합니다. 이 경고가 활성화되면 Library 서버가 Collaboration 서버와 통신할 수 없습니다. Collaboration 서버 구성 업데이트와 같은 기능 Library 관리 제어판이 실패합니다. 그만큼 Library 서버 자체는 사용해도 괜찮습니다.

경고: 브라우저에서 Collaboration 서버로 소켓 연결을 설정할 수 없습니다.

어떤 경우에는 Library 서버는 Collaboration 서버와 통신할 수 있지만 최종 사용자(브라우저)가 Collaboration 서버와의 통신을 설정하지 못할 수 있습니다(소켓 연결 설정 실패). 가능한 원인은 세 가지입니다.

그만큼 Library 서버는 TLS가 활성화된 상태로 실행되고(URL은 'https'로 시작하는 URL), Collaboration 서버는 TLS가 비활성화된 상태로 실행됩니다(URL은 'http'로 시작하는 URL). 일부 브라우저는 현재 웹사이트가 'https'를 사용하는 경우 'http'에 대한 요청을 차단합니다.
Collaboration 서버는 TLS가 활성화된 상태로 실행 중이지만 개인 루트 CA 서명 인증서를 사용하고 있습니다. 일부 브라우저는 이러한 개인 루트 CA를 신뢰할 수 없는 것으로 간주하여 해당 서버에 대한 요청을 차단합니다. 관리자는 해당 개인 루트 CA를 신뢰 목록에 추가해야 할 수도 있습니다.
관리자는 Collaboration 서버의 컴퓨터 이름으로 'localhost'와 같은 호스트 이름을 사용할 수 있습니다. Library 섬기는 사람. 해당 호스트 이름은 Library 서버이며 다른 사용자(클라이언트 시스템/브라우저)에서는 액세스할 수 없습니다.

두 가지 원인이 있을 수 있습니다.
- 해당 호스트 이름에 대한 IP 주소를 찾을 수 없습니다.: 최종 사용자는 시스템에서 도메인 이름을 IP 주소로 확인하는 데 도움이 될 수 있는 호스트 파일을 업데이트할 수 있습니다.
- IP 주소는 최종 사용자에게 표시되지 않습니다.: 로컬 IP 주소일 수도 있고 포트가 공개적으로 노출되지 않을 수도 있습니다.

협업 서버 Library 서버 오류 및 경고

경고: Collaboration Server는 현재 대상이 아닙니다. Library 섬기는 사람.

이는 경고일 뿐입니다. Collaboration 서버가 다른 서버와 통신 중입니다. Library 섬기는 사람. 현재 Library 서버는 사용해도 괜찮습니다. 두 가지 경우 잠재적인 문제가 발생할 수 있습니다. Library 서버는 다른 데이터를 제공합니다.

오류: Collaboration Server가 현재 대상이 아닙니다. Library 서버와 대상 Library 서버에 연결할 수 없습니다.

이 경우 협업 관련 기능은 다음과 같습니다. Library 이 오류로 인해 Collaboration 서버가 일시 중지되었으므로 사용할 수 없습니다. 관리자는 현재 사용하도록 선택할 수 있습니다. Library 서버를 대상으로 Library 이 Collaboration 서버용 서버입니다.

오류: 표적 Library 서버에 연결할 수 없으며 관리 제어판을 통해 설정할 수 없습니다.

관리 UI가 현재 Collaboration 서버에 대한 문제를 표시할 수 있지만 문제에 대한 솔루션을 제공할 수 없는 경우는 두 가지입니다.

비밀 키가 일치하지 않습니다. Library 서버 및 협업 서버.
Collaboration 서버는 개인 루트 CA 서명 인증서를 사용하여 TLS를 활성화하는 반면 Library 서버에 해당 인증서에 대한 신뢰 저장소가 없습니다.

두 가지 원인 모두 다음으로 이어질 것입니다. Library 서버가 Collaboration 서버와 통신할 수 없어 Collaboration 서버 설정을 제어/업데이트할 수 없습니다.

오류: Collaboration Store에 연결할 수 없습니다.

현재 관리 제어판은 Collaboration Store를 업데이트하기 위한 인터페이스를 노출하지 않습니다. 관리자는 Collaboration 서버 구성을 통해 수동으로 업데이트할 수 있습니다.

Library 서버에서 Intelligence Server로의 오류 및 경고

오류: Intelligence Server에 연결할 수 없습니다

관리자는 다음과 같은 경우 이 오류 메시지를 보게 됩니다. Library 서버가 현재 Intelligence Server에 연결할 수 없습니다.

관리자는 다음과 같은 경우 이 오류 메시지를 보게 됩니다. Library 서버가 현재 Intelligence 서버에 연결할 수 없으며 관리 UI가 현재 Intelligence 서버의 호스트 이름과 포트를 사용하여 연결 테스트에 성공했습니다. 이는 잘못된 TLS 설정을 사용했기 때문에 발생할 가능성이 높습니다.

오류: 최소 버전 요구 사항

만약 Library 서버가 최소 Intelligence Server 버전 요구 사항을 설정했는데 현재 Intelligence Server가 해당 요구 사항을 충족하지 않으면 이 오류 메시지가 표시됩니다.