데비안 리눅스 업데이트 후 워드프레스 DB 오류 해결기

Step 1. MariaDB 서비스 상태 확인

일단 DB와 관련된 문제인 것은 확실하니 DB가 돌고 있는지부터 확인해 보는 게 순서다.

eqmaker@debianmc:~$ sudo systemctl status mariadb --no-pager -l
× mariadb.service - MariaDB 10.11.14 database server
	 Loaded: loaded (/lib/systemd/system/mariadb.service; enabled; preset: enabled)
	 Active: failed (Result: exit-code)
	 (... 중략 ...)
   Main PID: 744 (code=exited, status=7)
	 Status: "MariaDB server is down"
	 (... 생략 ...)

Active: failed, Status: “MariaDB server is down”가 보인다. MariaDB 서비스가 제대로 실행되지 않았다는 의미다.

왜인지 몰라도 실행되지 않은 상태라면 일단 다시 한번 수동으로 실행해 보면 문제가 해결될 수도 있겠다. 수동으로 DB를 재실행해 보았다.

eqmaker@debianmc:~$ sudo systemctl start mariadb
Job for mariadb.service failed because the control process exited with error code.
See "systemctl status mariadb.service" and "journalctl -xeu mariadb.service" for details.

하지만 실행되지 않는다. 실행 메시지에 control process exited with error code가 출력된다는 것은 단순히 서비스가 정지해 있었던 것이 아니다.

즉, MariaDB 실행 과정에서 뭔가 에러가 발생해 실행에 실패했다는 소리다.

Step 2. MariaDB 오류 로그 확인

서비스 시작이 실패했다면 뭔가 기록이 남아 있을 것이다. 정확한 원인을 확인하기 위해 systemd 저널을 확인했다.

확인 결과 로그에는 다음과 같은 오류가 반복적으로 나타나고 있었다. (실제 로그에서 반복 부분을 정리함)

[ERROR] mariadbd: Can't open shared library 'provider_bzip2.so' (errno: 8, API version for DAEMON plugin provider_bzip2 not supported by this version of the server)
[ERROR] Couldn't load plugins from 'provider_bzip2.so'.
[ERROR] mariadbd: Can't open shared library 'provider_lz4.so' (errno: 8, API version for DAEMON plugin provider_lz4 not supported by this version of the server)
[ERROR] Couldn't load plugins from 'provider_lz4.so'.
[ERROR] mariadbd: Can't open shared library 'provider_lzma.so' (errno: 8, API version for DAEMON plugin provider_lzma not supported by this version of the server)
[ERROR] Couldn't load plugins from 'provider_lzma.so'.
[ERROR] mariadbd: Can't open shared library 'provider_lzo.so' (errno: 8, API version for DAEMON plugin provider_lzo not supported by this version of the server)
[ERROR] Couldn't load plugins from 'provider_lzo.so'.
[ERROR] mariadbd: Can't open shared library 'provider_snappy.so' (errno: 8, API version for DAEMON plugin provider_snappy not supported by this version of the server)
[ERROR] Couldn't load plugins from 'provider_snappy.so'.
[ERROR] /usr/sbin/mariadbd: unknown variable 'provider_bzip2=force_plus_permanent'
[ERROR] /usr/sbin/mariadbd: unknown variable 'provider_lz4=force_plus_permanent'
[ERROR] /usr/sbin/mariadbd: unknown variable 'provider_lzma=force_plus_permanent'
[ERROR] /usr/sbin/mariadbd: unknown variable 'provider_lzo=force_plus_permanent'
[ERROR] /usr/sbin/mariadbd: unknown variable 'provider_snappy=force_plus_permanent'
[ERROR] Aborting
mariadb.service: Main process exited, code=exited, status=7/NOTRUNNING
mariadb.service: Failed with result 'exit-code'.
Failed to start mariadb.service - MariaDB 10.11.14 database server.

여기에서 가장 중요한 내용은 다음의 문구이다.

API version for DAEMON plugin ... not supported by this version of the server

즉, MariaDB가 압축 플러그인을 불러오려고 했지만, 플러그인의 인터페이스가 현재 실행 중인 MariaDB 서버와 호환되지 않는다는 소리다.

장애 원인 – MariaDB 서버와 압축 플러그인의 버전 불일치

