xwiki的安裝(tomcat+mysql)
阿斯頓
總述
xwiki是一個基於Java編寫的開源企業級的wiki,支援部落格,群組管理,許可權管理等功能,下面介紹如何安裝xwiki,適合在linux或者window上執行,安裝分為Servlet容器的安裝、Mysql的安裝,Xwiki的安裝及配置。這裡用的各個版本如下:
tomcat: apache-tomcat 9 (https://tomcat.apache.org/download-90.cgi)
mysql: MySQL Community Server 8.0.21
Xwiki: xwiki-platform-distribution-war-11.10.10 (https://www.xwiki.org/xwiki/bin/view/Download/DownloadVersion/?projectVersion=11.10.10, 下載production intallation)
(由於xwiki是Java寫的,故需要安裝java環境,在此假設已經擁有了java環境,至少為1.8,網上有很多Java環境安裝的部落格,在此不來累贅)
Tomcat的安裝
Xwiki需要的只是一個Servlet容器,而Servlet容器包括Tomcat, Jetty, JBoss等很多種,在這用個人比較熟悉的Tomcat作為Servlet容器。通過上面的下載連結下載好tomcat的,直接解壓完成後就可以用了,啟動之後輸入localhost:8080測試安裝是否成功,若看到了Tomat的主頁則說明安裝成功了。由於tomcat預設啟動的堆大小無法滿足xwiki的需要,故需調整tomcat堆大小
MySQL的安裝
MySQL的安裝網上也有很多說明,在此也不再細說,假如安裝好了mysql之後,需要建立一個xwiki名的資料庫,因為xwiki預設資料庫名字為xwiki
Xwiki的安裝
從上面附屬的連結下載好對應的xwiki的war檔案之後,假設tomcat安裝在{tomcat_home}中,則在{tomcat_home}/webapps/目錄中新建一個叫xwiki的目錄,然後將xwiki的war檔案解壓到xwiki的目錄下,至此,所需要的各種軟體基本準備完成,下面就介紹相關的配置。
Xwiki的配置
tomcat的配置
上面提到tomcat的配置主要是堆記憶體的配置,官方推薦分配給xwiki的堆記憶體最小的是1024m,最好為2048m, 配置tomcat的堆記憶體在{tomcat_home}/bin/catalina.bat,設定命令 為:
效果如下圖所示:
如果是linux則是catalina.sh中設定,設定命令為:
JAVA_OPTS= -Xms2048M -Xms2048M -XX:PermSize=256M -XX:MaxNewSize=256M -XX:MaxPermSize=256M
配置xwiki連線資料庫資訊
xwiki連線資料庫的資訊是在{tomcat_home}/webapps/xwiki/WEB-INF/hibernate.cfg.xml中配置,配置資訊如下:
在這裡請將使用者名稱和密碼以及mysql的埠號更改成為你對應的內容。
由於tomcat本身沒有連線mysql資料庫的驅動,故需要將mysql連線資料的驅動放在{tomcat_home}/lib中,這一步從mysql安裝目錄的Connector J 8.0目錄中找到mysql-connector-java-8.0.21.jar並複製到{tomcat_home}/lib中即可
配置xwiki永久目錄
xwiki的資料分為兩部分,一部分是頁面資料,存在mysql資料中,另一部分資料是頁面中附件或者較大的檔案,存放在檔案系統中,如果沒有配置的話,則預設是在{tomcat_home}/webapps/xwiki/data裡面,最好還是更改其位置好點,設定在{tomcat_home}/webapps/xwiki/WEB-INF/xwiki.properties中配置,設定如下:
可以自己設定一個目錄,方便以後的備份以及移植啥的
xwiki啟動
至此,已完成xwiki安裝的所有準備,此時就可以啟動tomcat, 進入{tomcat_home}/bin目錄,啟動tomcat,然後在瀏覽器上輸入localhost:8080/xwiki即可訪問xwiki, 第一次訪問,xwiki載入需要一小會,請耐心等待!最後看到這個頁面就說明安裝成功了!