MigrateContactsDatabase » History » Version 37

Denis 'GNUtoo' Carikli, 06/02/2022 04:50 PM
Add WIP section for restoring the contacts

1 1 Denis 'GNUtoo' Carikli
h1. MigrateContactsDatabase
2 2 Denis 'GNUtoo' Carikli
3 31 Denis 'GNUtoo' Carikli
4 1 Denis 'GNUtoo' Carikli
5 31 Denis 'GNUtoo' Carikli
h2. Migration overview
6 4 Denis 'GNUtoo' Carikli
7 19 Denis 'GNUtoo' Carikli
Starting with @Replicant 6.0 0004 RC5@, the internal contact database format has changed due to the removal of some nonfree code (the Ambient SDK).
8 1 Denis 'GNUtoo' Carikli
9 19 Denis 'GNUtoo' Carikli
So when upgrading from a Replicant 6.0 image before @Replicant 6.0 0004 RC5@, you will need to follow the migration procedure that is in this wiki page.
If you follow it, you will have to backup your contact database to a file, then you will erase the internal contact database from within the Replicant recovery.
When this is done you will be able to install the new Replicant image.
After that you will be able to restore your contacts database by restoring it from the file you backuped it to.
h2. Backuping your contacts in a file
19 33 Denis 'GNUtoo' Carikli
First, you'll need to make sure Replicant is booted on the device and open the stock contact application. Here's how it looks like after the first start of Replicant 6.0 0003:
20 1 Denis 'GNUtoo' Carikli
21 33 Denis 'GNUtoo' Carikli
23 1 Denis 'GNUtoo' Carikli
Then if it shows a screen with "No contacts." in it, you won't need to backup the contacts to a file since you have no contacts, so you can skip this section (Backuping your contacts in a file), but you will still need to follow the rest of the tutorial in order to erase the internal contact database, otherwise your device may continuously crash after installing a new Replicant version with a different contact database format.
25 33 Denis 'GNUtoo' Carikli
If instead it shows some contacts, like in the following image you will then need to backup them to a file:
27 1 Denis 'GNUtoo' Carikli
28 33 Denis 'GNUtoo' Carikli
To do that you will first need to go in the contact application settings. For that click on the menu button (it's on the top right and it consists of 3 vertical dots):
30 1 Denis 'GNUtoo' Carikli
31 33 Denis 'GNUtoo' Carikli
That will display a menu. You will then have to select "Import/export" and then "Export to .vcf file":
33 1 Denis 'GNUtoo' Carikli
34 33 Denis 'GNUtoo' Carikli
It will then display a new screen with many contacts. You will need to click a menu button again (it's on the top right and it consists of 3 vertical dots):
35 1 Denis 'GNUtoo' Carikli
36 33 Denis 'GNUtoo' Carikli
37 1 Denis 'GNUtoo' Carikli
38 33 Denis 'GNUtoo' Carikli
Then  a new menu with only one option ("All [ ]") will appear:
40 1 Denis 'GNUtoo' Carikli
41 33 Denis 'GNUtoo' Carikli
You will need to select this option to select all contacts. This will bring to a new screen with all the contacts being checked. You will then need to press the right tick (it looks like a V) that is between the search button and the menu button on the top-right of the screen.
42 7 Denis 'GNUtoo' Carikli
43 33 Denis 'GNUtoo' Carikli
44 7 Denis 'GNUtoo' Carikli
45 33 Denis 'GNUtoo' Carikli
Once this is done, it typically brings you to the download application that let you save your contact to a file in the device. As there are no other options you need to select "Download" on the left to save it to the download folder:
47 7 Denis 'GNUtoo' Carikli
48 33 Denis 'GNUtoo' Carikli
It's then strongly advised to copy the resulting file outside of the phone for instance:
* To copy it on a microSD and keep the microSD in a safe place where you won't loose it
* To copy it on an USB key with the help of a special usb cable
* To copy it on your computer with the help of adb
52 4 Denis 'GNUtoo' Carikli
h2. Setup ADB
Follow the instructions for [[ADB|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 [[ADB#Revoking-all-computers-USB-debugging-permissions|revoke these non-expiring permissions]] once the backup is complete.
61 12 Denis 'GNUtoo' Carikli
h2. Reboot into the recovery
To reboot in the recovery, you can follow the instructions in the [[RebootIntoTheRecovery]] wiki page.
65 6 Denis 'GNUtoo' Carikli
h2. Mount the data partition
67 14 Denis 'GNUtoo' Carikli
You then need to mount the data partition.
68 1 Denis 'GNUtoo' Carikli
69 34 Denis 'GNUtoo' Carikli
For the @Galaxy S III (GT-I9300)@, @Galaxy S III 4G (GT-I9305)@, the @Galaxy Note II (GT-N7100)@ and the @Galaxy Note 8.0 (GT-N51xx)@, you can use the following command:
70 9 Denis 'GNUtoo' Carikli
71 13 Denis 'GNUtoo' Carikli
mount /dev/block/platform/*/by-name/USERDATA /data/
72 1 Denis 'GNUtoo' Carikli
73 9 Denis 'GNUtoo' Carikli
74 26 Denis 'GNUtoo' Carikli
And for the @Galaxy Nexus (GT-I9250)@, you can use the following command:
75 11 Denis 'GNUtoo' Carikli
76 26 Denis 'GNUtoo' Carikli
mount /dev/block/platform/*/*/by-name/userdata /data/
77 25 Denis 'GNUtoo' Carikli
78 11 Denis 'GNUtoo' Carikli
79 27 Denis 'GNUtoo' Carikli
For the @Galaxy S II (GT-I9100)@ and the @Galaxy Note (GT-N7000)@, you can use the following command instead:
80 26 Denis 'GNUtoo' Carikli
81 23 Denis 'GNUtoo' Carikli
82 26 Denis 'GNUtoo' Carikli
mount /dev/block/platform/*/by-name/DATAFS /data/
83 23 Denis 'GNUtoo' Carikli
85 24 Denis 'GNUtoo' Carikli
And for the @Galaxy Tab 2 (GT-P31xx, GT-P51xx)@:
mount /dev/block/platform/*/*/by-name/DATAFS /data/
88 21 Denis 'GNUtoo' Carikli
89 4 Denis 'GNUtoo' Carikli
h2. Erase your contact database
92 36 Denis 'GNUtoo' Carikli
Once in the recovery, you will then be able to erase your contact database. 
93 1 Denis 'GNUtoo' Carikli
94 36 Denis 'GNUtoo' Carikli
For that you need to type this command to erase the contact database:
95 2 Denis 'GNUtoo' Carikli
96 1 Denis 'GNUtoo' Carikli
rm -rf /data/data/
97 36 Denis 'GNUtoo' Carikli
And this one to make the dialer not crash after startup:
101 22 Denis 'GNUtoo' Carikli
rm -rf /data/data/
102 1 Denis 'GNUtoo' Carikli
103 4 Denis 'GNUtoo' Carikli
104 15 Denis 'GNUtoo' Carikli
Once this is done you will need to umount the userdata partition. This can be done with the following command:
106 29 Denis 'GNUtoo' Carikli
umount /data/
107 15 Denis 'GNUtoo' Carikli
108 10 Denis 'GNUtoo' Carikli
109 4 Denis 'GNUtoo' Carikli
h2. Install the new Replicant images
110 1 Denis 'GNUtoo' Carikli
Once the backup is done, you can proceed to install the Replicant images that have the contact database format to migrate to.
112 19 Denis 'GNUtoo' Carikli
h2. Restoring your contacts from a file
115 37 Denis 'GNUtoo' Carikli
This part is a Work in progress.
First you need to launch the contact application again:
Then you end need to click on the "Import contacts" button on the bottom of the middle of the screen:
123 4 Denis 'GNUtoo' Carikli
h2. Revoke USB debugging permissions
If you don't need @USB debugging permissions@ anymore, it might be a good idea to remove them. The [[ADB#Revoking-all-computers-USB-debugging-permissions|Revoking all computer's USB debugging permissions]] section in the ADB wiki page explains how to do that.
128 17 Denis 'GNUtoo' Carikli
h2. Finally
130 16 Denis 'GNUtoo' Carikli
That's it! Your contacts database is now backed up.
131 17 Denis 'GNUtoo' Carikli
h2. Extra information
The file you backuped your contact in is in the "VCard": format. That format is a standard, and many other software are compatible with it.