Ops Manager API를 사용하여 Ops Manager 설치의 라이선스 키 상태를 확인하고 라이선스 키를 설치 또는 해제할 수 있습니다. Ops Manager에서 라이선스 키 상태를 계산하는 방법에 대한 자세한 내용은 Ops Manager 라이선스 키 개요를 참조하세요. Ops Manager 인터페이스에서 라이선스 키를 관리하는 방법에 대한 자세한 내용은 Ops Manager에서 라이선스 키 관리를 참조하세요.
전제 조건
시작하기 전에 다음 항목이 준비되어 있는지 확인하세요.
An API key with the
Global Ownerrole.키 포털에서 생성한 라이선스 키 파일입니다. 생성 방법은 Ops Manager에서 라이선스 키 관리하기를 참조하세요.
라이선스 키를 설치하세요
다음 절차에 따라 라이선스 키를 설치하고 Ops Manager에서 해당 키가 적용되는지 확인하십시오.
현재 라이선스 키 상태를 확인하세요
Send a GET request to the /admin/licenses endpoint:
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request GET \ "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/licenses?pretty=true"The response includes the enforcement.effectiveState field and the licenses array. For a description of each field, see Get the License Key Status of an Installation.
라이선스 키를 설치하세요
Send a PUT request to the /admin/licenses endpoint. Use the contents of your license key file as the request body:
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include \ --request PUT \ "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/licenses?pretty=true" \ --data @{LICENSE-KEY-FILE}Ops Manager가 라이선스 키를 수락하면 Ops Manager는 상태를 다시 계산하여 반환합니다. Ops Manager가 라이선스 키를 거부하면 응답에 오류가 포함됩니다. 오류를 해결하려면 설치 오류 문제 해결을 참조하십시오.
새 라이선스 키 상태를 확인하십시오.
이전 단계의 응답에서 다음 항목을 확인하십시오.
enforcement.effectiveState은LICENSED입니다.The new license key appears in the
licensesarray with astatusofACTIVE.
상태가 예상과 다르면 온디맨드 라이선스 키 상태 재계산 엔드포인트 를 호출하여 상태를 다시 계산한 다음 필드를 다시 확인하십시오.
라이선스 키 공개
Ops Manager 설치에서 라이선스 키를 해제하려면 다음 절차를 따르십시오.
중요
After you release a license key, you can't use it again. If you release the only usable license key, your installation has no coverage. The state changes to GRACE, and then to UNLICENSED after 90 days.
라이선스 키를 공개하세요
Send a DELETE request to the /admin/licenses/{artifactId} endpoint. Replace {ARTIFACT-ID} with the artifactId value:
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request DELETE \ "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/licenses/{ARTIFACT-ID}?pretty=true"Ops Manager는 상태를 다시 계산하여 반환합니다. 자세한 내용은 Ops Manager에서 라이선스 키 해제를 참조하세요.
키 관리자 ID를 검색하세요
The Key Manager ID identifies your Ops Manager installation, including every instance in a high-availability setup. The API returns the Key Manager ID in the holderId field. To retrieve it, send a GET request to the /admin/artifacts/identity endpoint. To learn more, see Get the Key Manager ID of an Installation.
ID 키를 회전시키세요
Ops Manager 설치는 MongoDB에 연결할 때 설치의 신원을 증명하는 데 사용되는 키 쌍인 ID 키를 생성합니다. 조직 외부의 누군가가 개인 키를 획득했을 가능성이 있는 경우, 키를 교체하여 새 키 쌍으로 변경해야 합니다. 키를 교체하려면 설치가 MongoDB에 연결할 수 있어야 합니다. 자세한 내용은 설치의 ID 키 교체를 참조하세요.
설치 오류 해결
When Ops Manager rejects a license key, the response has an HTTP status of 400, 403, or 409 and a JSON body that describes the error. The following fields identify the error:
필드 | 설명 |
|---|---|
| Error code, such as |
| 오류 내용과 해결 방법을 설명하는 메시지입니다. |
오류 코드, HTTP 상태 및 메시지 목록은 설치 오류 문제 해결을 참조하십시오.
관련 페이지
라이선스 키에 대한 자세한 내용은 다음 페이지를 참조하십시오.