미디어위키/업그레이드

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

??? : 수정한 파일이 LocalSettings.php뿐이며, 현재 위키의 버전이 1.5 이상이라면, 업그레이드 과정은 매우 간단합니다.

 

개요

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

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

백업

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

Tux.svg  리눅스 환경에서 진행하였습니다.(모든 리눅스 작동함)


다만 WSL(WSL2) 환경에서는 확인되지 않았습니다.

위키가 설치된 경로는 '/var/www/html/w'이며, '도메인 루트 경로는 '/var/www/html', db는 'wiki'라는 db를 사용하는 Mysql이라고 가정한다.
[email protected]:~ # cd /var/www/
[email protected]:/var/www # tar cvfpz html.tar.gz html
[email protected]:/var/www # ls
html  html.tar.gz
[email protected]:/var/www # mysqldump -u root -p wiki > wiki.sql
[email protected]:/var/www # ls
html  html.tar.gz  wiki.sql
[email protected]:/var/www # mkdir backup
[email protected]:/var/www # mv html.tar.gz ./backup
[email protected]:/var/www # mv wiki.sql ./backup
[email protected]:/var/www # ls
backup  html

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

업그레이드

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

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

마이너 업그레이드

git으로 업그레이드

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

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

[email protected]:~ # cd /var/www/html/w
[email protected]:/var/www/html/w# git pull

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

새 버전으로 압축 해제

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

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

[email protected]:~ #co /var/www
[email protected]:/var/www # wget https://releases.wikimedia.org/mediawiki/1.35/mediawiki-1.35.1.zip
[email protected]:/var/www # ls
backup  html  mediawiki-1.35.1.zip
[email protected]:/var/www # mv mediawiki-1.35.1.zip m.zip
[email protected]:/var/www # unzip m.zip
[email protected]:/var/www # ls
backup  html  m.zip  mediawiki-1.35.1
[email protected]:/var/www # mv mediawiki-1.35.1 newwiki
[email protected]:/var/www # ls
backup  html  m.zip  newwiki

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

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

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

[email protected]:/var/www # cd newwiki
[email protected]:/var/www/newwiki # cp -r * ../html/w/
[email protected]:/var/www/newwiki # cd ../html/w/

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

update.php 실행

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

[email protected]:/var/www/html/w/ # cd maintenance
[email protected]:/var/www/html/w/maintenance # php update.php --quick

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

메이저 업그레이드

각주

  1. 예를 들어 1.35.0에서 1.35.1로 업그레이드
  2. 예를 들어 1.31.2에서 1.35.1로 업그레이드
  3. unzip이 설치되어 있지 않다면 우분투 apt install unzip를 입력하자
  4. 그냥 php update.php로 입력하면 5초 뒤 실행되기 때문에 --quick 명령어를 추가로 입력하여 즉시 실행되도록 한다.