Confluence Docs 3.0 : Migrating to new User Management This page last changed on Jan 12, 2009 by jlargman. 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.
| If going from OsUser to LDAP, use Migrate to LDAP User Management From OsUser rather than this page. This page is intended for upgrading internal user management repositories.
6. 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. 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 Find your Confluence base URL. To check this from Confluence, go to `Administration > General Configuration > Base Url`. Record this for later in the process. 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 roll back to the old version if the migration is unsuccessful. Download ldap_hibernate_osuser_atlassian-user.xml, rename it to `atlassian-user.xml` and copy it to your `confluence/WEB-INF/classes` directory. (You can overwrite the one that is there). If you have already set up LDAP in your `osuser.xml` file and wish to migrate to atlassian-user LDAP, then you need to uncomment the ldap section, and fill in the correct details (as described in Customising atlassian-user.xml). This will prevent users in your osuser table that exist in LDAP from being migrated over. If you haven't already set up LDAP in `osuser.xml` please do NOT uncomment the ldap section. Restart Confluence. 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. 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. Stop Confluence. 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. 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`. Restart Confluence. Check that your users can still log in. ##### RELATED TOPICS Understanding User Management in Confluence Confluence 2.7 Upgrade Guide Attachments: hibernate_cache_atlassian-user.xml (text/xml) hibernate_cache_atlassian-user.xml (text/xml) ldap_hibernate_osuser_atlassian-user.xml (text/xml)

Document generated by Confluence on Nov 05, 2009 23:27