Kopano Dagent "스토리지 서버 연결 실패" 오류 해결 방법

Kopano에서 메일 전송 중 "저장소 서버에 연결하지 못했습니다" 라는 오류 메시지가 표시되면 , 전송 에이전트(dagent)가 지정된 Kopano 서버 엔드포인트에 연결할 수 없었던 것입니다. 이 메시지만으로는 서버 중지, 잘못된 소켓 경로, 접근 권한 문제 또는 원격 연결 문제 등 원인을 파악할 수 없습니다. 먼저 구성된 엔드포인트와 서버 자체를 확인하십시오. 연결 실패를 진단하는 동안에는 사서함 데이터나 첨부 파일 저장소를 변경하지 마십시오.

Kopano 관리자 문서에서는 dagent를 메일 전송 에이전트(MTA)에서 Kopano 사용자에게 메일을 전달하는 구성 요소로 설명합니다. Kopano Core 8.0 구성 참조에서는 server_socketKopano 서버와의 연결을 지정하고 file:///var/run/kopano/server.sock기본값으로 설명합니다. 패키지 버전, 서비스 관리자 및 로컬 구성은 다를 수 있으므로 예제를 적용하기 전에 호스트에서 값을 확인하십시오.

무엇을 먼저 확인해야 할까요?

오류가 모든 수신자에게 영향을 미치는지 아니면 특정 전달 경로에만 영향을 미치는지 확인하십시오. 모든 수신 전송이 동시에 실패하는 경우 서버 가용성과 엔드포인트를 확인하십시오. 특정 호스트 또는 노드를 통해 전송되는 메시지만 실패하는 경우 해당 노드 dagent.cfg와 네트워크 경로를 정상 작동하는 노드와 비교하십시오. 테스트하는 동안 실패한 메시지 또는 큐 항목을 보존하십시오. 반복적인 재시도로 인해 로그에서 유용한 첫 번째 타임스탬프가 가려질 수 있습니다.

systemd를 사용하는 시스템에서는 Kopano 유닛과 서버 로그를 배송 시간 전후로 검사하십시오.

systemctl list-units 'kopano*'
systemctl status kopano-server --no-pager
journalctl -u kopano-server -b --no-pager

패키지에서 유닛 이름이 다르게 지정되어 있는 경우, 에 표시된 유닛 이름을 사용하십시오 list-units. 서버가 비활성화되었거나 반복적으로 재시작되는 경우 서버 측 문제일 가능성이 높습니다. 서버 저널을 확인하여 이전 시작, 데이터베이스, 구성 또는 스토리지 오류를 찾아보십시오. dagent를 재시작해도 Kopano 서버를 사용할 수 없는 문제는 해결되지 않습니다. 관리자 설명서에는 Kopano 서비스 관리에 대한 내용이 나와 있지만, 정확한 유닛 이름은 패키지에 따라 다릅니다.

dagent가 올바른 서버 소켓을 가리키고 있습니까?

일반적으로 .txt 파일인 활성 구성 파일을 읽고 다음 항목 /etc/kopano/dagent.cfg을 찾으십시오 server_socket.

grep -nE '^[[:space:]]*server_socket[[:space:]]*=' /etc/kopano/dagent.cfg

로컬 Unix 소켓의 경우, 실행 중인 서버에서 실제로 생성된 소켓의 설정값과 비교하십시오. Kopano Core 문서에 나와 있는 일반적인 값은 다음과 같습니다.

server_socket = file:///var/run/kopano/server.sock

파일이 존재하고 소켓 파일인지 확인하십시오.

ls -l /var/run/kopano/server.sock
test -S /var/run/kopano/server.sock && echo "Socket exists"

구성된 경로와 실제 경로가 다른 경우, server_socket설치 환경에서 의도적으로 사용하는 엔드포인트 값으로 수정하십시오. 서버가 다른 런타임 디렉터리, 클러스터 주소 또는 원격 전송을 사용하도록 구성된 경우 기본값을 그대로 복사하지 마십시오. Kopano 참조 문서에는 HTTPS 전송에 대한 SSL 키 설정도 설명되어 있습니다. 원격 엔드포인트 구문 및 인증서 요구 사항은 설치된 서버 구성과 일치해야 합니다.

소켓 권한 때문에 연결이 차단될 수 있을까요?

예. 소켓이 존재하더라도 dagent를 실행하는 사용자가 접근할 수 없을 수 있습니다. 관련 서비스 단위 또는 프로세스에서 실제 프로세스 사용자를 찾은 다음 소켓과 모든 상위 디렉터리를 검사하십시오. 예를 들면 다음과 같습니다.

namei -l /var/run/kopano/server.sock
stat -c '%A %U:%G %n' /var/run/kopano/server.sock

소유자, 그룹 및 디렉터리 탐색 권한을 dagent의 런타임 ID와 비교하십시오. Kopano dagent 구성 참조에 따르면 실행 사용자 및 그룹을 구성할 수 있으며 Kopano가 기본값으로 명시되어 있지만 패키징 또는 재정의로 인해 변경될 수 있습니다. systemd를 사용하는 경우 소유권을 변경하기 전에 유닛 및 모든 재정의 설정을 검토하십시오.

systemctl cat kopano-dagent
systemctl show kopano-dagent -p User -p Group

