InstallationWebSphere

Version 1.10 by Vincent Massol on 2010/02/26

WebSphere installation

Information

These instructions cover WebSphere V6.1; other versions may differ.

Install XWiki application

  • Start the application server if it isn't running:
$WAS_HOME/bin/startServer.sh server1
  • Start the Console. The default URLs are:
  • Expand the Applications menu and click on Install New Application.
  • Fill in the following:
    • Full path to XWiki WAR (if 
    • Context root to /xwiki.
  • Hit Next; at this point if your WAR file is on a different machine from the server it will be copied over.
  • Fill in each screen and hit Next on each.
    • Step 1: You may want to modify the Application name
    • Step 2: Nothing to do
    • Step 3: The jdbc/XWikiDS is not used by XWiki, but you still need to fill it out. Simply click Browse... under Target Resource JNDI Name, choose the Default Datasource and hit Apply.
    • Step 4: Nothing to do
    • Step 5: Hit Finish.
  • A screen with the results is next displayed. At this point the changes have not been written to the file system. Click on the Save link to finish the installation step.

Configure WebSphere

  • WebSphere v6.1 does not have the PNG MIME type configured by default, so you need to do so. If you do not follow this step, you'll get a NullPointerException at com.xpn.xwiki.web.SkinAction.isJavascriptMimeType.
    • In the Console, expand Environment and select Virtual Hosts
    • Click on the default_host link (or whatever host you installed XWiki onto)
    • Click on the MIME types link
    • Click New to add a new MIME type
    • Fill out the form as follows:
      • MIME Type: image/png
      • Extensions: PNG png
  • Hit OK, Save to the configuration, and restart the server.

Troubleshooting

  • XWiki 1.0 contains a bug that shows up as lots of messages in SystemOut.log which all say 'SRVE0238E: Resource paths should have a leading slash'. You can patch xwiki.jar or ignore them (it still works, just slower and fills up the log)")

Get Connected