XWiki Installation in Linux


Xwiki is an open-source enterprise-ready wiki written in Java, runs on a servlet container like Tomcat, Jboss etc. which uses the relational database to store the information.

In this article we will know about how to install Xwiki in Linux using .war file usable for production.

Installing XWiki using .war package

Before we going to install Xwiki, we have to install and configure Java,Servlet(Glass Fish) and Relational database(PostgreSQL, MySQL).

JAVA Installation

First Change the directory to where the Java to be installed.

[root@localhost ~]# cd /opt/
[root@localhost opt]#wget http://download.oracle.com/otn-pub/java/jdk/8u91-b14/jdk-8u91-linux-x64.tar.gz
[root@localhost opt]#tar xzf jdk-8u91-linux-x64.tar.gz
[root@localhost opt]# cd jdk1.8.0_91/
[root@localhost jdk1.8.0_91]# alternatives --install /usr/bin/java java /opt/jdk1.8.0_91/bin/java 2
[root@localhost jdk1.8.0_91]# alternatives --config java

There are 4 programs which provide 'java'.

  Selection    Command
   1      /usr/lib/jvm/java-1.7.0-openjdk-
*  2      /usr/lib/jvm/java-1.8.0-openjdk-
 + 3      /opt/jdk1.7.0_79/bin/java
   4      /opt/jdk1.8.0_91/bin/java

Enter to keep the current selection[+], or type selection number: 4
[root@localhost jdk1.8.0_91]#java -version
java version "1.8.0_91"
Java(TM) SE Runtime Environment (build 1.8.0_91-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.91-b14, mixed mode)
[root@localhost jdk1.8.0_91]#alternatives --install /usr/bin/jar jar /opt/jdk1.8.0_91/bin/jar 2
[root@localhost jdk1.8.0_91]#alternatives --install /usr/bin/javac javac /opt/jdk1.8.0_91/bin/javac 2
[root@localhost jdk1.8.0_91]#alternatives --set jar /opt/jdk1.8.0_91/bin/jar
[root@localhost jdk1.8.0_91]#alternatives --set javac /opt/jdk1.8.0_91/bin/javac
[root@localhost jdk1.8.0_91]#export JAVA_HOME=/opt/jdk1.8.0_91
[root@localhost jdk1.8.0_91]#export JRE_HOME=/opt/jdk1.8.0_91/jre
[root@localhost jdk1.8.0_91]#export PATH=$PATH:/opt/jdk1.8.0_91/bin:/opt/jdk1.8.0_91/jre/bin

Glassfish Installation

We can Download the Glassfish from their official site by uisng the following command

[root@localhost ~]#wget http://download.java.net/glassfish/4.1.1/release/glassfish-4.1.1.zip

Once the Download completed successfully, extract it by using tar command as follows

[root@localhost ~]#unzip glassfish-4.1.1*zip 

Start the GlassFish server by using the following command as follows

[root@localhost ~]#glassfish4/bin/asadmin start-domain

We can access the glass fish web-interface by using the url: http://localhost:4848

login screen

The Default username admin and password is blank. After login we get the homepage

glshfish home page

In the main windows click on Applications menu.


Click on deploy button, locate the xwiki.war file and set the context root to xwiki

xwiki upload

Then click on ok wait for a while when the process is completed. Once the deployment completes successfully, we will see the xwiki in applications menu as follows

xwiki in application menu

Now we can access the xwiki by using the url http://localhost:8080/xwiki (or) https://localhost:8181/xwiki. But at this step our wiki is empty, i.e it doesn’t contain any wiki page. now we have to configure the database to store the wiki content.

Relational Database Installation

In this we uses the postgresql database. First we check the postgresql is installed or not by using rpm -qa|grep postgresql. If postgresql is not installed install it by using the yum command.

After the completion of postgresql installation edit the file /var/lib/pgsql/data/pg_hba.conf and change the instance of ident to trust in that file.

Configure and start the Postgresql by using the following commands

[root@localhost ~]#postgresql-setup initdb
[root@localhost ~]#systemctl start postgresql

Once service started successfully create a database xwiki as follows

psql -U postgres

postgresql database

Now we have to connect the Glass fish server and PostgreSQL database by using appropriate JDBC Driver.

We can download it from their official site and copy it to the  XWiki webapp (in WEB-INF/lib). we can locate xwiki folder in glash fish directory as follows.


Now edit the file hibernate.cfg.xml file in WEB-INF Directory and comment the default database configuration and un comment the PostgreSQL  database configuration.

Now once agian restart the postgresql database server by using systemctl restart postgresql.

Now Access the xwiki page by using the url http://ipaddress:8080/xwiki.

The Distribution wizard will be start to configure Xwiki

xwiki distribution wizard

Click on continue button. The register and authentication windows will be started.

xwiki distribution 1

Fill the above details and then click on Register and login button.

xwiki distribution 2

Then it goes to the step-2 user interface

xwiki distribution 3

Cllick on Install button to install Main wiki.

xwiki distribution 4

Then click on Continue.

The login screen for xwiki as follows(http://ipaddress:8080/xwiki)

xwiki login page

Login by using the credentials created at step1, we will get the wiki home page

xwiki home page

Now we can our own wiki pages as follows

xwiki page create