How to migrate existing users over to Atlassian-User

This document has been deprecated (as of 16th of February 2006). Please see this document instead.

All versions of Confluence up to and including 2.0.x made use of a component called OSUser to store and manage users. We've written our own component to do this and its called Atlassian-User.

The two main reasons for migrating over to Atlassian-User are:

1. If you want to take advantage of the new Atlassian-User-LDAP-Integration
2. Atlassian-User is more performant than OSUser

Please follow these steps to migrate your users:

1. Make a backup of your:
   • database
   • Confluence home directory
   • confluence/WEB-INF/classes/atlassianUserContext.xml (only if you have made changes)
2. Download hibernate_osuser_atlassianUserContext.xml and rename to atlassianUserContext.xml and copy to your confluence/WEB-INF/classes directory (you can overwrite the one that's there)
3. Now uncomment the osuserMigrationBean in confluence/WEB-INF/classes/upgradeSubsystemContext.xml

   <!-- To be used. optionally, to transfer ouser data to another repository. See osuser2atluser.jsp -->
       <bean id="osuserMigrationBean" class="org.springframework.transaction.interceptor.TransactionProxyFactoryBean">
           <property name="transactionManager">
               <ref bean="transactionManager"/>
           </property>
           <property name="target">
               <ref local="osuserMigrationBeanTarget"/>
           </property>
           <property name="transactionAttributes">
               <props>
                   <prop key="*">PROPAGATION_REQUIRED</prop>
               </props>
           </property>
           <property name="proxyInterfaces">
               <value>com.atlassian.user.util.migration.EntityMigrator</value>
           </property>
       </bean>
   
       <bean id="osuserMigrationBeanTarget" class="com.atlassian.user.util.migration.OSUEntityMigrator">
           <constructor-arg index="0">
               <ref bean="hibernateUserManager" />
           </constructor-arg>
           <constructor-arg index="1">
               <ref bean="hibernateGroupManager" />
           </constructor-arg>
           <constructor-arg index="2">
               <ref bean="hibernatePropertySetFactory" />
           </constructor-arg>
           <constructor-arg index="3">
               <ref bean="profileProvider" />
           </constructor-arg>
           <constructor-arg index="4">
               <ref bean="accessProvider" />
           </constructor-arg>
       </bean>

4. Restart Confluence and login as an Administrator and point a browser to *http://your.server.com/admin/osuser2atluser.jsp*
5. Click the link Begin migration
6. 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 and comment back in the osuMigrationBean in confluence/WEB-INF/classes/upgradeSubsystemContext.xml. That is:
   

   <!-- To be used. optionally, to transfer ouser data to another repository. See osuser2atluser.jsp -->
       <!--<bean id="osuserMigrationBean" class="org.springframework.transaction.interceptor.TransactionProxyFactoryBean">
           <property name="transactionManager">
               <ref bean="transactionManager"/>
           </property>
           <property name="target">
               <ref local="osuserMigrationBeanTarget"/>
           </property>
           <property name="transactionAttributes">
               <props>
                   <prop key="*">PROPAGATION_REQUIRED</prop>
               </props>
           </property>
           <property name="proxyInterfaces">
               <value>com.atlassian.user.util.migration.EntityMigrator</value>
           </property>
       </bean>
    
       <bean id="osuserMigrationBeanTarget" class="com.atlassian.user.util.migration.OSUEntityMigrator">
           <constructor-arg index="0">
               <ref bean="hibernateUserManager" />
           </constructor-arg>
           <constructor-arg index="1">
               <ref bean="hibernateGroupManager" />
           </constructor-arg>
           <constructor-arg index="2">
               <ref bean="hibernatePropertySetFactory" />
           </constructor-arg>
           <constructor-arg index="3">
               <ref bean="profileProvider" />
           </constructor-arg>
           <constructor-arg index="4">
               <ref bean="accessProvider" />
           </constructor-arg>
       </bean>-->

8. Start up Confluence and you should be able to login as per normal