wrenchContains administration tools for managing a running XWiki instance
TypeXAR
Developed by

Ludovic Dubost, Jerome Velociter, Sergiu Dumitriu, Anca Paula Luca, Maxime Sinclair, Andreas Jonsson, Thomas Mortagne, Oana Tabaranu, Guillaume Fenollar

Active Installs286
Rating
Rate!
15 Votes
LicenseGNU Lesser General Public License 2.1
Compatibility
  • Version 2.0: Tested on XE 2.7
  • Versions 2.0.1 and 2.0.2: Tested on XE 3.1
  • Version 3.0:  Tested on XWiki 3.5.1 and 4.0 but should still be generally compatible with older versions
  • Version 4.0: Tested on XWiki 4.5.4 and 5.1
Installable with the Extension Manager

Description

This XAR contains many administration tools for XWiki Enterprise or XWiki Enterprise Manager. 

  • Configuration Checks : Shows and check XWiki configuration, with some recommendations when parameters are not optimized for best performances.
  • Export/Import Tools : Several tools to import and export spaces and pages. It includes Large Import and Large Export applications, to be used when the database is to big to be exported from the wiki administration.
  • Flush Cache : Flush XWiki cache.
  • Wiki Diff : Make a wiki diff to compare current wiki with the standard .xar package.
  • Used Space : Shows used space of recycle bin, history, and attachments related tables, for all subwikis.
  • Shrink Recycle Bins : Permit to reduce space used, shrinking the recycle bins for pages and attachments.
  • Show Logs : Show n number of logs lines.
  • Show History : Show 20 largest history pages.
  • Show Spammed pages : List every page with more than 50 comments.
  • Sanity Check : Run a sanity check upon the database.
  • Show Rights : List every specific rights set in wiki / spaces / pages.
  • Database To Filesystem porter : Used to migrate every attachment from the DB to the filesystem (xwiki permanent directory), when Filesystem Storage feature is used.
  • Run Query : Run a SQL query in the current DB.

Screenshots

  • Configuration Checks:

    configurationCheck.jpg

  • Used Space:

    usedSpace.jpg

  • Show Rights:

    showRights.jpg

Tested on

This extension has been tested with the following configurations.

Extension VersionXWiki FlavorNotes
4.1.8XWiki Enterprise 9.1.2

This blocker was discovered while testing https://jira.xwiki.org/browse/ADMINTOOL-47

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.

You can also use the following manual method, which is useful if this extension cannot be installed with the Extension Manager or if you're using an old version of XWiki that doesn't have the Extension Manager:

  1. Log in the wiki with a user having Administration rights
  2. Go to the Administration page and select the Import category
  3. Follow the on-screen instructions to upload the downloaded XAR
  4. Click on the uploaded XAR and follow the instructions
  5. You'll also need to install all dependent Extensions that are not already installed in your wiki

After importing the XAR visit the page Admin.Tools

Release Notes

v4.1.8

  • Closed ADMINTOOL-40 Check programming rights shows groovy macro error page

v4.1.7

  • Closed ADMINTOOL-15 ExportSpace does not export spaces if page has a dot in the name
  • Closed ADMINTOOL-34 Hide SQL errors on Space Used from Admin tools when not using MySQL DB
  • Closed ADMINTOOL-36 Admin.ImportPage: Error parsing xml
  • Closed ADMINTOOL-37 Exceptions when clicking on "View Diff" link for a given document, when using the Wiki Diff tool

v4.1.6

  • Closed ADMINTOOL-31 "Failed to evaluate Script Macro for content" error when trying to access XWiki Configuration Check
  • Closed ADMINTOOL-32 Convert "Export" page from xwiki/1.0 to xwiki/2.1 syntax

v4.1.5

  • Closed ADMINTOOL-30 Wiki Diff : List documents that are missing from the target XAR

v4.1.4

  • Closed ADMINTOOL-29 Add an option to skip on wiki diff pages that have no other change but the revison number

v4.1.3

v4.1.2

  • Closed ADMINTOOL-20 Integrate Admin Tools functionality inside Administration and mark Admin.WebHome as hidden

v4.1.1

v4.1

  • Closed ADMINTOOL-1 Export feature does not export correctly pages with dots in their name
  • Closed ADMINTOOL-6 Admin Tools Application bug in Export pages with ' sign in page name
  • Closed ADMINTOOL-9 UI extension for the Admin Tools Application
  • Closed ADMINTOOL-10 "Large Export" feature does not export correctly pages with dots in their name
  • Closed ADMINTOOL-11 Pages with dots in name are escaped incorrectly
  • Closed ADMINTOOL-13 CheckXWikiConfig : hardcoded xwikicfgdir and no warning when xwiki.cfg not found / wrong check report
  • Closed ADMINTOOL-14 Export feature does not export correctly pages with double quotes or percent in their name

v4.0

  • All scripts have been rewriten using xwiki 2.1 (mostly) or 2.0 syntax.
  • SQLTools developed by Guillaume Delhumeau has been implemented to standardize SQL queries inside Admin Tools. With it, we now can Run Query, Show Large History, Show Spammed Pages... We plan to include PostgreSQL scripts very soon.
  • Used Space page has been rewritten completely. It summarizes now disk space used by all subwikis of the farm, and show attachments related database if filesystem storage mode is not used.
  • Configuration Check page has been rewritten, with some recommendations at the bottom depending on the configuration. At the moment, we put recommendations about memory, cache, encoding and cookies encryption keys.
  • User Rights Check has been replaced by Show Rights, which simply shows every right set on wiki / spaces / pages. It may be useful when we put temporary rights to pages (which can lead to security leaks)
  • Show Logs script have been included with a UI which permits to choose number of loglines to output, directly in the wiki page.
  • Export Tools now have Large Export/Import scripts
  • DatabaseToFilesystem porter script has been added (it seems not compatible with 5.x at the moment though).
  • Requests Status page has been dropped

TODO: Finish indexes integration in CheckSQLIndexes.

v3.0.2

v3.0.1

  • Fixed programming rights check page error
  • Stop saving known PR pages that does not exist

v2.0.2

  • Added a more relaxed verification for windows OS for getting environment variables, which seems to be needed on Windows server 2008
Created by Ludovic Dubost on 2011/01/31 17:06
    

Get Connected