summaryrefslogtreecommitdiffstats
path: root/doc/install/pc.mdwn
blob: 8d887fc8efbe5c744d7e8d621a652e845bd5d065 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
[[!meta title="PC Installation"]]

[[←_Back_to_Installing_ProteanOS|doc/install]]

This guide explains how to use the interactive installer program distributed
with prokit, the ProteanOS Development Kit, to install ProteanOS on a PC
platform.

It is assumed that you have already
[[built_and_optionally_installed_prokit|doc/install/prokit]].


Preparation
===========

Make sure you have a computer supported by ProteanOS.  If your computer is not
supported, you can [[port_ProteanOS_to_run_on_it|doc/plat/porting]].  Currently
supported are:

  * Acer Aspire One AO751h (architecture `i686-linux-glibc`, platform `ao751h`)
  * Dell Dimension 2400 (architecture `i686-linux-glibc`, platform
    `dimension2400`)
  * Lenovo ThinkPad X60, X60s, X60t, T60 (architecture `i686-linux-glibc`,
    platform `x60`)
  * Lenovo ThinkPad X200, X200s, X200 Tablet, R400, T400, R500, T500, etc.
    (architecture `i686-linux-glibc`, platform `x60`)
  * Libiquity Taurinus X200 and Gluglug Libreboot X200 (architecture
    `i686-linux-glibc`, platform `x60`)

Determine the devices from which your computer can boot.  For example, the Acer
Aspire One AO751h can boot from an internal 2.5" SATA drive or from a storage
device connected over USB (e.g. a flash drive), while the Dell Dimension 2400
can only boot from an internal PATA drive.

Pick a storage device on which you want to install ProteanOS and connect it to
the computer on which you plan to run the installer.  You can either connect the
device to a different computer (easiest in the case of a USB flash drive, while
an HDD or SSD would require a SATA/PATA-to-USB adapter) or run a live GNU/Linux
system on the computer on which you plan to install ProteanOS.


Installation
============

Decide which "suite" of ProteanOS you wish to install.  `rel/trunk` is a rolling
release that receives updates free of known new bugs; it is recommended for
regular users.  `dev/trunk` receives direct package uploads and should be used
by ProteanOS developers.

If you installed prokit to your system, run:

    $ sudo prokit installer-pc -a $arch -p $plat $suite $device

Otherwise, from your prokit build directory, run:

    $ sudo ./prokit installer-pc -a $arch -p $plat $suite $device

Replace `$arch` with the architecture (e.g. `i686-linux-glibc`), `$plat` with
the platform (e.g. `x60`), and `$device` with the device file name (e.g.
`/dev/sdb`).  Make sure you've selected the right device; prokit will erase the
partition table and write a new file system on the device you specify!