#1. 설치 파일 다운로드
여러 종류의 self-hosted wiki툴이 있지만, dokuwiki를 선택한 이유는
1. 설치 서버가 windows - Linux 였다면 xWiki나 mattermost를 선택하지 않았을까?
2. 사내에서 이미 dokuwiki를 사용하고 있었음 - 이 이유가 가장 크다. 기존 wiki 문서를 보존해야 했기에
이제 아래의 파일들을 다운로드 받는다.
1. dokuwiki
Download DokuWiki
Here you can download the latest DokuWiki-Version. Either just click "Download" or customize the download to your likings with the options below. DokuWiki is available free of charge under the GNU General Public License Version 2. Start Download
download.dokuwiki.org
Stable 버전으로 다운받는다.(2023년 12월 7일 기준 2023-04-04a "Jack Jackrum")
아래쪽에 보면 Include Web-Server 버전으로도 다운로드 받을 수 있는데, 개인 사용 목적이면 나쁘지 않다.
다만, .bat 파일을 실행하여 창을 항상 켜 놓아야 작동 되기 때문에 본인은 Stable 버전으로 받아서 apache, php를 별도로 세팅하였다.
2. apache
Apache VS17 binaries and modules download (apachelounge.com)
Apache VS17 binaries and modules download
www.apachelounge.com
위 사이트에서 httpd-2.4.58-win64-VS17.zip 파일을 다운로드 받는다.(가장 최신)
페이지 상단에서 다음과 같은 메시지를 확인할 수 있는데,
Build with the latest Windows® Visual Studio C++ 2022 aka VS17
따라서 설치하려는 서버에 Microsoft Visual C++ 2015~2019 Redistributable(x64) 설치가 필요하다.(안그러면 오류가 발생한다.)
3. php
PHP For Windows: Binaries and sources Releases
PHP For Windows: Binaries and sources Releases
PHP 8.2 (8.2.13) Download source code [26.21MB] Download tests package (phpt) [15.65MB] VS16 x64 Non Thread Safe (2023-Nov-21 16:27:32) Zip [30.28MB] sha256: afa38d2f67ba6bab927b9a4a922a24f044d6f35f12e0df1b9d651d9ae6c8be50 Debug Pack [25.47MB] sha256: d061
windows.php.net
PHP 8.3.0 버전을 다운로드 받는다.
VS16 x64 Non Thread Safe 버전과 Thread Safe 버전이 있는데, apache web server에 사용하려면 Thread Safe 버전을 사용하라는 내용이 있어서 Thread Safe 버전으로 다운로드 한다.
#2. Apache Web Server설치
다운받은 zip파일(httpd-2.4.58-win64-VS17.zip)을 적당한 곳에 압축을 풀고,
Apache24 폴더를 원하는 경로로 이동시킨다.
D:\tools\Apache24
D:\tools\Apache24\conf\httpd.conf 파일을 열어서 다음 내용을 수정한다.
#
Define SRVROOT "D:/tools/Apache24"
ServerRoot "${SRVROOT}"
...
#
#Listen 12.34.56.78:80
Listen 9081
...
# If your host doesn't have a registered DNS name, enter its IP address here.
#
ServerName xxx.xxx.xxx.xxx:9081(서버 IP)
관리자권한으로 cmd를 열고 apache home/bin 으로 이동하여 다음 명령어로 apache를 서비스 등록한 후, 시작한다.
cd D:\tools\Apache24\bin
httpd.exe -k install
httpd.exe -k start
정상적으로 시작되었다면, 브라우저를 열고 localhost:9081(conf 파일에서 설정한 ip:port)로 접속해서 "It works!" 라는 화면이 보이면 설치가 완료된 것이다.
#3. PHP 설치
압축파일(php-8.3.0-Win32-vs16-x64.zip)을 풀고 적당한 곳에 위치시킨다. 본인은 Apache24 폴더 내에 두었다.
D:\tools\Apache24\php-8.3.0
php.ini-production 파일을 아래와 같은 수정한 후, 다른이름으로 저장(php.ini)한다.
; Directory in which the loadable extensions (modules) reside.
; https://php.net/extension-dir
;extension_dir = "./"
extension_dir = "D:/tools/Apache24/php-8.3.0/ext" << 수정
; On windows:
;extension_dir = "ext"
다시 D:\tools\Apache24\conf\httpd.conf 파일을 열어서 아래 내용을 추가한다.
...
<IfModule dir_module>
DirectoryIndex index.php index.html << index.php 추가
</IfModule>
...
PHPIniDir "D:/tools/Apache24/php-8.3.0"
LoadModule php_module "D:/tools/Apache24/php-8.3.0/php8apache2_4.dll"
AddType application/x-httpd-php .html .php
AddHandler application/x-httpd-php .php
#4. Dokuwiki 설치
압축파일(dokuwiki-xxxx.tgz)을 풀고, 폴더 째로 Apache 폴더 > htdocs로 이동한다.(dokuwiki 폴더를 wiki로 이름변경했다)
D:\tools\Apache24\htdocs\wiki
다시 D:\tools\Apache24\conf\httpd.conf 파일을 열어서 아래 내용을 수정한다.
...
#
DocumentRoot "${SRVROOT}/htdocs/wiki"
<Directory "${SRVROOT}/htdocs/wiki">이제 브라우저에서 localhost:9081/install.php 를 실행하면 dokuwiki 설치페이지가 나오고, 관리자 계정설정만 해주면 설치는 종료된다.
#5. 마무리
도쿠위키 홈페이지에 가서 마음에 드는 template을 설치하고(본인은 Bootstrap3 로 설치) 필요한 플러그인들을 받아서 설치한 후 사용하면 된다.
댓글