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. 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 [1] or start a new firefox instance with different profile 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

• 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

1. Set up for Android debugging over USB
   • Mobile/Fennec/Android/CommonTips#Debugging might help
2. install the adb command-line tool on a desktop computer
3. run adb logcat on the desktop computer
4. (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 adb logcat you can run adb shell setprop log.tag.FxAccounts DEBUG to cause additional debugging output.

See also rnewman's blog post 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