How to deploy XWiki to Jelastic cloud: step-by-step tutorial
If you are a fan of XWiki, or you haven’t had a chance yet to try it, here is your chance to see how easy it is to use with Jelastic. XWiki is a free wiki software platform written in Java that is pretty cool and useful. It allows for the storing of structured data and the execution of server side script within the wiki interface.
Let’s deploy XWiki to Jelastic cloud right now!
1. Create an environment
- Go to jelastic.com and sign up if you haven’t done so yet, or log in with your Jelastic credentials by clicking the Sign In link on the page.
- Ask Jelastic to create a new environment:
- In the Environment Topology dialog, pick your application server (for example, Tomcat 6) and the database you want to use (for example MySQL). Then specify your environment name, for example, xwikitest.
It will take just a minute for your environment to be created.
2. Upload a Java package
- Navigate to xwiki.org and download the latest XWiki distribution WAR.
- Go back to Jelastic and upload the package you have just downloaded to the Deployment manager.
- Once the package is in Jelastic, deploy it to your environment.
3. Configure database
- Click the Open in browser button for MySQL.
- When you created the environment, Jelastic sent you an email with credentials to the database. Use these credentials to create a user account and the database with the application.
4. Configure XWiki
- Upload MySQL connector to the lib folder .
- Pick Config for Tomcat and change hibernate.cfg.xml file (webapps/ROOT/WEB-INF): comment the part of file which is responsible for the default database configuration, uncomment MySQL configuration and type the correct database connection URL, your database name and password.
Save the changes and restart Tomcat!
5. Start XWiki
Now you can open XWiki in a browser and create your spaces and pages there. Enjoy!
Cheers!













Blog
Twitter
YouTube
Facebook
Google+
Habrahabr
Thanks for making this available. Jelastic is fantastic and your description got me 99% of the way there….
However, after setting up Xwiki and starting tomcat, you also need to upload,
via ‘bin/import/XWiki/XWikiPreferences’ , xwiki-enterprise-ui-all-3.5.xar . However, uploading this large file into the “empty” Xwiki dies with an error that suggests max_allowed_packet is too small.
http://platform.xwiki.org/xwiki/bin/view/AdminGuide/InstallationMySQL#HMySQLversionsolderthan5.0 suggests changing mysql config my.cnf file from 1M to 32M ‘max_allowed_packet’
“If an empty Xwiki starts with no errors, but you unable to upload the default set of pages (XAR file) also try to increase “max_allowed_packet” parameter as shown above. ”
So I changed my.cnf
max_allowed_packet = 32M
Then I restarted mysql while the Xwiki/tomcat instance was running.
Now I’m able to upload the XAR successfully, then import the default Xwiki environment. After changing the default Xwiki ‘Admin’ password I now have a working Xwiki instance http://nielsmayer.jelastic.servint.net/