일반 배포 문제 해결

Mattermost 배포 시 발생하는 일반적인 문제와 해결 방법을 안내합니다. 시스템 부팅 시 자동 시작, 로그 검토, 환경 점검, 지원 티켓 제출 방법을 설명합니다.

이 문서에서는 일반적인 배포 문제 해결 방법을 요약합니다. 일부는 직접 수행할 수 있고, 다른 일부는 네트워크 관리자와 상담이 필요할 수 있습니다. 시스템 부팅 시 Mattermost 시작 # Mattermost 서버가 시스템 부팅 시 시작되도록 하려면 systemd 유닛 파일을 활성화해야 합니다. 다음 명령을 실행하세요: sudo systemctl enable mattermost.service 데이터베이스가 Mattermost 서버와 같은 시스템에 있는 경우, 기본 /lib/systemd/system/mattermost.service systemd 유닛 파일을 편집하여 [Unit] 섹션에 After=postgresql.service 와 BindsTo=postgresql.service 를 추가하는 것을 권장합니다. 프록시 없이 Mattermost 실행 # Mattermost가 8065 대신 443에 바인딩됩니다. Mattermost 바이너리는 해당 바인딩을 위한 올바른 권한이 필요합니다. 다음 명령을 실행하여 새 Mattermost 바이너리가 1024보다 낮은 포트에 바인딩할 수 있도록 CAP_NET_BIND_SERVICE 기능을 활성화해야 합니다: sudo setcap cap_net_bind_service=+ep ./mattermost/bin/mattermost Note 동시 사용자가 200명 이하인 경우 Mattermost 서버 앞에 프록시를 사용하는 것을 강력히 권장합니다. 동시 사용자가 200명 미만이면 TLS를 설정 할 수 있습니다. 동시 사용자가 200명을 초과하면 트래픽을 관리하기 위해 Mattermost 앞에 NGINX와 같은 프록시 가 필요합니다. Mattermost 로그 검토 # Mattermost 로그에 접근하여 문제 해결에 사용할 수 있습니다. 이 단계는 적절한 시스템 관리자 권한 이 있다고 가정합니다. Mattermost 서버 로그 # 로그 파일이 생성되고 있는지 확인합니다: 시스템 콘솔 > 환경 > 로깅 으로 이동하여 파일에 로그 출력 이 true 로 설정되어 있는지 확인합니다. 시스템 콘솔 > 환경 > 로깅 > 파일 로그 디렉터리 에서 로그 파일 경로를 확인할 수 있습니다. 결과 서버 로그 파일은 mattermost.log 라고 하며 표준 텍스트 편집기로 열거나 직접 공유할 수 있습니다. Note 더 완전한 로그를 위해 시스템 콘솔 > 환경 > 로깅 을 열고 파일 로그 레벨 을 DEBUG 로 설정한 다음 문제를 다시 발생시켜 로그를 기록합니다. 디스크 공간을 절약하기 위해 문제 해결 후 파일 로그 레벨을 INFO 로 되돌려 놓으세요. 파일시스템 접근이 불가능한 경우 시스템 콘솔 > 보고 > 서버 로그 로 이동하여 파일로 복사할 수 있는 현재 시스템 로그를 찾으세요. 로깅 설정에 대한 자세한 내용은 여기 를 참조하세요. 로그 파일에 접근할 수 없음 # Mattermost v11.4부터 로그 파일 경로는 지정된 로깅 루트 디렉터리 내에 있는지 검증됩니다. 시스템 콘솔 > 보고 > 서버 로그 나 지원 패킷에 로그 파