Migrating to new User Management

In order to support advanced forms of User Management, Confluence now uses new user management which can store users through hibernate instead of delegating the user management to OSuser.

By default Confluence still delegates User Management to OSuser. However, you may wish to migrate your users away from OSuser, either in preparation to use external user management, or because you are having problems with OSuser, such as CONF-5218.

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. You will need to find out 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 home directory
   • confluence/WEB-INF/classes/atlassian-user.xml (only if you have made changes)

     If you do not create a backup, you cannot rollback 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. Restart Confluence.
5. Login as an Administrator, copy the address http://<BASEURL>/<contextpath>/admin/osuser2atluser.jsp and paste it into your browser's address bar. Edit the <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 ... Users migrated successfully!
   Migrating propertyset data ... Propertyset data migrated successfully!
   Migrating groups ... Groups migrated successfully\!
   

   If you encounter errors, please create a support ticket at http://support.atlassian.com and attach your application server logs.
   
   
7. Stop Confluence.
   
   
8. Start up Confluence and check that you can login using the admin account you first set up when running through the Confluence Setup Wizard. If not, re-examine your steps and repeat from there.
   
   
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.