의도한 서비스 계정에 필요한 접근 권한만 부여하도록 권한을 조정하십시오. chmod 777소켓이나 해당 디렉터리에 권한을 직접 적용하지 마십시오. 권한 있는 서비스 엔드포인트가 관련 없는 로컬 사용자에게 노출될 수 있습니다. 런타임 디렉터리는 부팅 시 다시 생성될 수 있으므로, 임시적인 수동 권한 변경에 의존하기보다는 해당 디렉터리를 생성하는 서비스 또는 패키지 구성을 수정하십시오.

서버가 다른 노드에 있다면 어떻게 될까요?

다중 서버 또는 고가용성 구성에서 dagent가 해당 노드에 대해 접근 가능한 클러스터 또는 서버 주소를 사용하고 있는지 확인하십시오. Kopano 고가용성 가이드에 따르면 서비스 엔드포인트와 Postfix 전달 라우팅은 노드 간에 조정되어야 합니다. server_socket양쪽의 서버 리스너, DNS 또는 클러스터 주소, 방화벽 규칙 및 TLS 설정을 비교하십시오. 한 노드의 로컬 소켓에 성공적으로 연결되었다고 해서 다른 노드에서 원격 엔드포인트에 접근할 수 있다는 것을 보장하는 것은 아닙니다.

dagent에 구성된 동일한 엔드포인트 및 네트워크 경로를 사용하여 연결을 테스트하십시오. 원격 전송의 경우 Kopano 호스트에서 리스너 상태와 방화벽 정책을 확인한 다음 dagent 및 서버 로그에서 연결 거부, 시간 초과 또는 TLS 오류를 검사하십시오. 문제 해결을 위한 지름길로 인터넷에 리스너를 광범위하게 개방하지 마십시오. 신뢰할 수 있는 메일 및 애플리케이션 호스트로 액세스를 제한하십시오.

운영 중인 메일 흐름을 변경하지 않고 배송 테스트를 하려면 어떻게 해야 할까요?

서버가 활성화되고 엔드포인트와 권한이 일치하면 지정된 테스트 사서함을 사용하여 제어된 테스트를 수행합니다. Kopano 관리자 설명서에는 해당 노드의 사용자로 dagent를 직접 호출한 다음 제목과 메시지 본문을 입력하는 방법이 설명되어 있습니다. 기본적인 테스트 패턴은 다음과 같습니다.

kopano-dagent -v -c /etc/kopano/dagent.cfg testuser
Subject: Kopano connection test

This is a controlled delivery test.
[Press Ctrl-D to finish input]

기존 로컬 Kopano 사용자로 교체 testuser하고 설치된 버전의 명령 구문을 따르십시오. 이 테스트는 일부 MTA 라우팅 및 큐 동작을 우회합니다. 직접 전달이 성공하면 경로의 유용한 부분이 검증되지만 Postfix 또는 다른 MTA가 메일을 올바르게 라우팅한다는 것을 증명하는 것은 아닙니다. 대기 중인 프로덕션 메시지를 다시 시도하기 전에 dagent 출력, Kopano 로그 및 테스트 사서함을 확인하십시오.

서비스를 언제 재시작해야 하나요?

구성이 변경된 구성 요소만 다시 시작하고, 다시 시작하기 전에 해당 구성의 정상적인 복사본을 저장해 두십시오. 설정을 변경한 경우 dagent.cfg, 설치 환경에서 dagent가 영구 서비스로 실행되는 경우 해당 dagent 유닛을 다시 시작하십시오. 일부 설치 환경에서는 개별 배포 시 dagent가 실행되므로, 다시 시작해야 할 장기 실행 dagent 유닛이 없을 수도 있습니다. server.cfg또는 서버 리스너 설정을 변경한 경우, Kopano Server에 대한 사이트의 변경 절차를 따르십시오. dagent 참조 문서에서는 HUP를 통해 다시 로드할 수 있는 옵션으로 일부만 설명하고 있으므로, 모든 소켓 또는 런타임 ID 변경 사항이 신호를 통해 적용된다고 가정하지 마십시오.

수정이 완료되었는지 어떻게 확인할 수 있나요?

사건을 종결하기 전에 다음 사항을 모두 확인하십시오.

• Kopano 서버는 새로운 연결 관련 오류 없이 계속 활성 상태를 유지하고 있습니다.
• dagent에 구성된 엔드포인트는 활성 소켓 또는 의도된 원격 수신자와 일치합니다.
• dagent 런타임 사용자는 소켓의 상위 디렉터리를 탐색하여 엔드포인트에 접근할 수 있습니다.
• 제어된 테스트 메시지가 의도된 사서함에 도달했으며, 로그에는 스토리지 서버 연결 오류가 표시되지 않았습니다.
• 일반 MTA 경로를 통해 전송된 새로운 수신 메시지가 수락되어 전달됩니다. 따라서 MTA 큐에 동일한 오류가 계속 누적되지 않습니다.

직접 배송은 성공하지만 MTA를 통한 메일 전송이 여전히 실패하는 경우, Kopano 사서함 저장소를 변경하기보다는 MTA의 LMTP 전송, 소켓 경로 및 라우팅을 조사하십시오. 서버와 엔드포인트에 문제가 없는데도 dagent에서 연결 실패가 계속 보고되는 경우, 해당 타임스탬프, 익명 처리된 server_socket값, 서비스 상태 및 관련 로그를 수집하여 패키지 관리자 또는 Kopano 관리자에게 제공하십시오. 진단 정보를 공유하기 전에 암호, 개인 키, 메시지 내용 및 개인 주소는 삭제하십시오.

참고 자료: Kopano 코어 관리자 설명서 , Kopano 에이전트 구성 참조 , Kopano 고가용성 가이드 , Kopano 특수 구성 및 문제 해결 .