Project

General

Profile

GTA04Installation » History » Version 22

Wolfgang Wiedmeyer, 05/13/2017 05:52 PM
/media, not /mount is MOUNT_BASE

1 1 Paul Kocialkowski
h1. GTA04 Installation
2
3 13 Paul Kocialkowski
h2. Prerequisites
4
5 14 Paul Kocialkowski
In order to install Replicant on your device, it is assumed that you have a computer running a GNU/Linux operating system, a spare microSD card (at least 1GB) and everything necessary to connect the card to the computer. Moreover, it is assumed that anyone performing the installation knows how to use command lines in a terminal and has basic knowledge about it.
6 13 Paul Kocialkowski
7
h2. Downloading the files
8
9
The first step in the installation process is to download and set up the files that will be used to install Replicant to the device. The files must be downloaded on your computer first.
10
11
1. Find out what the latest image is: check out the @Last image@ part of the general table on [[GTA04]]
12
2. Download *all* the files listed for the device (including the checksum and the signatures) on [[ReplicantImages]] for the latest image
13
2. Make sure you have added the [[ReplicantReleaseKey|Replicant release key]] to your GPG keyring
14
3. Check the signature of the files:
15 1 Paul Kocialkowski
<pre>
16 21 Paul Kocialkowski
gpg --armor --verify path/to/replicant-4.2-gta04.zip.img.asc path/to/replicant-4.2-gta04.zip
17
gpg --armor --verify path/to/bootable.zip.asc path/to/bootable.zip
18
gpg --armor --verify path/to/replicant_gta04_install.sh.asc path/to/replicant_gta04_install.sh
19 13 Paul Kocialkowski
</pre>
20
4. Make sure the check succeeds, *do not install anything if it doesn't*!
21
5. Check the checksum of the files:
22
<pre>
23 1 Paul Kocialkowski
md5sum -c gta04.md5
24
</pre>
25
6. Make sure the check succeeds, *do not install anything if it doesn't*!
26 9 Paul Kocialkowski
27 17 Paul Kocialkowski
h2. Installing ADB
28
29
In order to install Replicant from the device using sideload, the ADB tool has to be installed on the host computer.
30
31
Instructions to install ADB: [[ToolsInstallation#ADB|ToolsInstallation]]
32
33 14 Paul Kocialkowski
h2. Preparing the microSD card
34 1 Paul Kocialkowski
35 14 Paul Kocialkowski
In order to install Replicant on the microSD card, it has to be set up with the base bootable files first:
36 1 Paul Kocialkowski
37 14 Paul Kocialkowski
1. Connect the microSD card to the computer (e.g. using an USB card reader)
38 15 Paul Kocialkowski
2. Make sure that the @bootable.zip@ file is placed within the same directory as the @replicant_gta04_install.sh@ script
39
   (or change the @FILES_BASE@ variable in the script to the correct path)
40 22 Wolfgang Wiedmeyer
3. Make sure that the @/media@ directory exists and can be used for creating @boot@, @system@, @cache@ and @data@ sub-folders
41 15 Paul Kocialkowski
   (or change the @MOUNT_BASE@ variable in the script to the correct path)
42 14 Paul Kocialkowski
4. Setup the card using the installation script (you can provide the block device node as a second argument):
43 9 Paul Kocialkowski
<pre>
44 14 Paul Kocialkowski
./replicant_gta04_install.sh setup
45 5 Paul Kocialkowski
</pre>
46 14 Paul Kocialkowski
*Note: you might want to run this command as root, since operations will fail with an unprivileged user!*
47
5. If you didn't provide the block device node, select which device to use for installation
48 18 Paul Kocialkowski
6. Confirm that you want to proceed with the installation
49
7. The script should report that the process was completed and that the card can be removed
50
8. Disconnect the microSD card from the computer
51 5 Paul Kocialkowski
52 14 Paul Kocialkowski
h2. Installing the system
53 1 Paul Kocialkowski
54 14 Paul Kocialkowski
Once the microSD card is prepared, it is possible to insert it in the phone though no system is installed yet. It is possible to install Replicant either from the host computer or from the device.
55 8 Paul Kocialkowski
56 14 Paul Kocialkowski
h3. From the host computer
57 5 Paul Kocialkowski
58 14 Paul Kocialkowski
1. Connect the microSD card back to the computer (e.g. using an USB card reader)
59 16 Paul Kocialkowski
2. Make sure that the @replicant-4.2-gta04.zip@ file is placed within the same directory as the @replicant_gta04_install.sh@ script
60
   (or change the @FILES_BASE@ variable in the script to the correct path)
61 22 Wolfgang Wiedmeyer
3. Make sure that the @/media@ directory exists and can be used for creating @boot@, @system@, @cache@ and @data@ sub-folders
62 16 Paul Kocialkowski
   (or change the @MOUNT_BASE@ variable in the script to the correct path)
63 14 Paul Kocialkowski
4. Install the system to the card using the installation script (you can provide the block device node as a second argument):
64 5 Paul Kocialkowski
<pre>
65
./replicant_gta04_install.sh install
66
</pre>
67 14 Paul Kocialkowski
*Note: you might want to run this command as root, since operations will fail with an unprivileged user!*
68
5. If you didn't provide the block device node, select which device to use for installation
69 19 Paul Kocialkowski
6. Confirm that you want to proceed with the installation
70
7. The script should report that the process was completed and that the card can be removed
71
8. Disconnect the microSD card from the computer
72
9. Insert the microSD card in the device and power the device on: the device should boot normally (the power light should stay orange for a short time and then switch green)
73 6 Paul Kocialkowski
74 14 Paul Kocialkowski
*Your device should now be running Replicant!*
75 6 Paul Kocialkowski
76 14 Paul Kocialkowski
h3. From the device
77 6 Paul Kocialkowski
78 20 Paul Kocialkowski
1. Insert the microSD card in the device and power the device on: the device should boot normally (the aux light should stay orange for a short time and then switch green)
79 14 Paul Kocialkowski
2. Make sure the device boots to recovery
80
3. Connect the USB cable to both the computer and the device
81
4. Select *install zip* (using the AUX key to navigate and the power key to select)
82
5. Select *install zip from sideload*
83
5. Back to the host computer, load the system zip with sideload:
84 6 Paul Kocialkowski
<pre>
85 14 Paul Kocialkowski
adb sideload path/to/replicant-4.2-gta04.zip
86 6 Paul Kocialkowski
</pre>
87 14 Paul Kocialkowski
6. Make sure the file is being transfered
88
7. Select *Go Back* (if necessary) to get back to the general menu
89
8. Select *wipe data/factory reset*
90
9. Confirm the data wipe by selecting *Yes -- delete all user data*
91
10. Select *Reboot system now* to reboot the device
92 6 Paul Kocialkowski
93 14 Paul Kocialkowski
*Your device should now be running Replicant!*