Java開源知識庫:XWiki安裝(Windows平臺)
準備安裝XWiki,看了一下有三種安裝方式:
XWiki is a Java-based wiki and runs on a Servlet Container such as Tomcat, Jetty, JBoss, WebLogic, WebSphere, etc. It also uses a relational database to store its content. It can run on almost any database (HSQL, MySQL, etc) but XWiki and the database need to be setup correctly.
There are 3 ways of installing XWiki:
- Use the which already packages a Servlet Container (Jetty) and a database (HSQL). This is the recommended option for first time XWiki users and for users who wish to quickly try out XWiki.
- Use the and configure both your container and your database to work with it.
- Use the to install the last version of XWiki and the dependencies.
目標機需要滿足以下條件:
- Java 6 or greater installed.
- A Servlet Container supporting Servlet 2.4.
- Check the for the version you're installing to see what browsers and databases are supported for it. You can also check our .
(一)第一種方式:
我採用的第一種安裝方式是獨立執行的版本安裝,包括exe安裝,jar安裝,或者zip解壓的方式,可直接執行,方便想要快速用起來xwiki的人,比如下面是exe方式安裝步驟:
採用最簡單的windows的exe版本安裝:
3、啟動start_xwiki.bat;
5、Admin/admin登入
6、開啟管理wiki介面,點選Localization,在預設語言欄中獎en改為zh,儲存即切換為中文了。
問題:
但是我在win8系統上按照這個步驟一點問題都沒有,XWiki還執行非常良好!!!
但是當我在win7和win Server2008上面安裝exe版本的時候,到最後一步,點選next出現空白wizard,就再也不前進了,然後啟動不了xwiki,安裝解壓版的(zip)也是,解壓了之後,點選start.bat也是啟動不了,出現一個異常然後控制檯介面消失,都看不到是什麼異常。。。 網上有人出現這個問題,xwiki作者回答的是新版本不會有這個問題,但是我裝的是最新的版本啊,不知道為什麼!!! 是否是我的win7和server08上面有上面東西和它衝突了我也不知道。。。
(二)第二種方式:
我才用的第二種方式是 war檔案 + tomcat + MySQL,安裝到windows server 2008上,當然Web容器和資料庫也可以換成其它的,下面是詳細步驟:
(1)下載準備:
我用的是XWiki 5.2.2穩定版
Xwiki war檔案:http://main.xwiki.org/xwiki/bin/view/DownloadCode/DownloadFeedback?downloadLink=http://download.forge.ow2.org/xwiki/xwiki-enterprise-web-5.2.2.war&projectType=Older%20Stable&projectVersion=5.2.2&projectID=1
Xwiki模版xar檔案: http://main.xwiki.org/xwiki/bin/view/DownloadCode/DownloadFeedback?downloadLink=http://download.forge.ow2.org/xwiki/xwiki-enterprise-ui-mainwiki-all-5.2.2.xar&projectType=Older%20Stable&projectVersion=5.2.2&projectID=1
JDK:jdk7
Tomcat:tomcat7
MYSQL JDBC驅動: http://pan.baidu.com/s/1w33ch
(2)詳細步驟:
1 安裝JDK和Tomcat
設定JAVA_HOME,CATALINA_HOME,Path三個環境變數,前兩者分別是JAVA安裝主目錄和Tomcat安裝主目錄。
修改tomcat埠號和設定URIEncoding="UTF-8"
2 安裝MySQL:
我安裝的是server only,因為是離線安裝,所以沒辦法,如果可以聯網你可以安裝full或者developer
到其中有一步選擇作用的時候,選擇用作server
安裝好之後將MYSQL的bin路徑加到path中
修改my-default.ini,在[mysqld]下面加上
max_allowed_packet=64M
備註:例如刪除大量頁面時可能會出現傳送到mysql包太大的錯誤,這個時候可以改大這個值。
開啟CMD,開始建立資料庫和使用者
重啟MYSQL服務:
3 部署XWiki到tomcat:
(1)拷貝war檔案到webapps目錄下,啟動tomcat,然後再停掉
刪除war檔案,將war解壓後的資料夾名字改為xwiki, 然後將MYSQL的JDBC驅動拷貝到xwiki的WEB-INF的lib目錄下
(2)修改hibernate.cfg.xml檔案註釋掉HSQLDB的連線部分,放開MYSQL的連線部分
(3)修改catalina.bat檔案,在
echo Using CATALINA_BASE: "%CATALINA_BASE%"
的上方,加上下面兩句:
set JAVA_OPTS=%JAVA_OPTS% -server -Xms800m -Xmx800m -XX:MaxNewSize=256m
set JAVA_OPTS=%JAVA_OPTS% -server -XX:PermSize=128M -XX:MaxPermSize=512m
不加的話會有記憶體/棧溢位錯誤(Out of Memory : Perm Gen Space - Stack Overflow)。
(4)修改xwiki.cfg放開超級管理員。
找到system那一行,去掉前面的“#”號。
4 開啟瀏覽器輸入:
http://localhost:port/xwiki
(1)情況1:如果聯網:就點選continue,開始更新,直接成功裝上了。
(2)情況2:如果沒有聯網,只能點選skip了,然後可以看到一個找不到文件的提示。
用超級管理員(superadmin/system)登入,然後點選管理xwiki,就可以開始匯入xar模板檔案了。
但是我的匯入之後出現許可權問題,再次單擊xar檔案,再次匯入,退出登入,再次登入就會好了。
想要熟練使用XWiki,需要參閱教程:
其它參考資料:
http://zhidao.baidu.com/question/161644788.html?si=4
http://platform.xwiki.org/xwiki/bin/view/AdminGuide/InstallationTomcat
http://www.xwiki.org/xwiki/bin/view/FAQ/HowToSolveAJavaHeapMemoryError