From 6f6a6dadad69dadc93180877f59baeedebeb8bb2 Mon Sep 17 00:00:00 2001 From: P. J. McDermott 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