사이트가 또 날아갔나
오늘 진짜 식겁했다.
오랜만에 접속한 워드프레스 사이트 – 그래 바로 지금 글을 쓰고 있는 이 사이트다 – 에 접속해서
살펴보다가, 오랜만에 접속했더니 플러그인 업데이트가 많이 떠있길래 플러그인 업데이트를 눌렀다.
그리고, 글을 쓰려고 오랜만에 접속한거라 마음이 급해서, 다 됐겠거니 하고
다른 메뉴를 눌렀다. 그랬더니 재로그인을 요청길래 아무생각없이 재로그인을 했는데,
그랬더니 웬걸. 다른 메뉴로 옮겨가지 않고 커다란 산 사진과 함께 이런 문구가 떴다.
“웹사이트가 정기 유지 관리 중입니다.
불편을 끼쳐드려 죄송합니다. 잠시 후 다시 방문해주세요.”
이건 내가 뭔 사이트 접속했을때 유지보수중이라 접속이 안될때 뜨는 화면인데,
참나 개인 블로그에서 이런 화면을보다니. 이게 바로 네이버나 티스토리랑 다른
워드프레스만의 다른점이구나. 진짜 사이트 관리하는 것 같네 라고 생각하고 기다렸다.
처음에는 기분이 좀 쎄했지만 별일없겠거니 하고 기다렸는데,
1~2분이 지나도 돌아오지 않았다.
처음에 1~2분이 지날때는 아 플러그인 업데이트중인가보다~ 업데이트가 완료되면 돌아오겠지 했는데
하지만 3분이 지나도, 5분이 지나도 화면은 그대로였다.
그때부터 진짜 불안해지기 시작했다.
- ‘망한 건가?’
- ‘DB 날아간 건가?’
- ‘테마 깨졌나?’
이런 생각들이 머릿속을 스쳤다.
안그래도 나는 일전에 다른 사이트를 관리를 소홀히했더니 무슨 스팸 공격을 받아서
티스토리 사이트가 통으로 날아가고 접속조차 할수없어서 서버호스팅을 새로 판 적이 있기에,
설마 이번에도 그런일인가 하며 진짜 식겁했다.
그렇지만 결론적으로는 별일 아니었고, 해결했고,
무사히 해결했기에 지금 이렇게 글을 쓸 수 있고, 심지어 어떻게 해결했고 뭐가 잘못이었는지
나의 그 경험담을 이렇게 적어내려가고 있다. 지금부터 내가 뭘 잘 못했고, 어떻게 해결하면되는지
내 경험담을 간략하고 알기쉽게 적어내려갈테니 나와 같은 문제에 마주친 분들에게 도움이 되었으면 좋겠다.
문제의 원인: 업데이트 도중 창을 닫았다
사실 이건 내 실수였다.
플러그인 업데이트 중에는 창을 닫거나 옮기면안되는데,
내가 그래버려서 중간에 멈춰버린 것이다.
구글링을 해보고 안 사실인데,
워드프레스가 플러그인이나 테마를 업데이트할 때는
잠깐 동안 사이트를 유지 관리 모드(maintenance mode) 로 전환한다.
그 상태에서 브라우저를 닫아버리면
워드프레스가 플러그인 업데이트가 끘났더라도 “이제 끝났어”라고 인식하지 못하고
계속 유지 모드 상태로 남아버린다.
결국 사이트가 정상적으로 돌아오지 못한 채 ‘정기 유지 관리 중’ 메시지를 무한히 띄우는 상태가 된 것이다.
원인 분석 : .maintenance 파일이 남아 있었다
구글링을 조금 해보니 답은 명확했다. 뭔가 업데이트 도중에 생성된
“업데이트중” 이라는 것을 표시하는 파일이남아있었기에 저 화면이 사라지지 않은 것이다.
업데이트중에 파일을 만들고, 업데이트가 종료되면 그 파일을 삭제하면서
저런 화면이 생기지않고 사이트로 연결되어야하는데,
내가 중간에 화면을 꺼버리면서 저 파일이 삭제되지 않고 남아있어서 그런것이다.
이것은 문과적인 설명이고, 이걸 조금 더 기술적인 살을 붙여 설명하면 이렇다.
- 워드프레스는 업데이트 중에 서버 루트 폴더에
.maintenance라는 파일을 잠시 만든다. - 이게 바로 “정기 유지관리 중입니다” 메시지를 띄우는 주범이다.
- 정상적으로 업데이트가 끝나면 이 파일은 자동으로 삭제된다.
- 그런데 내가 업데이트 도중 창을 닫아버리는 바람에 자동 삭제 과정이 중단된 것이고,
결국 이 파일 하나 때문에 사이트 전체가 멈춰 있었다.
그렇다면 생각해보면 이런 결론에 다다를 수 있다.
저, .maintenance 라는 파일만 지우면 되는것 아닌가? 라는 것이다.
결론부터 말하면 그게 맞다. 저 파일만 지우면 문제는 해결된다. 그런데 어떻게?
사이트가 멈춰있는데 대체 어떻게 지운다는 말인가?
사이트에 접속을 해야 지우든가 말든가할텐데 지금 사이트가 닫겨있지않은가?
복구 : 케미클라우드 cPanel에서 해결
지금 저 상태에처한 사람이라면, 아마도
https://도메인명/wp-admin 으로는 접근이 불가할 것이다. 나 역시 그랬으니까.
이때는, 자기가 가입한 서버 호스팅을 통해서 접속해야한다.
구글링을 하면서 처음에는 무슨말인지 몰랐는데,
결론부터 말하면 매우 쉽다. 그냥 따라하면된다.
나는 서버 호스팅을 케미클라우드(chemicloud)를 쓰고 있는데,
케미클라우드는 서버에만 접속하면, 워드프레스 관리를 어느정도 할 수 있는
컨트롤대시보드? 컨트롤박스를 제공하는데 그게 바로 cpanel이다.
SSH나 FTP 접속 없이도 cPanel 안에서 바로 해결할 수 있었다.
정리하면 다음과 같다.
케미클라우드 로그인
→ “My Services” → 해당 사이트 선택
→ “Login to cPanel” 클릭
File Manager(파일 관리자) 열기
→ 기본 경로인 /public_html 폴더로 이동
숨김파일 보기 활성화
→ 오른쪽 상단 “Settings” 클릭
→ “Show Hidden Files (dotfiles)” 체크
.maintenance 파일 삭제
→ 목록에서 .maintenance 파일 선택 후 Delete
→ “Skip Trash” 옵션 체크
브라우저 새로고침 (Ctrl + F5)
→ 기적처럼, 사이트가 바로 복구됐다.
복구 후 점검한 것들
사이트가 정상으로 돌아온 뒤 바로 관리자 페이지에 접속했다.https://thininfo.com/wp-admin
플러그인 탭으로 들어가 보니,
문제가 됐던 플러그인은 절반만 업데이트가 완료되어 있었다.
혹시 몰라 다시 수동으로 업데이트 버튼을 눌러서 마무리했고,
테마 캐시와 서버 캐시를 모두 지운 뒤 새로고침했다.
이제 완벽히 정상 작동.
이번 일을 통해 배운 교훈
이번 일은 정말 짧은 순간의 방심이 얼마나 큰 문제를 만들 수 있는지를 보여줬다.
플러그인 업데이트는 단순해 보이지만,
그 사이에 워드프레스는 잠시 사이트 전체를 멈추고 작업을 한다.
그때 창을 닫거나 브라우저가 끊기면,
“유지 관리 모드”가 그대로 남아 사이트 전체가 멈춘다.
이번 일을 계기로 다음 세 가지를 습관으로 삼기로 했다.
- 업데이트 완료 문구를 확인하기 전에는 절대 창을 닫지 않는다.
- 정기 백업을 켜둔다.
마지막 요약 정리 요약하자면
- 현상: “웹사이트가 정기 유지 관리 중입니다” 화면 고정
- 원인: 업데이트 중단으로
.maintenance파일이 남음 - 해결: cPanel → File Manager →
.maintenance삭제 - 교훈: 업데이트 중엔 절대 창 닫지 말기
마무리하며
처음 이 문구를 봤을 때 진짜 식은땀이 났다.
“사이트가 날아갔나?” 싶은 불안감은 겪어본 사람만 안다.
하지만 알고 보면 해결은 간단했다.
그냥 .maintenance 파일 하나 지우면 끝이었다.
이 경험을 글로 남기는 이유는 나처럼 괜히 식겁하는 사람이
이 글을 보고 단 5분 만에 해결할 수 있길 바라기 때문이다.
누군가가 올려놨던 블로그 글들이, 나의 문제를 해결하는데 도움을 줬던 것처럼
나 역시 인터넷의 정보의 바다에 나의 경험을 더해서 다른 누군가에게 도움이 될 수 있고자 한다.
보니까 IT쪽은 서로 이렇게 트러블슈팅 했던 경험을 공유하면서 서로서로 돕고 살아가더라.
