com.atlassian.bamboo.upgrade.tasks.v6_6.ec

Class AtlassianUserDataMigrator

java.lang.Object

com.atlassian.bamboo.upgrade.tasks.v6_6.ec.AtlassianUserDataMigrator

public final class AtlassianUserDataMigrator
extends Object

Convert all users and groups in the Confluence Hibernate repository to internal directory users in Embedded Crowd. The assumption is that if someone was in the database before the upgrade they should still be in the database afterwards.

Note: we have to do this the one-by-one way rather than doing it in the database because otherwise Crowd will not get the chance to do things like case-normalisation in its own way.

Could be also used for on-demand migration after an upgrade, but you should be careful that you don't clobber data. The upgrade task checks for existing users before doing any migration.

Constructor Summary

Constructors

Constructor and Description
AtlassianUserDataMigrator(org.hibernate.SessionFactory sessionFactory, com.atlassian.crowd.embedded.spi.UserDao userDao, com.atlassian.crowd.embedded.spi.GroupDao groupDao, com.atlassian.crowd.embedded.spi.MembershipDao membershipDao, com.atlassian.crowd.embedded.api.CrowdService crowdService, com.atlassian.crowd.manager.directory.DirectoryManager directoryManager)

Method Summary

Modifier and Type	Method and Description
void	migrateExternalMemberships(Connection connection, @NotNull com.atlassian.crowd.embedded.api.Directory externalDirectory)
void	migrateGroupMemberships(com.atlassian.crowd.embedded.api.Directory internalDirectory, Connection connection)
void	migrateGroups(com.atlassian.crowd.embedded.api.Directory internalDirectory, Connection connection)
void	migrateUserProperties(com.atlassian.crowd.embedded.api.Directory internalDirectory, Connection connection) Migrates user properties from post-2.7 versions of Confluence by changing entity_names in the os_propertyentry table to CWD_<lowercase_username>.
void	migrateUsers(com.atlassian.crowd.embedded.api.Directory internalDirectory, Connection connection)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AtlassianUserDataMigrator

public AtlassianUserDataMigrator(org.hibernate.SessionFactory sessionFactory,
                                 com.atlassian.crowd.embedded.spi.UserDao userDao,
                                 com.atlassian.crowd.embedded.spi.GroupDao groupDao,
                                 com.atlassian.crowd.embedded.spi.MembershipDao membershipDao,
                                 com.atlassian.crowd.embedded.api.CrowdService crowdService,
                                 com.atlassian.crowd.manager.directory.DirectoryManager directoryManager)

Method Detail

migrateUserProperties

public void migrateUserProperties(com.atlassian.crowd.embedded.api.Directory internalDirectory,
                                  Connection connection)

Migrates user properties from post-2.7 versions of Confluence by changing entity_names in the os_propertyentry table to CWD_<lowercase_username>.

If users with the same (case-insensitive) entity_name exist from different repositories, we should treat them all as the same user. In this case, the properties of the user with the most recent activity against the username will be preserved, all others will be removed.

Parameters:

internalDirectory - The directory to migrate to

migrateGroupMemberships

public void migrateGroupMemberships(com.atlassian.crowd.embedded.api.Directory internalDirectory,
                                    Connection connection)

migrateUsers

public void migrateUsers(com.atlassian.crowd.embedded.api.Directory internalDirectory,
                         Connection connection)

migrateGroups

public void migrateGroups(com.atlassian.crowd.embedded.api.Directory internalDirectory,
                          Connection connection)

migrateExternalMemberships

public void migrateExternalMemberships(Connection connection,
                                       @NotNull
                                       @NotNull com.atlassian.crowd.embedded.api.Directory externalDirectory)