= Synchronize User Account data between multiple Trac projects =
{{{
#!html
WARNING: This plugin is at best an early beta. So take special care using it, especially in productive environments!
}}}
== Description ==
This plugin can be used to synchronize user account data between multiple projects within the same `TRAC_PARENT`. Basically, it reads the account information from all the separate environments, merges them, and then updates all environments accordingly. As it currently still is in early beta state at best, a `dryrun` mode is enabled by default - so no changes will be written to the database. Instead, the updates for the affected environments will be stored in `.sql` files to investigate.
If you intend to use this plugin in its current state, you are strongly encouraged to...
1. first test it in a non-productive environment, which best is a copy of the intended productive environment to be used on later
1. first let it run in `drymode`, and investigate the resulting `*.sql` files carefully
1. only if everything seems to be fine, and still being in your test environment, and after making a copy of the databases, disable `drymode` and verify the results
1. only if still everything seems to be OK, repeat these steps in your productive environment - at your own risk
I (the author) will take no responsibilities whatever, especially concerning possible damage and data loss. You have been warned!
If you are still encouraged to try it: Great - I love to receive your feedback!
== Limitations ==
Except this plugin being still in early beta state, there are more limitations to consider:
1. it was not widely tested yet
1. it is not yet "fool-proof" (if it ever will be). This especially means, not all possible exceptions may be handled yet
1. it works only for environments, which...
1. share the same `TRAC_PARENT_DIR`
1. use the AccountManagerPlugin
1. store the user passwords in a `.htpasswd` file
1. share the same `.htpasswd` password file (which at the moment '''''you''''' have to ensure, it's not yet verified)
There may be more limitations I'm not aware of at the moment...
== Bugs/Feature Requests ==
Existing bugs and feature requests for TracUserSyncPlugin are
[report:9?COMPONENT=TracUserSyncPlugin here].
If you have any issues, create a
[http://trac-hacks.org/newticket?component=TracUserSyncPlugin&owner=izzy new ticket].
== Download ==
Download the zipped source from [download:tracusersyncplugin here].
== Source ==
You can check out TracUserSyncPlugin from [http://trac-hacks.org/svn/tracusersyncplugin here] using Subversion, or [source:tracusersyncplugin browse the source] with Trac.
== Example ==
Coming soon...
== Recent Changes ==
[[ChangeLog(tracusersyncplugin, 3)]]
== Author/Contributors ==
'''Author:''' [wiki:izzy] [[BR]]
'''Contributors:'''