Troubleshooting securityadmin.sh
출처: 문서
본문
securityadmin.sh 문제 해결
다음 문제 해결 단계를 사용하여 /plugins/opensearch-security/tools/securityadmin.sh에 있는 securityadmin.sh 스크립트의 문제를 해결하세요. 이 도구 사용에 대한 자세한 내용은 Applying changes to configuration files를 참조하세요.
목차
- TOC {:toc}
클러스터에 연결할 수 없음
securityadmin.sh가 클러스터에 연결할 수 없으면 다음과 같이 출력해요:
OpenSearch Security Admin v6
Will connect to localhost:9200
ERR: Seems there is no opensearch running on localhost:9200 - Will exit
호스트 이름 확인
기본적으로 securityadmin.sh는 localhost를 사용해요. 클러스터가 다른 호스트에서 실행 중인 경우 -h 옵션을 사용하여 호스트 이름을 지정하세요.
포트 확인
securityadmin.sh를 HTTP 포트에 대해 실행하고 있는지 확인하세요. 전송 포트가 아니에요.
기본적으로 securityadmin.sh는 9200을 사용해요. 클러스터가 다른 포트에서 실행 중인 경우 -p 옵션을 사용하여 포트 번호를 지정하세요.
구성된 노드를 사용할 수 없음
securityadmin.sh가 클러스터에 연결할 수 있지만 구성을 업데이트할 수 없는 경우 다음 오류를 출력해요:
Contacting opensearch cluster 'opensearch' and wait for YELLOW clusterstate ...
Cannot retrieve cluster state due to: None of the configured nodes are available: [{#transport#-1}{mr2NlX3XQ3WvtVG0Dv5eHw}{localhost}{127.0.0.1:9300}]. This is not an error, will keep on trying ...
-
-icl및-nhnv옵션을 사용하여securityadmin.sh를 실행해 보세요.이 방법이 작동하면 클러스터 이름과 SSL 인증서의 호스트 이름을 확인하세요. 작동하지 않으면
--diagnose옵션을 사용하여securityadmin.sh를 실행하고 진단 추적 로그 파일을 확인하세요. -
--accept-red-cluster를 추가하여securityadmin.sh가 빨간색 클러스터에서 작동하도록 허용하세요.
클러스터 이름 확인
기본적으로 securityadmin.sh는 opensearch를 클러스터 이름으로 사용해요.
클러스터 이름이 다른 경우 -icl 옵션을 사용하여 이름을 완전히 무시하거나 -cn 옵션을 사용하여 이름을 지정할 수 있어요.
호스트 이름 검증 확인
기본적으로 securityadmin.sh는 노드 인증서의 호스트 이름이 노드의 실제 호스트 이름과 일치하는지 확인해요.
그렇지 않은 경우(예: 데모 인증서를 사용하는 경우) -nhnv 옵션을 추가하여 호스트 이름 검증을 비활성화할 수 있어요.
클러스터 상태 확인
기본적으로 securityadmin.sh는 클러스터 상태가 최소한 노란색인 경우에만 실행돼요.
클러스터 상태가 빨간색인 경우에도 securityadmin.sh를 실행할 수 있지만 -arc 옵션을 추가해야 해요.
보안 인덱스 이름 확인
기본적으로 보안 플러그인은 .opendistro_security를 구성 인덱스 이름으로 사용해요. opensearch.yml에서 다른 인덱스 이름을 구성한 경우 -i 옵션을 사용하여 지정하세요.
"ERR: DN is not an admin user"
securityadmin.sh를 시작하는 데 사용된 TLS 인증서가 관리자 인증서가 아닌 경우 스크립트는 다음과 같이 출력해요:
Connected as CN=node-0.example.com,OU=SSL,O=Test,L=Test,C=DE
ERR: CN=node-0.example.com,OU=SSL,O=Test,L=Test,C=DE is not an admin user
스크립트를 실행할 때 관리자 인증서를 사용해야 해요. 자세한 내용은 Configuring super admin certificates를 참조하세요.
진단 옵션 사용
securityadmin.sh가 실행되지 않는 이유에 대한 자세한 내용을 보려면 --diagnose 옵션(또는 단축형 -dg)을 추가하세요:
./securityadmin.sh --diagnose -cd ../../../config/opensearch-security/ -cacert ... -cert ... -key ... -keypass ...
스크립트는 생성된 진단 파일의 위치를 출력해요.