Skip to content

How to deploy XWiki to Jelastic cloud: step-by-step tutorial

by on February 21, 2012

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

  1. 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.
  2. Ask Jelastic to create a new environment:
  3. 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

  1. Navigate to xwiki.org and download the latest XWiki distribution WAR.
  2. Go back to Jelastic and upload the package you have just downloaded to the Deployment manager.
  3. Once the package is in Jelastic, deploy it to your environment.

3. Configure database

  1. Click the Open in browser button for MySQL.
  2. 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

  1. Upload MySQL connector to the lib folder .
  2. 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!

From → Announcements, HowTo

2 Comments
  1. 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/

Trackbacks & Pingbacks

  1. Newsletter – February 22, 2012 « Jelastic — Rock-Solid Java in the Cloud, Java Server Hosting, Java Cloud Computing

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Connecting to %s

Follow

Get every new post delivered to your Inbox.

Join 95 other followers