미디어위키/업그레이드

미디어위키
스킨	미디어위키/확장기능
업그레이드	위키 문법

-
“	??? : 수정한 파일이 LocalSettings.php뿐이며, 현재 위키의 버전이 1.5 이상이라면, 업그레이드 과정은 매우 간단합니다.	”
	— 미디어위키 공식 홈페이지 업그레이드 문서 중

개요

미디어위키를 업그레이드를 하는데 있어 타 CMS들보다 어렵기 때문에, 본 문서를 통해서 따라 할 수 있도록 하자.

특히 버전에 맞는 확장기능으로 대체해야 하기 때문에 번거로운 점이 있다.

백업

모든 작업들도 마찬가지로, 백업을 하고 하자. 그저 용량만 차지하는 존재라고 생각하지 말고, 혹시 모를 사태에 대비하자.

리눅스 환경에서 진행하였습니다.(모든 리눅스 작동함) 다만 WSL(WSL2) 환경에서는 확인되지 않았습니다.

위키가 설치된 경로는 '/var/www/html/w'이며, '도메인 루트 경로는 '/var/www/html', db는 'wiki'라는 db를 사용하는 Mysql이라고 가정한다.

root@gaon:~ # cd /var/www/
root@gaon:/var/www # tar cvfpz html.tar.gz html
root@gaon:/var/www # ls
html  html.tar.gz
root@gaon:/var/www # mysqldump -u root -p wiki > wiki.sql
root@gaon:/var/www # ls
html  html.tar.gz  wiki.sql
root@gaon:/var/www # mkdir backup
root@gaon:/var/www # mv html.tar.gz ./backup
root@gaon:/var/www # mv wiki.sql ./backup
root@gaon:/var/www # ls
backup  html

/var/www에 있는 html 폴더를 tar.gz 방식으로 압축(퍼미션 동일 옵션)하여 html.tar.gz로 저장하고, wiki.sql로 db를 백업 후 backup 폴더에 이동시켰다.

업그레이드

이후 최신버전의 미디어위키를 다운로드를 한다.

마이너 업그레이드와 메이저 업그레이드의 업그레이드 방법에 있어서 차이가 있다. 따라서 본 문서에서는 둘을 분리하여 설명한다.

마이너 업그레이드

git으로 업그레이드

이 경우에는 git으로 미디어위키를 설치 한 경우에만 해당한다.

미디어위키가 설치되어 있는 루트 폴더로 이동 후, 다음과 같은 명령어를 입력한다.

root@gaon:~ # cd /var/www/html/w
root@gaon:/var/www/html/w# git pull

이후 update.php 실행 문단으로 이동해 update.php를 실행한다.

새 버전으로 압축 해제

마이너 업그레이드는 간단한 편인다. 최신버전으로 덮어씌우면 된다. 여기서는 1.35.0에서 1.35.1로 업그레이드를 한다고 가정한다.

update.php만 돌려도 되지만, 혹시 모를 파일 누락을 위해 새 파일로 덮어 씌우고 update.php를 실행하는 것이다.

root@gaon:~ #co /var/www
root@gaon:/var/www # wget https://releases.wikimedia.org/mediawiki/1.35/mediawiki-1.35.1.zip
root@gaon:/var/www # ls
backup  html  mediawiki-1.35.1.zip
root@gaon:/var/www # mv mediawiki-1.35.1.zip m.zip
root@gaon:/var/www # unzip m.zip
root@gaon:/var/www # ls
backup  html  m.zip  mediawiki-1.35.1
root@gaon:/var/www # mv mediawiki-1.35.1 newwiki
root@gaon:/var/www # ls
backup  html  m.zip  newwiki

미디어위키 공식 홈페이지에서 미디어위키 1.35.1 버전의 다운로드 주소를 사용하여 다운로드한다.

이후 편의를 위해 압축 파일명을 바꾸고(선택사항), 압축해제한다.

압축해제된 폴더명(mediawiki-1.35.1)을 편의상 newwiki(선택사항)으로 바꾼다.

root@gaon:/var/www # cd newwiki
root@gaon:/var/www/newwiki # cp -r * ../html/w/
root@gaon:/var/www/newwiki # cd ../html/w/

압축해제한 폴더 newwiki로 이동 후, 모든 파일을 /var/www/html/w/로 복사 덮어쓰기한다.

update.php 실행

모든 업그레이드 작업의 마무리는 update.php를 실행하는 것이다.

root@gaon:/var/www/html/w/ # cd maintenance
root@gaon:/var/www/html/w/maintenance # php update.php --quick

이후 위키가 설치된 폴더(/var/www/html/w/)로 이동 후 maintenance 폴더로 이동하여 update.php 스크립트를 실행한다.