엔터프라이즈 설치 및 업그레이드#

plans-img 엔터프라이즈 플랜 에서 이용 가능

deployment-img 자체 호스팅 배포

Mattermost Enterprise Edition은 엔터프라이즈 기능을 활성화하지 않은 “팀 모드”에서 무료로 사용할 수 있습니다. Mattermost는 엔터프라이즈와 프로페셔널을 포함한 두 가지 구독 플랜을 제공합니다. 온라인에서 기능을 비교 할 수 있습니다.

Mattermost를 다운로드하고 설치한 후, 제품 메뉴 > 시스템 콘솔 > 에디션 및 라이선스 > 시작하기 를 통해 엔터프라이즈 평가판을 시작하세요. 온라인에서 가격 및 기능 정보를 확인하고, 라이선스 키를 구매하려면 Mattermost 전문가 와 상담하세요.

엔터프라이즈 에디션 설치#

Mattermost Enterprise Edition을 설치하려면 Mattermost 배포 페이지를 참조하세요.

Mattermost Enterprise Edition으로 업그레이드#

Mattermost 에디션 및 버전 확인#

웹 또는 데스크톱 인터페이스에서 에디션과 버전을 확인하려면 제품 메뉴 > Mattermost 정보 를 여세요.

  • Mattermost Enterprise Edition 은 라이선스 키를 적용하여 엔터프라이즈 기능을 활성화할 수 있음을 나타냅니다.

  • Mattermost Team Edition 은 오픈 소스 버전을 사용 중이며 라이선스 키를 적용하기 전에 (아래 업그레이드 지침에 따라) 업그레이드가 필요함을 나타냅니다.

Mattermost Team Edition에서 Enterprise Edition으로 업그레이드#

오픈 소스 Mattermost Team Edition은 무료 “팀 모드”에서 상용 Mattermost Enterprise Edition과 기능적으로 동일하지만, 엔터프라이즈 기능을 잠금 해제할 수 있는 기능은 없습니다.

엔터프라이즈 기능 잠금 해제를 활성화하려면 업그레이드 절차 를 통해 Mattermost Team Edition 바이너리를 Mattermost Enterprise Edition 바이너리로 교체하세요.

업그레이드 전에 Mattermost를 백업하려면 마이그레이션 가이드 에서 데이터베이스 백업 및 복원에 필요한 절차를 확인하세요.

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

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

  1. GitLab Omnibus의 내장 Mattermost 인스턴스를 비활성화하세요:

  • /etc/gitlab/gitlab.rb 로 이동하여 다음 줄을 false로 설정하세요:

mattermost['enable'] = false

  • 그런 다음 업데이트된 설정을 적용하려면 다음 명령을 실행하세요:

sudo gitlab-ctl reconfigure

  1. 위의 가이드 중 하나를 사용하여 Mattermost를 설치하세요.

  2. 새 Enterprise Edition 인스턴스에 GitLab Mattermost에서 사용하는 데이터베이스를 마이그레이션하세요.

  3. (선택 사항) Mattermost 인스턴스에 GitLab 슬래시 명령어 통합 을 설정하세요.

설치 전에 Team Edition을 마이그레이션해야 하는 경우 마이그레이션 가이드 를 따르세요.

Enterprise Edition을 새 버전으로 업그레이드#

업그레이드 절차 를 따라 이전 버전의 Mattermost Enterprise Edition을 최신 버전으로 업그레이드하세요.

Team Edition을 Enterprise Edition으로 변환#

x86-64 아키텍처의 Linux 시스템을 실행 중이라면 내장된 변환 유틸리티를 사용하여 System Console에서 Team Edition을 Enterprise로 변환할 수 있습니다. Enterprise 평가판을 실행하거나 독립 실행형 서버에서 Enterprise 또는 Professional으로 업그레이드하려는 경우 이 도구를 권장합니다.

참고

  • GitLab Omnibus와 같은 관리형 환경에서 Mattermost를 사용 중이고 Enterprise Edition 평가판을 시작하려는 경우 이 도구를 사용할 수 있습니다. 그러나 영구적으로 업그레이드하고 프로덕션 환경을 확장할 계획이라면 새로운 독립 실행형 서버를 설치하고 적절한 마이그레이션 프로세스 를 따르는 것을 강력히 권장합니다.

  • Mattermost의 수정된 버전을 사용 중이라면 이 도구를 사용하면 변경 사항이 덮어쓰여지고 공식 Enterprise Edition 바이너리로 대체됩니다.

  • v5.27 이전 버전의 경우 이 업그레이드 지침 을 따르세요.

