Getting started with XWiki Workspaces

Getting started with XWiki Workspaces

Installing Workspaces

As for XWiki Enterprise, there are two options available to install XWiki Workspaces :

• Install the Standalone Distribution which comes already packaged with a servlet container and an embedded database. This is the easiest and recommended option for first time users, or for product evaluation
• Install the WAR distribution over existing Servlet container and databases.

Installing and running the Standalone Distribution

This is really easy : download the xwiki-workspaces hsqldb zip distribution from the Download page, unzip it on your filesystem, and run the start-up script : start_xwiki.sh for Unix like systems, and start_xwiki.bat for Windows ones. And you are done! You can point your browser on http://localhost:8080/xwiki/, and now read the Setting up your XWiki Workspaces.

Installing and running the WAR distribution

This installation type requires you have a Servlet Container and a relational database installed and configured. You will need to download xwiki-workspaces war distribution from the Download page. The first steps to setting up your installation are similar to installing XWiki Enterprise, so please refer its installation guide. Only, in the concluding step, you will have to install XWiki Workspaces Wiki XAR, instead of the XWiki Enterprise one.

Workspaces global administration

Once you successfully installed XWiki Workspaces, you can start the collaboration. Open the home page of workspaces by pointing your browser at http://yourserver/xwiki/bin/view/Main/WebHome, and login with the default Administrator account : Admin / admin

You will be redirected to the workspaces global administration home page. The global administration is the place administrators can manage the XWiki Workspaces instance : its users, and workpsaces. The first time you visit the global administration page, you will be invited you to create your first workspace : the one from your organization. This specific workspace is public (every registered user can access it and view its contents) and is meant to hold documents (wiki pages, blog entries, photos and files) that have to be shared across your whole organization. Fill-in the form, validate, and you are done!

The next steps are registering your users, and create more workspaces as you need them. The Global Administration page is accessible any time for the Admin user, via the most top-left button. Then, click as you need on the links the left panel proposes you :

Note that the Admin user has also access to a XWiki advanced toolbar, allowing him to modify any document from the Wiki, even technical ones hidden to regular users. Please, be careful, and use it only if you know what you are doing ;)