In order to support advanced forms of user management, Confluence now uses the AtlassianUser management framework, which can store users in the database (through Hibernate) instead of delegating the user management to OSuser.

Manual migration no longer required from Confluence 2.7.0

This page describes how to perform a manual migration of your users from OSuser to AtlassianUser. For Confluence 2.7.0 and later, there is no need to perform a manual migration of your users to the AtlassianUser framework. If you are installing Confluence 2.7.0 or later for the first time, you will automatically receive the AtlassianUser framework. If you are upgrading from an earlier version to Confluence 2.7.0 or later and have not changed the default user management configuration, your users will be automatically migrated. Refer to the details in the Confluence 2.7 Upgrade Guide.

For Confluence 2.6.x and earlier, Confluence delegates user management to OSuser by default. However, you may wish to migrate your users away from OSuser for one or more of the following reasons:

  • In preparation to use external user management.
  • To take advantage of the native AtlassianUser's much more efficient searching and user administration.
  • Because you are having problems with OSuser, such as CONF-5218.

(warning) The migration instructions below are valid for Confluence version 2.2 and later.

Step 1 - Upgrade Confluence

Please check that you are running the latest version of Confluence. If not, we strongly recommend that you consider upgrading Confluence according to this guide. Confirm that you have upgraded successfully before trying to add LDAP to the new version.

Step 2 - Confluence User Migration

  1. Find your Confluence base URL. To check this from Confluence, go to Administration > General Configuration > Base Url. Record this for later in the process.

  2. Make a backup of your:
    • database
    • Confluence ホームディレクトリ
    • confluence/WEB-INF/classes/atlassian-user.xml (only if you have made changes)
      (warning) If you do not create a backup, you cannot roll back to the old version if the migration is unsuccessful.
  3. Download hibernate_osuser_atlassian-user.xml and rename to atlassian-user.xml. Then copy this file to your confluence/WEB-INF/classes directory. (You can overwrite the one that's there).

  4. Confluence を再起動します。
  5. Log in as a System Administrator, copy the address http://<BASEURL>/<contextpath>/admin/osuser2atluser.jsp and paste it into your browser's address bar. Change <BASEURL> to your actual base URL and <contextpath> to your context path (usually 'confluence') and follow the link.

  6. Click the link Begin migration. You will know the migration has been successful if you see this reported: 

    Migrating users and groups ...
Users and groups migrated successfully!
    If you encounter errors, please create a support ticket at http://support.atlassian.com and attach your application server logs.

  7. Confluence を停止します。

  8. Start up Confluence and check that you can log in using the admin account you first set up when running through the Confluence Setup Wizard. If not, re-examine your steps and repeat from the point where you may have gone wrong.

  9. Download hibernate_cache_atlassian-user.xml, rename it to atlassian-user.xml then copy to your <INSTALL>/confluence/WEB-INF/classes directory. It should overwrite the previous atlassian-user.xml.

  10. Restart Confluence. Check that your users can still log in.
関連トピック

Understanding User Management in Confluence
Confluence 2.7 Upgrade Guide

  • ラベルなし

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.