From 6f6a6dadad69dadc93180877f59baeedebeb8bb2 Mon Sep 17 00:00:00 2001
From: P. J. McDermott <pehjota>
Date: Wed, 23 Jul 2014 16:57:10 -0400
Subject: doc/install/pc: New page
---
diff --git a/doc/install/pc.mdwn b/doc/install/pc.mdwn
new file mode 100644
index 0000000..5031f32
--- /dev/null
+++ b/doc/install/pc.mdwn
@@ -0,0 +1,399 @@
+[[!meta title="PC Installation Instructions"]]
+
+This guide explains how to use the interactive installer program distributed
+with miniprokit to install ProteanOS on a PC platform.
+
+
+Preparation
+===========
+
+Make sure you have a computer supported by ProteanOS. Currently, the Acer
+Aspire One AO751h and Dell Dimension 2400 are supported. If your computer is
+not supported, you can [[port_ProteanOS_to_run_on_it|doc/plat/porting]].
+
+Determine the devices from which your computer can boot. For example, the Acer
+Aspire One AO751h can boot from an internal PATA (a.k.a. IDE or ATA) drive or
+from a storage device connected over USB (e.g. a flash drive), while the Dell
+Dimension 2400 can only boot ProteanOS 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) or run
+a live GNU/Linux system on the computer on which you plan to install ProteanOS.
+
+Install Git if you don't already have it and clone the [miniprokit
+repository][miniprokit-git]:
+
+ git clone git://git.proteanos.com/miniprokit/miniprokit.git
+
+If you already have a copy of miniprokit, make sure it is up to date:
+
+ git pull origin master
+
+Note that you need the full repository, and not just the miniprokit.sh file.
+
+
+Installation
+============
+
+Run the `installers/pc.sh` script to begin the installation.
+
+Answer the installer's questions and it will install and configure ProteanOS for
+you.
+
+Sample Installation
+-------------------
+
+ Select a platorm
+ ================
+
+ Select a platform:
+ 1) Acer Aspire One AO751h
+ 2) Dell Dimension 2400
+ #? 2
+
+ Select a block device
+ =====================
+
+ Select a block device:
+ 1) SD32G (mmcblk0) - 31.49 GB (29.32 GiB)
+ 2) ATA WDC WD3200BEKT-6 (sda) - 320.07 GB (298.09 GiB)
+ 3) ST316021 5ACE (sdd) - 160.04 GB (149.05 GiB)
+ #? 3
+
+ Making partition table and file system
+ ======================================
+
+ 1+0 records in
+ 1+0 records out
+ 512 bytes (512 B) copied, 0.00984386 s, 52.0 kB/s
+ Device contains neither a valid DOS partition table, nor Sun, SGI or OSF disklabel
+ Building a new DOS disklabel with disk identifier 0x8a39a80e.
+ Changes will remain in memory only, until you decide to write them.
+ After that, of course, the previous content won't be recoverable.
+
+ Warning: invalid flag 0x0000 of partition table 4 will be corrected by w(rite)
+
+ Command (m for help): Partition type:
+ p primary (0 primary, 0 extended, 4 free)
+ e extended
+ Select (default p): Partition number (1-4, default 1): First sector (2048-312581807, default 2048): Using default value 2048
+ Last sector, +sectors or +size{K,M,G} (2048-312581807, default 312581807): Using default value 312581807
+
+ Command (m for help): Selected partition 1
+ Hex code (type L to list codes):
+ Command (m for help): Partition number (1-4):
+ Command (m for help): The partition table has been altered!
+
+ Calling ioctl() to re-read partition table.
+ Syncing disks.
+ mke2fs 1.42.9 (28-Dec-2013)
+ Filesystem label=
+ OS type: Linux
+ Block size=4096 (log=2)
+ Fragment size=4096 (log=2)
+ Stride=0 blocks, Stripe width=0 blocks
+ 9773056 inodes, 39072470 blocks
+ 1953623 blocks (5.00%) reserved for the super user
+ First data block=0
+ Maximum filesystem blocks=4294967296
+ 1193 block groups
+ 32768 blocks per group, 32768 fragments per group
+ 8192 inodes per group
+ Superblock backups stored on blocks:
+ 32768, 98304, 163840, 229376, 294912, 819200, 884736, 1605632, 2654208,
+ 4096000, 7962624, 11239424, 20480000, 23887872
+
+ Allocating group tables: done
+ Writing inode tables: done
+ Creating journal (32768 blocks): done
+ Writing superblocks and filesystem accounting information: done
+
+
+ Installing base system
+ ======================
+
+ Using architecture i686-linux-glibc
+ Using platform dimension2400
+ Using mirror http://mirror.gnu.dk/pub/proteanos
+ Setting up root...
+ Configuring opkg and retrieving Packages...
+ Downloading proteanos-branding...
+ Unpacking proteanos-branding...
+ Downloading libc-bin...
+ Unpacking libc-bin...
+ Downloading libc.6...
+ Unpacking libc.6...
+ Downloading libopkg.1...
+ Unpacking libopkg.1...
+ Downloading opkg...
+ Unpacking opkg...
+ Downloading base-files...
+ Unpacking base-files...
+ Downloading busybox...
+ Unpacking busybox...
+ Downloading linux-image...
+ Unpacking linux-image...
+ Configuring packages...
+ Package base-files (1.0.2) installed in root is up to date.
+ Package busybox (1.21.1-8) installed in root is up to date.
+ Package libc-bin (2.19~r25243+sip1-3) installed in root is up to date.
+ Package libc.6 (2.19~r25243+sip1-3) installed in root is up to date.
+ Package libopkg.1 (0.2.2-1) installed in root is up to date.
+ Package linux-image (3.10.48~gnu-1) installed in root is up to date.
+ Package opkg (0.2.2-1) installed in root is up to date.
+ Package proteanos-branding (0.1) installed in root is up to date.
+ Configuring libopkg.1.
+ Configuring opkg.
+ Configuring busybox.
+ update-alternatives: Linking //usr/bin/awk to /usr/bin/awk.busybox
+ update-alternatives: Linking //usr/bin/dc to /usr/bin/dc.busybox
+ update-alternatives: Linking //usr/bin/bzip2 to /usr/bin/bzip2.busybox
+ update-alternatives: Linking //usr/bin/bunzip2 to /usr/bin/bunzip2.busybox
+ update-alternatives: Linking //usr/bin/bzcat to /usr/bin/bzcat.busybox
+ update-alternatives: Linking //usr/bin/xz to /usr/bin/xz.busybox
+ update-alternatives: Linking //usr/bin/unxz to /usr/bin/unxz.busybox
+ update-alternatives: Linking //usr/bin/xzcat to /usr/bin/xzcat.busybox
+ update-alternatives: Linking //usr/bin/lzma to /usr/bin/lzma.busybox
+ update-alternatives: Linking //usr/bin/unlzma to /usr/bin/unlzma.busybox
+ update-alternatives: Linking //usr/bin/lzcat to /usr/bin/lzcat.busybox
+ update-alternatives: Linking //usr/bin/ar to /usr/bin/ar.busybox
+ update-alternatives: Linking //usr/bin/strings to /usr/bin/strings.busybox
+ update-alternatives: Linking //usr/bin/clear to /usr/bin/clear.busybox
+ update-alternatives: Linking //usr/bin/reset to /usr/bin/reset.busybox
+ update-alternatives: Linking //usr/bin/mkpasswd to /usr/bin/mkpasswd.busybox
+ Configuring base-files.
+ Configuring libc.6.
+ Configuring linux-image.
+ Configuring proteanos-branding.
+ Configuring libc-bin.
+
+ Configure the network
+ =====================
+
+ Network configuration method:
+ 1) Static
+ 2) DHCP
+ #? 2
+
+ Set up users and passwords
+ ==========================
+
+ Changing password for root
+ New password:
+ Bad password: too short
+ Retype password:
+ Password for root changed by root
+
+ Installing tzcode (2014c-1) on root.
+ Downloading http://mirror.gnu.dk/pub/proteanos/feeds/dev/trunk/i686-linux-glibc/all/base/../../../../../../pool/t/tzcode/tzcode_2014c-1_i686-linux-glibc_all.opk.
+ Installing tzdata (2014c-1) on root.
+ Downloading http://mirror.gnu.dk/pub/proteanos/feeds/dev/trunk/all/all/base/../../../../../../pool/t/tzdata/tzdata_2014c-1_all_all.opk.
+ Package tzdata (2014c-1) installed in root is up to date.
+ Installing tzdata-factory (2014c-1) on root.
+ Downloading http://mirror.gnu.dk/pub/proteanos/feeds/dev/trunk/all/all/base/../../../../../../pool/t/tzdata/tzdata-factory_2014c-1_all_all.opk.
+ Installing tzdata-northamerica (2014c-1) on root.
+ Downloading http://mirror.gnu.dk/pub/proteanos/feeds/dev/trunk/all/all/base/../../../../../../pool/t/tzdata/tzdata-northamerica_2014c-1_all_all.opk.
+ Installing tzdata-africa (2014c-1) on root.
+ Downloading http://mirror.gnu.dk/pub/proteanos/feeds/dev/trunk/all/all/base/../../../../../../pool/t/tzdata/tzdata-africa_2014c-1_all_all.opk.
+ Installing tzdata-etcetera (2014c-1) on root.
+ Downloading http://mirror.gnu.dk/pub/proteanos/feeds/dev/trunk/all/all/base/../../../../../../pool/t/tzdata/tzdata-etcetera_2014c-1_all_all.opk.
+ Installing tzdata-australasia (2014c-1) on root.
+ Downloading http://mirror.gnu.dk/pub/proteanos/feeds/dev/trunk/all/all/base/../../../../../../pool/t/tzdata/tzdata-australasia_2014c-1_all_all.opk.
+ Installing tzdata-europe (2014c-1) on root.
+ Downloading http://mirror.gnu.dk/pub/proteanos/feeds/dev/trunk/all/all/base/../../../../../../pool/t/tzdata/tzdata-europe_2014c-1_all_all.opk.
+ Installing tzdata-southamerica (2014c-1) on root.
+ Downloading http://mirror.gnu.dk/pub/proteanos/feeds/dev/trunk/all/all/base/../../../../../../pool/t/tzdata/tzdata-southamerica_2014c-1_all_all.opk.
+ Installing tzdata-antarctica (2014c-1) on root.
+ Downloading http://mirror.gnu.dk/pub/proteanos/feeds/dev/trunk/all/all/base/../../../../../../pool/t/tzdata/tzdata-antarctica_2014c-1_all_all.opk.
+ Installing tzdata-asia (2014c-1) on root.
+ Downloading http://mirror.gnu.dk/pub/proteanos/feeds/dev/trunk/all/all/base/../../../../../../pool/t/tzdata/tzdata-asia_2014c-1_all_all.opk.
+ Configuring tzdata.
+ Configuring tzdata-factory.
+ Configuring tzdata-northamerica.
+ Configuring tzdata-africa.
+ Configuring tzcode.
+ Configuring tzdata-etcetera.
+ Configuring tzdata-australasia.
+ Configuring tzdata-europe.
+ Configuring tzdata-southamerica.
+ Configuring tzdata-antarctica.
+ Configuring tzdata-asia.
+
+ Configure the time zone
+ =======================
+
+ Please identify a location so that time zone rules can be set correctly.
+ Please select a continent, ocean, "coord", or "TZ".
+ 1) Africa
+ 2) Americas
+ 3) Antarctica
+ 4) Arctic Ocean
+ 5) Asia
+ 6) Atlantic Ocean
+ 7) Australia
+ 8) Europe
+ 9) Indian Ocean
+ 10) Pacific Ocean
+ 11) coord - I want to use geographical coordinates.
+ 12) TZ - I want to specify the time zone using the Posix TZ format.
+ #? 2
+ Please select a country whose clocks agree with yours.
+ 1) Anguilla
+ 2) Antigua & Barbuda
+ 3) Argentina
+ 4) Aruba
+ 5) Bahamas
+ 6) Barbados
+ 7) Belize
+ 8) Bolivia
+ 9) Brazil
+ 10) Canada
+ 11) Caribbean Netherlands
+ 12) Cayman Islands
+ 13) Chile
+ 14) Colombia
+ 15) Costa Rica
+ 16) Cuba
+ 17) Curacao
+ 18) Dominica
+ 19) Dominican Republic
+ 20) Ecuador
+ 21) El Salvador
+ 22) French Guiana
+ 23) Greenland
+ 24) Grenada
+ 25) Guadeloupe
+ 26) Guatemala
+ 27) Guyana
+ 28) Haiti
+ 29) Honduras
+ 30) Jamaica
+ 31) Martinique
+ 32) Mexico
+ 33) Montserrat
+ 34) Nicaragua
+ 35) Panama
+ 36) Paraguay
+ 37) Peru
+ 38) Puerto Rico
+ 39) St Barthelemy
+ 40) St Kitts & Nevis
+ 41) St Lucia
+ 42) St Maarten (Dutch part)
+ 43) St Martin (French part)
+ 44) St Pierre & Miquelon
+ 45) St Vincent
+ 46) Suriname
+ 47) Trinidad & Tobago
+ 48) Turks & Caicos Is
+ 49) United States
+ 50) Uruguay
+ 51) Venezuela
+ 52) Virgin Islands (UK)
+ 53) Virgin Islands (US)
+ #? 49
+ Please select one of the following time zone regions.
+ 1) Eastern Time
+ 2) Eastern Time - Michigan - most locations
+ 3) Eastern Time - Kentucky - Louisville area
+ 4) Eastern Time - Kentucky - Wayne County
+ 5) Eastern Time - Indiana - most locations
+ 6) Eastern Time - Indiana - Daviess, Dubois, Knox & Martin Counties
+ 7) Eastern Time - Indiana - Pulaski County
+ 8) Eastern Time - Indiana - Crawford County
+ 9) Eastern Time - Indiana - Pike County
+ 10) Eastern Time - Indiana - Switzerland County
+ 11) Central Time
+ 12) Central Time - Indiana - Perry County
+ 13) Central Time - Indiana - Starke County
+ 14) Central Time - Michigan - Dickinson, Gogebic, Iron & Menominee Counties
+ 15) Central Time - North Dakota - Oliver County
+ 16) Central Time - North Dakota - Morton County (except Mandan area)
+ 17) Central Time - North Dakota - Mercer County
+ 18) Mountain Time
+ 19) Mountain Time - south Idaho & east Oregon
+ 20) Mountain Standard Time - Arizona (except Navajo)
+ 21) Pacific Time
+ 22) Alaska Time
+ 23) Alaska Time - Alaska panhandle
+ 24) Alaska Time - southeast Alaska panhandle
+ 25) Alaska Time - Alaska panhandle neck
+ 26) Alaska Time - west Alaska
+ 27) Aleutian Islands
+ 28) Metlakatla Time - Annette Island
+ 29) Hawaii
+ #? 1
+
+ The following information has been given:
+
+ United States
+ Eastern Time
+
+ Therefore TZ='America/New_York' will be used.
+ Local time is now: Wed Jul 23 12:42:06 EDT 2014.
+ Universal Time is now: Wed Jul 23 16:42:06 UTC 2014.
+ Is the above information OK?
+ 1) Yes
+ 2) No
+ #? 1
+
+ You can make this change permanent for yourself by appending the line
+ TZ='America/New_York'; export TZ
+ to the file '.profile' in your home directory; then log out and log in again.
+
+ Here is that TZ value again, this time on standard output so that you
+ can use the /usr/sbin/tzselect command in shell scripts:
+
+ Removing package tzcode from root...
+ Removing package tzdata-factory from root...
+ Removing package tzdata-africa from root...
+ Removing package tzdata-etcetera from root...
+ Removing package tzdata-australasia from root...
+ Removing package tzdata-europe from root...
+ Removing package tzdata-southamerica from root...
+ Removing package tzdata-antarctica from root...
+ Removing package tzdata-asia from root...
+ Installing lilo (24.0-2) on root.
+ Downloading http://mirror.gnu.dk/pub/proteanos/feeds/dev/trunk/i686-linux-glibc/all/base/../../../../../../pool/l/lilo/lilo_24.0-2_i686-linux-glibc_all.opk.
+ Installing config-lilo (1.2) on root.
+ Downloading http://mirror.gnu.dk/pub/proteanos/feeds/dev/trunk/all/dimension2400/base/../../../../../../pool/c/config-dimension2400/config-lilo_1.2_all_dimension2400.opk.
+ Installing config-dimension2400-common (1.2) on root.
+ Downloading http://mirror.gnu.dk/pub/proteanos/feeds/dev/trunk/all/all/base/../../../../../../pool/c/config-dimension2400/config-dimension2400-common_1.2_all_all.opk.
+ Configuring config-dimension2400-common.
+ Configuring config-lilo.
+ Configuring lilo.
+
+ Install the boot loader
+ =======================
+
+ Name of root partition on running system (e.g. "sda1"): sda1
+
+ Reading boot sector from /dev/sdd
+ Warning: /dev/sdd is not on the first disk
+ Warning: Unable to determine video adapter in use in the present system.
+ Using BITMAP secondary loader
+ Calling map_insert_data
+ Mapping bitmap file /boot/tuxlogo.bmp
+ Warning: Video adapter does not support VESA BIOS extensions needed for
+ display of 256 colors. Boot loader will fall back to TEXT only operation.
+ Calling map_insert_file
+
+ Boot image: /boot/vmlinuz
+ Added ProteanOS_1.0 *
+
+ Boot image: /boot/vmlinuz.old
+ Added ProteanOS_1.0_~
+
+ Boot image: /boot/vmlinuz
+ Added ProteanOS_1.0_+
+
+ Writing boot sector.
+ Backup copy of boot sector in /boot/boot.0830
+ 3 warnings were issued.
+
+ Installation complete!
+
+ Exiting...
+
+[miniprokit-git]: http://git.proteanos.com/miniprokit/miniprokit.git/
--
cgit v0.9.1