XWIKI – mysql driven Wiki
I’ve been using wiki’s for some time from phpwiki, mediawiki, etc. They all have some pro’s and con’s. I still like the php wiki, twiki, very much, and the java wiki, JSPWiki, but I have also grown to like XWIKI, http://xwiki.org.
It is a tomcat driven wiki with all the data in mysql, instead of txt files like the aforementioned wiki’s. This makes for good security, backup, recovery, etc. Albeit it does seem to run a little slower. Below are my basic install notes, enjoy…
Install Tomcat
wget http://mirror.cc.columbia.edu/pub/software/apache/tomcat/tomcat-5/v5.5.27/bin/apache-tomcat-5.5.27.tar.gz tar -xzf apache-tomcat-5.5.27.tar.gz mv apache-tomcat-5.5.27 /opt/tomcat-5.5 echo “export CATALINA_HOME=/opt/tomcat-5.5” >> ~/.bashrc echo “CATALINA_BASE=/opt/tomcat-5.5” >> ~/.bashrc adduser tomcat chown -R tomcat.tomcat tomcat-5.5 su – tomcat cd /opt/tomcat-5.5/bin sh startup.sh
or yum install tomcat
Install XWIKI
su – tomcat cd /opt/tomcat-5.5/ cd webapps/
download and move to this directory webapps xwiki-enterprise-web-1.9.3.war from http://www.xwiki.org/xwiki/bin/view/Main/Download
chown tomcat.tomcat xwiki-enterprise-web-1.7.2.war mkdir xwiki mv xwiki-enterprise-web-1.7.2.war xwiki cd xwiki/ unzip xwiki-enterprise-web-1.7.2.war cd WEB-INF/ nano -w xwiki.cfg – Set xwiki.store.hibernate.path /opt/tomcat5-5.5/webapps/xwiki/WEB-INF/hibernate.cfg.xml – Set xwiki.home
Create MYSQL DB
mysql -u root -e “create database xwiki” mysql -u root -e “grant all privileges on xwiki.* to xwiki@127.0.0.1 identified by ‘xwiki(or some pass)'” mysql –version -dowload mysql-connector-java-5.0.8-bin.jar and move to /opt/tomcat-5.5/webapps/xwiki/WEB-INF/lib/ mysql -u xwiki -p xwiki -h 127.0.0.1 < mycommands.sql
cd /opt/tomcat-5.5/webapps/xwiki/WEB-INF/ nano -w hibernate.cfg.xml – Edit section for mysql
Set Permissions on the xwiki folder
cd xwiki/ rm xwiki-enterprise-web-1.7.2.war cd .. chown -R tomcat.tomcat xwiki
LDAP Authentication settings in xwiki.cfg for Windows AD
————————————————————————————-
LDAP
————————————————————————————-
-# new LDAP authentication service
xwiki.authentication.authclass=com.xpn.xwiki.user.impl.LDAP.XWikiLDAPAuthServiceImpl
-# Turn LDAP authentication on – otherwise only XWiki authentication
-# 0: disable
-# 1: enable
xwiki.authentication.ldap=1
-# LDAP Server (Active Directory, eDirectory, OpenLDAP, etc.)
xwiki.authentication.ldap.server=(Set server IP) xwiki.authentication.ldap.port=389 xwiki.authentication.ldap.check_level=1
-# LDAP login, empty = anonymous access, otherwise specify full dn
-# {0} is replaced with the username, {1} with the password
xwiki.authentication.ldap.base_DN=dc=insource,dc=local xwiki.authentication.ldap.bind_DN=ADDOMAIN\useraccount xwiki.authentication.ldap.bind_pass=password xwiki.authentication.ldap.UID_attr=sAMAccountName xwiki.authentication.ldap.fields_mapping=name=sAMAccountName,last_name=sn,first_name=givenName,fullname=displayName,mail=mail,ldap_dn=dn
-# Force to check password after LDAP connection
-# 0: disable
-# 1: enable
xwiki.authentication.ldap.validate_password=0
Apache
Using Proxy Pass Tomcat port through Apache or use with https Put the below in your .conf file in conf.d
ProxyRequests Off ProxyPreserveHost On ProxyPass /xwiki http://127.0.0.1:8080/xwiki ProxyPassReverse /xwiki http://127.0.0.1:8080/xwiki
Follow UP
Download and import the workspace after setup for templates, etc. xwiki-workspaces-wiki-1.1.1.xar