MigrateContactsDatabase¶

Warning¶

• This article is a work in progress
• It hasn't been tested yet and might contain mistakes
• It needs to be more clear for less technical users

Migration¶

• Table of contents
• MigrateContactsDatabase
  • Warning
  • Migration
  • Backuping your contacts
  • Setup ADB
  • Mount the data partition
  • Reboot into the recovery
  • Erase your contact database
  • Install the new Replicant images
  • Revoke USB debugging permissions

Backuping your contacts¶

You'll first need backup your contacts somewhere safe.

TODO: explain how to do that. DO NOT SKIP THIS STEP ELSE YOU'LL LOOSE YOUR CONTACT DATA.

Setup ADB¶

Follow the instructions for setting up ADB on your computer so that you can access a root shell on your device.

NOTE: when prompted on your Replicant device, make sure that you check the box that says Always allow from this computer when you grant your computer USB debugging permissions. Otherwise, you will be unable to obtain root shell access on your Replicant device when you reboot it into the recovery OS to actually perform the backup.

NOTE: for security reasons, you may want to revoke these non-expiring permissions once the backup is complete.

Mount the data partition¶

TODO

Reboot into the recovery¶

To reboot in the recovery, you can follow the instructions in the RebootIntoTheRecovery wiki page.

Erase your contact database¶

Once in the recovery, you will then be able to erase your contact database:

rm -rf /data/data/com.android.providers.contacts/databases/

Install the new Replicant images¶

Once the backup is done, you can proceed to install the Replicant images that have the contact database format to migrate to.

Revoke USB debugging permissions¶

If you don't need USB debugging permissions anymore, it might be a good idea to remove them. The Revoking all computer's USB debugging permissions section in the ADB wiki page explains how to do that.

That's it! Your device's EFS partition is now backed up. Your device should be running Replicant normally again.