Project

General

Profile

Actions

MigrateContactsDatabase » History » Revision 6

« Previous | Revision 6/43 (diff) | Next »
Denis 'GNUtoo' Carikli, 05/08/2021 07:18 PM
Add section to mount the data partitions


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

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.

Updated by Denis 'GNUtoo' Carikli about 3 years ago · 6 revisions

Also available in: PDF HTML TXT