문제의 원인은 앞서서 진행한 업데이트 기록에서 확인할 수 있었다. 기록을 다시 살펴보니 앞서 PHP2Shell 취약점 패치를 위해 sudo apt-get upgrade를 실행했을 때 MariaDB 관련 패키지 일부가 업그레이드 대상에서 보류되었다.

The following packages have been kept back:
mariadb-client
mariadb-client-core
mariadb-server
mariadb-server-core

반면 MariaDB 압축 플러그인은 정상 업데이트되었다. 결국 MariaDB 서버 자체는 기존 버전인 10.11.14인데, 플러그인은 10.11.19가 되어 호환성에 문제가 발생한 것이다.

MariaDB의 압축 플러그인은 서버 내부 인터페이스를 이용해 동작한다. 따라서 서버와 플러그인의 버전이 호환되지 않으면 플러그인을 정상적으로 불러오지 못할 수 있는데, 실행 과정에 플러그인을 필수적으로 로드하도록 되어 있었기 때문에, 플러그인을 못 읽어와 MariaDB 자체가 실행되지 못한 것이다.

한마디로, 프로그램 본체는 구버전인데, 추가 기능만 신버전으로 바뀌면서 서로 호환되지 않게 된 상황이 벌어진 것이다.

DB는 멀쩡한가?

다행히 InnoDB 버퍼 풀 초기화와 트랜잭션 로그 확인 과정은 정상적으로 진행된 기록이 남아 있었다. 마지막 서버 종료 기록에서도 InnoDB는 정상적으로 종료되었다.

즉, 최소한 로그상으로는 데이터베이스 파일이 손상된 것 같지는 않아 보인다!! 하지만 확실한 것은 복구를 다 끝내 놓고 봐야 한다.

1. MariaDB 업데이트 시뮬레이션

   먼저 실제 패키지를 변경하지 않고 -s 옵션을 이용해 업데이트 결과를 시뮬레이션해 본다.

   eqmaker@debianmc:~$ sudo apt-get -s install mariadb-server mariadb-server-core mariadb-client mariadb-client-core
   Reading package lists... Done
   Building dependency tree... Done
   Reading state information... Done
   (... 중략 ...)
   The following additional packages will be installed:
     libaio1
   The following NEW packages will be installed:
     libaio1
   The following packages will be upgraded:
     mariadb-client mariadb-client-core mariadb-server mariadb-server-core
   4 upgraded, 1 newly installed, 0 to remove and 9 not upgraded.
   (... 중략 ...)
   Inst mariadb-server [1:10.11.14-0+deb12u2] (1:10.11.19-0+deb12u1 Debian-Security:12/oldstable-security [amd64]) []
   Inst mariadb-server-core [1:10.11.14-0+deb12u2] (1:10.11.19-0+deb12u1 Debian-Security:12/oldstable-security [amd64]) []
   Inst mariadb-client-core [1:10.11.14-0+deb12u2] (1:10.11.19-0+deb12u1 Debian-Security:12/oldstable-security [amd64]) []
   Inst mariadb-client [1:10.11.14-0+deb12u2] (1:10.11.19-0+deb12u1 Debian-Security:12/oldstable-security [amd64])
   (... 생략 ...)

   MariaDB 관련 패키지 4개가 10.11.14에서 10.11.19로 업데이트될 것이라는 결과가 나왔다. 로그에서 본 것처럼 저 4놈이 업데이트에서 빠져 이 난리를 일으킨 것이다.

2. MariaDB 패키지 업데이트

   시뮬레이션 결과를 확인했으니 실제 업데이트를 실행한다.

   sudo apt-get install mariadb-server mariadb-server-core mariadb-client mariadb-client-core

   기존 데이터베이스를 초기화하지 않고 MariaDB 서버와 클라이언트 패키지를 업데이트한다.

3. MariaDB 서비스 상태 확인

   업데이트 후 MariaDB 서비스가 정상적으로 실행되는지 확인한다.

   sudo systemctl status mariadb --no-pager -l

   정상적으로 실행 중이라면 Active: active (running)이 표시된다. 만약 자동으로 시작되지 않았다면 다음 명령을 이용해 수동으로 시작해 준다.

   sudo systemctl start mariadb

4. 워드프레스 접속 확인

   MariaDB 업데이트가 끝난 뒤 다시 워드프레스에 접속해 서비스 상태를 확인한다.

   

   정상적으로 접속된다! 데이터베이스 연결 오류가 사라지고 홈페이지가 다시 표시되었다!