Team Edition을 Enterprise Edition으로 업그레이드

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

Team Edition으로 Mattermost를 평가하고 있다면, 체험판을 시작하거나 Enterprise 기능을 활성화하는 라이선스를 업로드하기 전에 Mattermost Enterprise Edition으로 업그레이드해야 합니다. 오픈 소스인 Mattermost Team Edition은 상용 Enterprise Edition과 기능적으로 동일하지만, 체험판을 시작하거나 유료 기능을 해제할 수는 없습니다.

Enterprise Edition으로 업그레이드

에디션과 버전 확인

웹 또는 데스크톱 인터페이스에서 Product menu > About Mattermost(제품 메뉴 > Mattermost 정보)를 열어 에디션과 버전을 확인하세요.

  • Mattermost Entry는 유료 라이선스 없이 라이선스 에디션의 Mattermost를 사용하고 있음을 의미합니다.
  • Mattermost Professional은 유료 professional 라이선스와 함께 라이선스 에디션의 Mattermost를 사용하고 있음을 의미합니다.
  • Mattermost Enterprise는 유료 enterprise 라이선스와 함께 라이선스 에디션의 Mattermost를 사용하고 있음을 의미합니다.
  • Mattermost Enterprise Advanced는 유료 enterprise advanced 라이선스와 함께 라이선스 에디션의 Mattermost를 사용하고 있음을 의미합니다.
  • Mattermost Team Edition은 오픈 소스 버전을 사용하고 있으며, 라이선스 키를 적용하려면 먼저 라이선스 에디션으로 업그레이드해야 함을 의미합니다.

시스템 콘솔을 통한 업그레이드(권장)

대부분의 단독 서버는 시스템 콘솔에 내장된 변환 도구를 사용해 몇 분 만에 Team Edition을 Enterprise Edition으로 업그레이드할 수 있으며, 이 방식을 권장합니다.

Product menu > System Console > Edition and License로 이동해 Upgrade to Enterprise Edition을 선택하세요.

업그레이드 과정에서는 현재 서버 버전과 일치하는 Mattermost Enterprise Edition 바이너리 파일을 내려받아 압축을 풀고 추출합니다. 그런 다음 Team Edition 바이너리가 Enterprise Edition 버전으로 교체됩니다.

참고

수정된 버전의 Mattermost를 사용하고 있다면, 이 도구를 사용할 경우 수정 사항이 공식 Enterprise Edition 바이너리로 덮어써집니다.

이 과정이 끝나면 서버를 다시 시작하라는 안내가 표시됩니다. Product menu > System Console > Edition and License에 표시되는 Mattermost 버전이 Team Edition에서 Mattermost Entry로 바뀌며, 이제 professional, enterprise, enterprise advanced 라이선스를 업로드해 유료 기능을 해제할 수 있습니다.

수동 업그레이드

또는 정기 서버 업그레이드를 진행할 때 이 업그레이드 절차에 따라 Mattermost Team Edition 바이너리를 Mattermost Enterprise Edition 바이너리로 교체할 수 있습니다.

업그레이드 전에 Mattermost를 백업할 것을 권장합니다. 데이터베이스를 백업하고 복원하는 데 필요한 절차는 마이그레이션 가이드 문서에 설명되어 있습니다.

GitLab Omnibus에서 Enterprise Edition으로 업그레이드

GitLab Omnibus는 오픈 소스인 Mattermost Team Edition을 실행합니다. Mattermost Enterprise Edition으로 업그레이드하려면 다음 단계를 따르세요.

  1. /etc/gitlab/gitlab.rb로 이동해 다음 줄을 false로 설정하여 GitLab Omnibus에 내장된 Mattermost 인스턴스를 비활성화합니다.

    mattermost['enable'] = false

    그런 다음 다음 명령을 실행해 변경한 설정을 적용합니다.

    sudo gitlab-ctl reconfigure
  2. 위 가이드 중 하나를 사용해 Mattermost를 설치합니다.
  3. 새 Enterprise Edition 인스턴스를 위해 GitLab Mattermost가 사용하던 데이터베이스를 마이그레이션합니다.
  4. (선택) Mattermost 인스턴스에 GitLab 슬래시 명령 연동을 설정합니다.

문제 해결

권한과 제약

Gitlab Omnibus 같은 패키지 관리자로 Mattermost 설치를 관리하고 있다면, Mattermost 시스템 사용자에게 업그레이드를 수행할 충분한 권한이 없습니다. 이 경우 파일 권한을 직접 변경해야 합니다.

이런 방식으로 권한을 변경해도 Mattermost 배포에 영향을 주거나 데이터에 문제가 생기지는 않습니다. 권한 변경은 오직 업그레이드를 위한 것입니다.

Mattermost 서버의 명령줄에서 권한을 변경하려면 mattermost 사용자로 명령줄 도구에 접근할 수 있어야 합니다.

  1. Mattermost 서버에서 명령줄 도구를 열고 Mattermost 설치 디렉터리로 cd 합니다.

  2. 다음 명령을 실행해 바이너리 파일의 소유권을 mattermost 사용자로 변경하고 쓰기 권한을 부여합니다. <PathToBinaryFile>은 적절한 경로(일반적으로 /opt/mattermost/bin/mattermost)로 바꾸세요.

    chown mattermost <PathToBinaryFile>
chmod +w <PathToBinaryFile>

  3. Mattermost 시스템 콘솔에서 업그레이드를 다시 시도합니다.

  4. 업그레이드가 완료되면 Mattermost 서버의 명령 프롬프트로 돌아가 다음 명령을 실행해 파일 권한을 원래대로 되돌립니다. <OriginalFileOwner>는 적절한 값으로 바꾸세요.

    chown <OriginalFileOwner> <PathToBinaryFile>
chmod -w <PathToBinaryFile>

Mattermost가 Team Edition으로 되돌아간 경우

관리형 배포에서 Team Edition을 Enterprise Edition으로 업그레이드한 뒤 다시 업그레이드를 수행하면, 그 업그레이드가 Enterprise Edition을 최신 버전의 Team Edition으로 덮어썼을 수 있습니다.

위 단계를 다시 따라 Enterprise Edition으로 변환할 수 있습니다. Mattermost Enterprise Edition을 계속 사용할 계획이라면 서버를 자체 호스팅 배포로 이전할 것을 권장합니다.

호환되지 않는 시스템 아키텍처

이 시스템 콘솔 도구는 x86-64 아키텍처를 사용하는 Linux 시스템에서만 동작합니다. 다른 아키텍처에서 Mattermost를 실행하고 있다면 수동 업그레이드 절차를 대신 따르세요.

Enterprise Edition 바이너리 파일을 가져올 수 없는 경우

파일 조회 실패, 바이너리 사용 불가, 연결 오류로 업그레이드가 실패한 경우 프록시 설정을 확인하고 다시 시도해 보세요. 문제가 계속되면 수동 업그레이드 절차를 대신 따르세요.