라이선스 키 설치

Mattermost v11.11번역일: 2026-09-02원본 보기

시스템 콘솔이나 mmctl 도구를 사용해 Mattermost 라이선스 키를 추가하거나 변경할 수 있습니다.

시스템 콘솔 사용

  1. System Console > About > Edition and License(시스템 콘솔 > 정보 > 에디션 및 라이선스)로 이동합니다.
  2. 라이선스 키 파일을 업로드합니다.

키를 업로드해 설치하고 나면 라이선스 세부 정보가 표시됩니다.

mmctl 사용

mmctl license upload 명령을 사용해 새 라이선스를 업로드하거나 기존 라이선스 파일을 새 파일로 교체합니다. 완료되면 Mattermost 서버를 재시작하세요. 고가용성 환경에서 운영 중이라면 모든 노드에 새 라이선스 파일을 반영해야 합니다.

mmctl license upload [license] [flags]
참고
  • Mattermost v10.11부터는 라이선스를 환경 변수로 설정한 경우 라이선스를 추가하는 옵션이 비활성화됩니다.
  • Premier Support 애드온을 사용하는 Enterprise 고객은 테스트용 스테이징 라이선스를 요청할 수 있습니다.
  • Mattermost Enterprise 또는 Professional 라이선스 키를 제거해도 Enterprise 설정의 구성은 삭제되지 않습니다. 다만 Enterprise 또는 Professional 라이선스 키를 적용하기 전까지는 해당 기능이 동작하지 않습니다.
  • 고가용성을 사용할 때는 다중 노드 클러스터의 장애를 방지하기 위해 클러스터의 모든 서버에 동일한 Enterprise 라이선스가 올바르게 설치되어 있는지 반드시 확인해야 합니다. 고가용성이 동작하려면 Enterprise 라이선스가 필요합니다.
  • 이전에 Professional 라이선스가 적용되었던 서버에 Enterprise 라이선스 키를 적용하면 Professional 기능의 설정값이 Enterprise에서도 유지됩니다.
  • 이전에 Enterprise 라이선스가 적용되었던 서버에 Professional 라이선스를 적용하면 Enterprise 기능의 설정값은 유지되지만 해당 기능을 더 이상 사용할 수 없습니다.

기존 라이선스 키 변경

Mattermost에서 받은 새 라이선스로 교체하기 위해 현재 라이선스 키가 만료될 때까지 기다릴 필요는 없습니다. 서버는 시작일이 아니라 좌석 수와 라이선스 종료일만 확인하므로, 새 라이선스를 받는 즉시 적용할 수 있습니다. 다만 새 라이선스의 좌석 수가 현재 Mattermost 전체 사용자 수 이상인지 확인하세요.

팁

새 키를 업로드하기 전에 라이선스 사용량을 확인하려면 System Console > Reporting > System Statistics(시스템 콘솔 > 보고 > 시스템 통계)로 이동하세요. Total Activated Users 필드는 라이선스 검증에 사용되는 기본 유료 좌석 수를 보여 줍니다. Single-channel Guests는 따로 확인해야 합니다. 활성 채널 하나에만 속한 게스트는 기본 유료 좌석 수와 별도로 집계되고, 라이선스 좌석과 1:1 비율까지는 무료이며, 그 허용치를 초과하면 강제 제한 대신 경고가 발생합니다. 게스트 채널 접근 과금에는 활성 채널만 포함되며 보관된 채널은 제외됩니다.

라이선스 키를 변경하려면 다음 단계를 따르세요.

  1. System Console > About > Edition and License로 이동합니다.
  2. Mattermost v6.7부터는 새 라이선스 키 파일을 업로드하기만 하면 됩니다.
참고

v6.7보다 오래된 Mattermost 릴리스를 실행 중이라면, 먼저 Remove Enterprise License and Downgrade Server를 선택해 서버에서 라이선스를 지우고 시스템 콘솔을 새로 고친 뒤 새 키를 업로드하세요.

라이선스 키 저장 위치

라이선스 키를 Mattermost 서버에 업로드하면 SQL 데이터베이스의 mattermost.Licenses에 저장됩니다. select * from mattermost.Licenses;를 실행하면 서버에 어떤 키가 있는지 확인할 수 있습니다.

라이브 데모를 예약하거나 Mattermost 전문가와 상담하여 조직의 보안 협업 요구에 맞는 솔루션을 알아보세요. 또는 1시간 미리보기로 실제 샌드박스 환경에 바로 접속해 Mattermost를 직접 사용해 볼 수 있습니다.