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).
First Change the directory to where the Java to be installed.
[[email protected] ~]# cd /opt/ [[email protected] opt]#wget http://download.oracle.com/otn-pub/java/jdk/8u91-b14/jdk-8u91-linux-x64.tar.gz [[email protected] opt]#tar xzf jdk-8u91-linux-x64.tar.gz [[email protected] opt]# cd jdk1.8.0_91/ [[email protected] jdk1.8.0_91]# alternatives --install /usr/bin/java java /opt/jdk1.8.0_91/bin/java 2 [[email protected] 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-22.214.171.124-126.96.36.199.el7_2.x86_64/jre/bin/java * 2 /usr/lib/jvm/java-1.8.0-openjdk-188.8.131.52-0.b14.el7_2.x86_64/jre/bin/java + 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 [[email protected] 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) [[email protected] jdk1.8.0_91]#alternatives --install /usr/bin/jar jar /opt/jdk1.8.0_91/bin/jar 2 [[email protected] jdk1.8.0_91]#alternatives --install /usr/bin/javac javac /opt/jdk1.8.0_91/bin/javac 2 [[email protected] jdk1.8.0_91]#alternatives --set jar /opt/jdk1.8.0_91/bin/jar [[email protected] jdk1.8.0_91]#alternatives --set javac /opt/jdk1.8.0_91/bin/javac [[email protected] jdk1.8.0_91]#export JAVA_HOME=/opt/jdk1.8.0_91 [[email protected] jdk1.8.0_91]#export JRE_HOME=/opt/jdk1.8.0_91/jre [[email protected] jdk1.8.0_91]#export PATH=$PATH:/opt/jdk1.8.0_91/bin:/opt/jdk1.8.0_91/jre/bin
We can Download the Glassfish from their official site by uisng the following command
[[email protected] ~]#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
[[email protected] ~]#
Start the GlassFish server by using the following command as follows
[[email protected] ~]#glassfish4/bin/asadmin start-domain
We can access the glass fish web-interface by using the url: http://localhost:4848
The Default username admin and password is blank. After login we get the homepage
In the main windows click on Applications menu.
Click on deploy button, locate the xwiki.war file and set the context root to xwiki
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
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
[[email protected] ~]#postgresql-setup initdb [[email protected] ~]#systemctl start postgresql
Once service started successfully create a database xwiki as follows
psql -U postgres CREATE DATABASE xwiki WITH OWNER = postgres ENCODING = 'UNICODE' TABLESPACE = pg_default;
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
Click on continue button. The register and authentication windows will be started.
Fill the above details and then click on Register and login button.
Then it goes to the step-2 user interface
Cllick on Install button to install Main wiki.
Then click on Continue.
The login screen for xwiki as follows(http://ipaddress:8080/xwiki)
Login by using the credentials created at step1, we will get the wiki home page
Now we can our own wiki pages as follows