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
- 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.
- 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)")
