View source for User Services/Sync/SetupSyncNext

== Overview == 
Here's where you find all things on setting up Firefox Accounts and New Sync

Please log any bugs:
https://bugzilla.mozilla.org/enter_bug.cgi?product=Mozilla%20Services (component Server:Firefox Accounts)


== Desktop Firefox Accounts==
''' Desktop Firefox Accounts Setup '''

* Get nightly desktop Firefox > 2/3/2014
** http://nightly.mozilla.org/
* Launch Fx with new profile (run cmd for mac): /Applications/FirefoxNightly.app/Contents/MacOS/firefox -p 
* go into file menu Tools > Setup Sync
* Create Account
* Verify account via email
* See Sync logs or start a new firefox instance with different profile. [https://support.mozilla.org/en-US/kb/profile-manager-create-and-remove-firefox-profiles profile manager]
* add remove bookmarks and select from file menu 'Sync Now'

== Android Firefox Accounts==
''' Android Firefox Accounts Setup '''

* Get nightly android Firefox > 2/3/2014
** http://nightly.mozilla.org/
* Go to Android Settings > Accounts> Add Account and select "Firefox Account"
** (unfortunately, there's currently no way to customize the server urls)
* Create Account
* Verify account via email
* See android logs [http://160.twinql.com/how-to-file-a-good-android-sync-bug/] or start a new firefox instance with different profile [https://support.mozilla.org/en-US/kb/profile-manager-create-and-remove-firefox-profiles profile manager] to see the results of the sync

== Firefox Accounts URLs ==
* Recommend using a test profile as this may corrupt your sync data, NOT recoverable.

'''PREFS''' 
* [https://hg.mozilla.org/integration/fx-team/file/464aa919d253/browser/app/profile/firefox.js#l1340 current src]
* identity.fxaccounts.auth.uri
* identity.sync.tokenserver.uri
* firefox.accounts.remoteUrl

After https://bugzilla.mozilla.org/show_bug.cgi?id=960332 lands
* identity.fxaccounts.auth.uri
* identity.fxaccounts.remote.uri
* identity.fxaccounts.settings

''' Servers URLs '''

Dev URLS:
* Auth Server: https://stable.dev.lcip.org/auth/v1
* Content Server: https://stable.dev.lcip.org/?service=sync
* Token Server: http://token.dev.lcip.org/1.0/sync/1.5

Stage URLs:
* Content server: https://accounts.stage.mozaws.net/
* Auth server: https://api-accounts.stage.mozaws.net/
* Token server: https://token-stage3-stage.stage.mozaws.net

Production URLs:
* Content server: accounts.firefox.com
* Auth server: api.accounts.firefox.com
* Token server: token.services.mozilla.com
* Verifier: verifier.accounts.firefox.com (this one may be a little mushy)
** https://github.com/mozilla/fxa-auth-server/issues/295

== Sync debugging - Desktop ==
* goto about:config
* search by 'sync.log'
* set services.sync.log.appender.file.level=Trace
* view logs here: about:sync-log

Useful Firefox Configs:
* services.sync.log.appender.file.logOnError=Yes
* services.sync.log.appender.file.logOnSuccess=Yes

== Sync Debugging - Android ==
# Set up for Android debugging over USB
#* [[Mobile/Fennec/Android/CommonTips#Debugging]] might help
# install the <code>adb</code> command-line tool on a desktop computer
# run <kbd>adb logcat</kbd> on the desktop computer
# (Menu) > Settings > Customize > Sync > Sync Now will print lines like
  I/FxAccounts(14157): firefox :: CountCheckingServer11RepositorySession :: First sync for bookmarks: 7628 items.
  W/FxAccounts(14157): firefox :: CountCheckingServer11RepositorySession :: Too many items to sync safely. Skipping.
  I/FxAccounts(14157): firefox :: SynchronizerSession :: Session requested skip. Short-circuiting sync.
  I/FxAccounts(14157): firefox :: ServerSyncStage :: Stage bookmarks received -1 and sent -1 records in 0.09 seconds.

Before running <code>adb logcat</code> you can run <kbd>adb shell setprop log.tag.FxAccounts DEBUG</kbd> to cause additional debugging output.

See also rnewman's blog post [http://160.twinql.com/how-to-file-a-good-android-sync-bug/ How to file a good Android Sync bug].

* TBD - add information here about using desktop/ADB or using logcat
* Mobile team will have lots of details