안녕하세요.
사용자의 눈높이에 맞춘 이메일보안 지킴이 지란지니입니다.
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 postgres | DB(데이터베이스) 데몬 |
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)으로 언제든지 연락해 주시기 바랍니다.