제품 메뉴 > System Console > Edition and License 로 이동하여 Enterprise Edition으로 업그레이드 를 선택하세요.

업그레이드 프로세스 중에 현재 서버 버전과 일치하는 Mattermost Enterprise Edition 바이너리 파일이 다운로드, 압축 해제 및 추출됩니다. 그런 다음 Team Edition 바이너리가 Enterprise Edition 버전으로 대체됩니다. 이 프로세스가 완료되면 서버를 재시작하라는 메시지가 표시됩니다.

제품 메뉴 > System Console > Edition and License 에 나열된 Mattermost 버전이 Team Edition 에서 Enterprise Edition 으로 변경되며, 이제 Enterprise Edition 평가판을 활성화하거나 라이선스를 업로드할 수 있습니다.

권한 및 제한 사항#

GitLab Omnibus와 같은 패키지 관리자를 사용하여 Mattermost 설치를 관리하는 경우 Mattermost 시스템 사용자는 업그레이드를 수행할 수 있는 충분한 권한이 없습니다. 이 경우 파일 권한을 수동으로 변경해야 합니다.

이러한 방식으로 권한을 변경해도 Mattermost 배포나 데이터에 영향을 미치지 않습니다. 권한 변경은 업그레이드를 위해서만 수행됩니다.

Mattermost 서버에서 명령줄을 사용하여 권한을 변경하려면 mattermost 사용자로 명령줄 도구에 접근해야 합니다. Mattermost 서버에서 명령줄 도구를 열고 Mattermost 설치 디렉토리로 cd 하세요. 다음 명령을 실행하여(<PathToBinaryFile> 를 적절한 경로(일반적으로 /opt/mattermost/bin/mattermost)로 대체) 바이너리 파일의 소유권을 mattermost 사용자로 변경하고 쓰기 권한을 부여하세요:

chown mattermost <PathToBinaryFile>
chmod +w <PathToBinaryFile>

Mattermost System Console에서 업그레이드를 다시 시도하세요. 업그레이드가 완료되면 Mattermost 서버의 명령 프롬프트로 돌아가서 다음 명령을 실행하여 파일 권한을 복원하세요(<OriginalFileOwner> 를 적절한 값으로 대체):

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

변환 후 다른 시스템 관리자가 수행한 자동 업데이트나 작업이 변경 사항을 덮어쓰고 시스템을 Team Edition으로 되돌릴 수 있다는 점에 유의하세요. 여기에는 GitLab Omnibus 내에서 Mattermost를 업데이트하는 run gitlab-ctl configure 명령이 포함됩니다. 이 경우 서버를 다시 변환할 때까지 Enterprise Edition 기능을 사용할 수 없지만 데이터에는 영향을 받지 않습니다.

문제 해결#

Mattermost가 Team Edition으로 되돌아감#

관리형 배포에서 Team Edition을 Enterprise Edition으로 변환한 후 업그레이드한 경우, 업그레이드가 Enterprise Edition을 최신 버전의 Team Edition으로 덮어쓰게 됩니다.

위 단계를 따라 Enterprise Edition으로 다시 변환할 수 있습니다. Mattermost Enterprise Edition을 영구적으로 사용할 계획이라면 서버를 자체 호스팅 서버로 마이그레이션하는 것을 권장합니다.

수동 프로세스가 파일 권한을 재설정함#

파일 권한을 수동으로 변경한 경우 다시 변경할 수 있습니다.

  1. Mattermost 서버에서 명령줄 도구를 엽니다.

  2. Mattermost 설치 디렉토리로 cd 합니다(일반적으로 /opt/mattermost/bin/mattermost).

  3. 입력:

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

파일 권한 오류#

Mattermost 배포가 관리형 패키지의 일부인 경우 파일 권한 오류가 발생하고 업그레이드가 실패할 수 있습니다. 권한 설정을 수동으로 편집할 수 있습니다:

  1. Mattermost 서버에서 명령줄 도구를 엽니다.

  2. Mattermost 설치 디렉토리로 cd 합니다(일반적으로 /opt/mattermost/bin/mattermost).

  3. 입력:

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

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

이 도구는 현재 x86-64 아키텍처를 사용하는 Linux 시스템과만 호환됩니다. 다른 아키텍처에서 Mattermost를 실행 중인 경우 수동 업그레이드 프로세스를 따르세요.

Enterprise Edition 바이너리 파일을 검색할 수 없음#

파일 검색 실패, 사용할 수 없는 바이너리 또는 연결 오류로 인해 업그레이드가 실패하는 경우 프록시 설정을 확인하고 다시 시도하세요. 문제가 지속되면 대신 수동 업그레이드 프로세스를 따르세요.