Confluence 2.2.1 is a maintenance release that resolves some issues users may have encountered using Confluence 2.2, including issues related to LDAP user management, i18n, personal spaces and drafts.
2.2.1 is a free upgrade for all customers who purchased their Confluence license after May 18th, 2004.
Who should upgrade?
Confluence is a recommended upgrade for all customers using Confluence with external LDAP user management. All other customers should consult the list of issues resolved, and determine if this release is necessary for their own deployments.
Upgrade Procedure
Upgrading Confluence should be pretty easy. If you are upgrading from Confluence 2.2, you can find instructions here. We strongly recommend that you backup your confluence.home directory and database before upgrading!
 | Draft Table Upgrade
Upgrading Confluence to 2.2.1 will cause all autosaved 'drafts' to be deleted from the database. Be sure everyone has saved their work before upgrading! |
 | Confluence 2.2.1 and 2.2.1a
The current version available for download is 2.2.1a. 2.2.1 was originally released with an old version of the atlassian-plugins library, which caused the plugin fixes listed below not to be included in the release. Confluence 2.2.1a resolves that problem. |
| PageChildrenMacro IndexOutOfBoundsException error
Customers who downloaded 2.2.1 or 2.2.1a before the official announcement may encounter an error when using the {children} macro to view the children of other pages in the same space. There is a patch for this issue attached to CONF-6197 |
If you are upgrading from Confluence 2.1.5 or earlier, please check the release-notes of the other major Confluence releases:
Changes in 2.2.1
For a complete list, see: Issues resolved for 2.2.1
External User Management
- Creating a new user will no longer cause a primary key violation on some Confluence installations. CONF-6092
- Fixed a regression where authentication against an external LDAP server via the old OSUser integration layer did not function. CONF-6052
- Fixed a possible ClassCastException on viewing a user's profile. CONF-6021
Plugins
Note: Due to a scheduling error, these fixes were not included in Confluence 2.2.1, but are in the supplementary 2.2.1a release.
- Component plugins are now correctly unregistered when they are removed. CONF-4041
- Plugins may now contain and reference dependent jar files. Thanks to Dan Hardiker of Adaptavist for the patch. PLUG-8
- Installing an older version of an already-installed plugin no longer causes an error. PLUG-12
- Removing an uploaded plugin no longer causes it to be deactivated the next time it is installed. PLUG-13
General Stability
- Confluence can now store drafts for spaces with long (>20 character) keys. CONF-6010
- Attachments stored in MySQL databases will no longer be silently truncated to 64KB. CONF-6120
- Global language setting is now saved correctly. CONF-6027
- Missing attachment data no longer causes PDF export to crash. CONF-6063
- Misleading "attachment missing" errors are no longer logged after a space import. CONF-6026
Improvements
- A Javascript alert warns users if they have left the CAPTCHA field blank. CONF-5984
- A link to the logged-in user's personal space is included on every page (from their full name). CONF-6056
- The {children} macro can now show the children of pages in another space. CONF-5986
