일반 배포 문제 해결

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명을 초과하는 경우에는 트래픽 관리를 위해 NGINX와 같은 프록시 가 필요합니다. Mattermost 로그 검토 # Mattermost 로그에 접근하여 문제 해결에 활용할 수 있습니다. 이 절차는 적절한 시스템 관리자 권한 이 있다고 가정합니다. Mattermost 서버 로그 # 로그 파일이 생성되고 있는지 확인: 시스템 콘솔 > 환경 > 로깅 으로 이동하여 파일에 로그 출력 이 true 로 설정되어 있는지 확인합니다. 로그 파일 경로는 시스템 콘솔 > 환경 > 로깅 > 파일 로그 디렉토리 에서 확인할 수 있습니다. 결과 서버 로그 파일은 mattermost.log 로 저장되며 일반 텍스트 편집기로 열거나 직접 공유할 수 있습니다. Note 더 완전한 로그를 얻으려면 시스템 콘솔 > 환경 > 로깅 을 열고 파일 로그 레벨 을 DEBUG 로 설정한 후 문제를 다시 재현하여 다시 로그를 남기세요. 디스크 공간 절약을 위해 문제 해결 후 파일 로그 레벨을 반드시 INFO 로 되돌리세요. 파일 시스템 접근이 불가능한 경우 시스템 콘솔 > 보고 > 서버 로그 로 이동하면 현재 시스템 로그를 확인할 수 있으며 파일로 복사할 수 있습니다. 로깅 설정에 대한 자세한 내용은 여기 에서 확인하세요. 로그 파일에 접근 불가 # Mattermost v11.4부터 로그 파일 경로는 지정된 로깅 루트 디렉토리 내에 유지되는지 검증됩니다. 시스템 콘솔 > 보고 > 서버 로그 또는