Project

General

Profile

Installation » History » Version 10

Denis 'GNUtoo' Carikli, 05/11/2019 06:53 PM
Also wipe data and cache partitions, as install fails in certain cases without that

1 1 Denis 'GNUtoo' Carikli
h1. ReplicantInstallation
2
3
h2. Backup your data
4
5
Before attempting to install Replicant, you need to backup everything you can from the device as most of the data will be erased during the installation.
6
7
You can skip this step if you have no data you want to keep.
8
9 7 Denis 'GNUtoo' Carikli
h2. Installation overview
10 1 Denis 'GNUtoo' Carikli
11
The installation of Replicant is several steps:
12
* First you install a Replicant recovery. It's a very minimalist operating system that is dedicated to the installation of Replicant.
13
* Then you download Replicant and use the recovery to install it.
14
15
h2. Recovery installation
16
17
To install the Replicant recovery, follow the instructions on the [[RecoveryInstallationWithHeimdall|Recovery installation with Heimdall]] wiki page.
18
19 10 Denis 'GNUtoo' Carikli
h2. Wipe the existing system, cache and data partitions
20 9 Denis 'GNUtoo' Carikli
21 10 Denis 'GNUtoo' Carikli
Once this is done, you then need to wipe the existing system, cache and data partitions. This is to ensure that the partitions are formatted correctly.
22 9 Denis 'GNUtoo' Carikli
23 10 Denis 'GNUtoo' Carikli
To wipe the system partition, once you are in the recovery:
24 1 Denis 'GNUtoo' Carikli
1. Select Advanced
25
2. Select Wipe system partition
26 10 Denis 'GNUtoo' Carikli
3. It will ask you to confirm the wipe, so you will need to select Yes to confirm it.
27
4. Press the back key to get back to the general menu
28
29
To then wipe the cache and data partitions:
30
1. Select Factory reset
31
2. Select Wipe data (keep media)
32 9 Denis 'GNUtoo' Carikli
3. It will ask you to confirm the wipe, so you will need to select Yes to confirm it.
33
4. Press the back key to get back to the general menu
34
35 1 Denis 'GNUtoo' Carikli
h2. Using the recovery to install Replicant
36
37 4 Denis 'GNUtoo' Carikli
Installing Replicant can be done either by:
38
* [[InstallOrUpgradeReplicantWithoutAComputer|downloading the installation files the device, without the need of a computer]]
39
* [[InstallOrUpgradeReplicantFromMicroSD|using a computer and a microSD]]
40
* [[InstallOrUpgradeReplicantFromInternalStorage|using a computer and the internal storage to store the installation files]]
41 1 Denis 'GNUtoo' Carikli
42
Once this is done, you will need to do a factory reset.
43
44
h2. Factory reset
45
46
To do a Factory reset, you need to be in the recovery.
47
48
1. Select Factory reset
49
2. Select Wipe data (keep media)
50
3. It will ask you to confirm the wipe, so you will need to select Yes to confirm it.
51
4. Press the back key to get back to the general menu
52 6 Denis 'GNUtoo' Carikli
53
h2. Reboot the device
54
55
Once the factory reset is done, you can then reboot the device.
56
57
In the recovery:
58
1. Select Reboot system now to reboot the device
59 1 Denis 'GNUtoo' Carikli
2. Your device now has Replicant installed!
60 7 Denis 'GNUtoo' Carikli
61
h2. Backup the EFS
62
63
Now that Replicant is installed, it's a good idea to do a backup of the EFS partition which has the modem data.
64
65
Only the following devices that are supported by Replicant have an EFS:
66
* Galaxy S 2 (I9100)
67
* Galaxy S 3 (I9300)
68
* Galaxy S 3 4G (I9305)
69
* Galaxy Nexus (I9250)
70
* Galaxy Note (N7000)
71
* Galaxy Note 2 (N7100)
72
* Galaxy Tab 2 7.0 (P3100)
73
* Galaxy Tab 2 10.1 (P5100)
74
* Galaxy Note 8.0 (N5100)
75
76
First make sure that you have adb setup correctly and that it gives you a root shell on the device by following the wiki page that explains how to [[ADB|install adb and get a root shell]] on your device.
77
78
Once this is done you can then backup the EFS.
79
80
For the Galaxy SIII (I9300), run the following commands to do that:
81
<pre>
82
mkdir backup_efs
83 8 Denis 'GNUtoo' Carikli
cd backup_efs
84 7 Denis 'GNUtoo' Carikli
adb pull /efs/ efs
85
adb shell "cat /dev/block/platform/*/by-name/EFS" > EFS.img 
86
</pre>
87
88
This will create a copy of the contents of /efs in the backup_efs directory. It will also backup the full partition.
89
Keep these files around as a backup in case anything goes wrong.