머드픽스 서비스 재기동 가이드

  • 업데이트 시간

안녕하세요. 
사용자의 눈높이에 맞춘 이메일보안 지킴이 지란지니입니다.

1. 개요

서버 재부팅, 서비스 수동 기동·종료, 프로세스 상태 확인, 장애 로그 조회 등 서버 운영에 필요한 기본 절차를 
안내합니다. 
본 가이드를 참고하여 장애 발생 시 신속하게 대응하시기 바랍니다.

2. 사전 확인 사항

  • 모든 명령어는 root 계정으로 실행합니다.
  • 서비스 수동 기동 시에는 반드시 컨테이너(Docker) 내부로 접속한 후 진행합니다.
  • 서버 종료(shutdown) 후에는 서버 전원을 다시 켜야 서비스가 기동되므로, 재부팅과 종료를 혼동하지 않도록 주의하시기 바랍니다.

3. 상세 설정 단계

3-1. 서버 재부팅 및 종료

서버를 재부팅하면 관련 서비스가 자동으로 기동됩니다. 
별도의 수동 기동 작업은 필요하지 않습니다.

[재부팅]

 
bash
reboot

[완전 종료]

 
bash
shutdown -h now

⚠️ 주의: 종료(shutdown) 명령어 실행 후에는 서버 전원을 수동으로 켜야 서비스가 기동됩니다.

3-2. 서비스 수동 기동

서비스를 수동으로 기동할 때는 아래 두 단계를 순서대로 진행합니다.

1단계 — 컨테이너 접속

root 계정으로 아래 명령어를 실행하여 컨테이너 내부로 접속합니다.

 
bash
docker exec -it mb1 /bin/bash

2단계 — 서비스 기동 스크립트 실행

컨테이너 내부에서 아래 명령어를 실행합니다.

 
bash
/MUDFIX/bin/startmudfix.sh

 

3-3. 서비스 수동 수행 및 종료

컨테이너 내부에서 개별 서비스를 직접 제어할 수 있습니다. 아래 명령어를 순서대로 실행합니다.

[서비스 수행]

 
bash
service nginx start
service mudfix-celerybeat start
service mudfix-celeryd start
service postgresql start

[서비스 종료]

 
bash
service nginx stop
service mudfix-celerybeat stop
service mudfix-celeryd stop
service postgresql stop

4. 정상 작동 확인 및 주의사항

4-1. 프로세스 정상 기동 여부 확인

서비스 기동 후 아래 5개 프로세스가 모두 실행 중인지 확인합니다. 
하나라도 조회되지 않을 경우 [3-2. 서비스 수동 기동] 절차를 다시 수행합니다.

확인 명령어프로세스 역할
ps -ef | grep nginx웹 서비스 데몬
ps -ef | grep gunicorn웹 WSGI(웹 애플리케이션 인터페이스) 데몬
ps -ef | grep celery훈련메일 작성 및 수행 데몬
ps -ef | grep celerybeat스케줄링 데몬
ps -ef | grep postgresDB(데이터베이스) 데몬

4-2. 장애 발생 시 로그 확인

증상에 따라 아래 로그 파일 경로를 참고하여 원인을 확인합니다.

증상로그 파일 경로
웹 페이지 접속 오류/var/log/nginx/error.log
메일 발송·수신 오류/var/log/mail.log
DB 관련 오류/var/log/postgresql/postgresql-10-main.log
훈련메일 스케줄 오류/var/log/mudfix-celery/beat.log
훈련메일 작업 처리 오류/var/log/mudfix-celery/celeryd-worker.log

로그 확인 방법:

  • 일반 조회: vi [로그 파일 경로]
  • 실시간 모니터링: tail -f [로그 파일 경로]

추가 문의 사항이 있으시면 기술지원팀(1600-8300)으로 언제든지 연락해 주시기 바랍니다.

관련 문서