mirror of
https://gitlab.archlinux.org/tpowa/archboot.git
synced 2024-09-20 03:50:37 +02:00
remove old docs
This commit is contained in:
parent
9911e6ee20
commit
948bd3f1f9
3 changed files with 0 additions and 464 deletions
|
@ -107,14 +107,6 @@ _prepare_kernel_initramfs_files() {
|
|||
|
||||
}
|
||||
|
||||
_prepare_other_files() {
|
||||
|
||||
# move in doc
|
||||
mkdir -p "${X86_64}/arch/"
|
||||
mv "${CORE64}"/*/arch/archboot.txt "${X86_64}/arch/"
|
||||
|
||||
}
|
||||
|
||||
_prepare_prebootloader_uefi () {
|
||||
mkdir -p "${X86_64}/EFI/BOOT"
|
||||
cp -f "/usr/share/efitools/efi/PreLoader.efi" "${X86_64}/EFI/BOOT/BOOTX64.EFI"
|
||||
|
@ -315,8 +307,6 @@ GRUBEOF
|
|||
|
||||
}
|
||||
|
||||
_prepare_other_files
|
||||
|
||||
_prepare_lockdown_ms_uefi
|
||||
|
||||
_prepare_prebootloader_uefi
|
||||
|
|
|
@ -6,11 +6,6 @@ build ()
|
|||
! [ -d "${TEMPDIR}/arch/" ] && mkdir -p ${TEMPDIR}/arch/
|
||||
add_file "/usr/share/archboot/installer/setup" "/arch/setup"
|
||||
add_file "/usr/share/archboot/installer/quickinst" "/arch/quickinst"
|
||||
DOCS=$(mktemp /var/tmp/docs.XXXX)
|
||||
cp -f /usr/share/archboot/installer/archboot.txt ${DOCS}
|
||||
gzip -9 ${DOCS}
|
||||
add_file "${DOCS}.gz" "/arch/archboot.txt.gz"
|
||||
cp /usr/share/archboot/installer/archboot.txt ${TEMPDIR}/arch/archboot.txt
|
||||
add_file "/usr/bin/genfstab"
|
||||
add_file "/usr/bin/arch-chroot"
|
||||
add_file "/usr/bin/pacstrap"
|
||||
|
|
|
@ -1,449 +0,0 @@
|
|||
|
||||
Archboot Guide
|
||||
|
||||
September, 10th 2021
|
||||
|
||||
Tobias Powalowski <tpowa@archlinux.org>
|
||||
|
||||
Contributors (Parts from old Arch Linux Installation Guide):
|
||||
Dennis Herbrich <dennis@archlinux.org>
|
||||
Judd Vinet <judd@archlinux.org>
|
||||
|
||||
Table Of Contents
|
||||
|
||||
1. Introduction
|
||||
1. What is Arch Linux?
|
||||
2. What is Archboot
|
||||
3. What is the difference to the archiso install media?
|
||||
4. What are the supported boot modes of Archboot media?
|
||||
5. How to do a remote installation with ssh?
|
||||
6. What are the Archboot Setup features?
|
||||
2. Installing Arch Linux with Archboot
|
||||
1. What you will need?
|
||||
2. Acquiring Archboot images
|
||||
3. Preparing Installation Media
|
||||
4. Booting the Install Media
|
||||
3. Common Installation Procedure
|
||||
1. Running Setup
|
||||
2. Set Keyboard And Console Font
|
||||
3. Set up Network
|
||||
4. Set Time And Date
|
||||
5. Prepare Storage Drive
|
||||
1. Auto-Prepare
|
||||
2. Partition Storage Drives
|
||||
3. Create Software Raid, Lvm2 or Luks encryption
|
||||
4. Set Filesystem Mountpoints
|
||||
6. Select Source
|
||||
7. Select Packages
|
||||
8. Install Packages
|
||||
9. Configure System
|
||||
10. Install Bootloader
|
||||
11. Exit Install
|
||||
4. System Configuration
|
||||
5. Useful links
|
||||
|
||||
Introduction
|
||||
|
||||
What is Arch Linux?
|
||||
|
||||
https://www.archlinux.org
|
||||
|
||||
What is Archboot?
|
||||
|
||||
* Archboot is a set of scripts to generate bootable media for CD/USB/PXE.
|
||||
* It is designed for installation or rescue operation.
|
||||
* It only runs in RAM, without any special filesystems like squashfs,
|
||||
thus it is limited to the RAM which is installed in your system.
|
||||
* Git repository:
|
||||
https://projects.archlinux.org/?p=archboot.git;a=summary
|
||||
* It is developed by tpowa.
|
||||
|
||||
What is the difference to the archiso install media?
|
||||
|
||||
* It provides an additional interactive setup and quickinst script.
|
||||
* It runs a modified Arch Linux system in initramfs.
|
||||
* It is restricted to RAM usage, everything which is not necessary like
|
||||
man or info pages etc. is not provided.
|
||||
* It doesn't mount anything during boot process.
|
||||
* It supports remote installation through ssh.
|
||||
* It uses netctl for network setup.
|
||||
|
||||
What are the supported boot modes of Archboot media?
|
||||
* It supports BIOS booting with syslinux.
|
||||
* It supports UEFI/UEFI_CD booting with systemd-boot and EFISTUB.
|
||||
* It support UEFI_MIX_MODE booting with grub.
|
||||
* It supports Secure Boot with prebootloader.
|
||||
* It supports grub(2)'s iso loopback support.
|
||||
variables used (below for example):
|
||||
iso_loop_dev=PARTUUID=XXXX
|
||||
iso_loop_path=/blah/archboot.iso
|
||||
<example-code>
|
||||
menuentry "Archboot" --class iso {
|
||||
loopback loop (hdX,X)/<archboot.iso>
|
||||
linux (loop)/boot/vmlinuz_x86_64 iso_loop_dev=/dev/sdXX
|
||||
iso_loop_path=/<archboot.iso>
|
||||
initrd (loop)/boot/initramfs_x86_64.img
|
||||
}
|
||||
</example-code>
|
||||
* It supports booting using syslinux's memdisk (only in BIOS mode).
|
||||
<example-code>
|
||||
menuentry "Archboot Memdisk" {
|
||||
linux16 /memdisk iso
|
||||
initrd16 hd(X,X)/<archboot.iso>}
|
||||
</example-code>
|
||||
|
||||
How to do a remote installation with ssh?
|
||||
* During boot all network interfaces will try to obtain an IP address
|
||||
through dhcp.
|
||||
* root password is not set by default!
|
||||
If you need privacy during installation set a password.
|
||||
# ssh root@<yourip>
|
||||
|
||||
What are the Archboot Setup features?
|
||||
|
||||
* Network installation mode
|
||||
* Changing keymap and consolefont
|
||||
* Changing time and date
|
||||
* Setup network with netctl
|
||||
* Preparing storage disk, like auto-prepare, partitioning,
|
||||
GUID (gpt) support, 4k sector drive support etc.
|
||||
* Creation of software raid/raid partitions, lvm2 devices and
|
||||
luks encrypted devices
|
||||
* Supports standard linux,raid/raid_partitions,dmraid/fakeraid,lvm2
|
||||
and encrypted devices
|
||||
* Filesystem support: ext2/3/4,btrfs,nilfs2,f2fs,reiserfs,
|
||||
xfs,jfs,ntfs-3g,vfat
|
||||
* Name scheme support: PARTUUID, PARTLABEL, FSUUID, FSLABEL and KERNEL
|
||||
* Mount support of grub(2) loopback and memdisk installation media
|
||||
* Package selection support
|
||||
* Signed package installation
|
||||
* hwdetect script is used for preconfiguration
|
||||
* Auto/Preconfiguration of fstab, kms mode, ssd,
|
||||
mkinitcpio.conf, systemd, crypttab and mdadm.conf
|
||||
* Configuration of basic system files
|
||||
* Setting root password
|
||||
* Bootloader support: grub(2) (BIOS and UEFI),
|
||||
refind, systemd-boot, syslinux (BIOS and UEFI)
|
||||
|
||||
Installing Arch Linux with Archboot
|
||||
|
||||
What you will need?
|
||||
|
||||
* a working knowledge of Linux and your system, especially your
|
||||
hardware
|
||||
* Archboot installation media
|
||||
* an x86-64 computer
|
||||
* some time to kill
|
||||
|
||||
Acquiring Archboot images
|
||||
|
||||
You can download Archboot images from any Arch Linux mirror:
|
||||
eg. https://downloads.archlinux.de/iso/archboot/
|
||||
|
||||
Preparing Installation Media
|
||||
|
||||
* Hybrid image file is provided.
|
||||
Please check md5sum before using it.
|
||||
* Can be burned to CD(RW) media using most CD-burning utilities.
|
||||
* Can be raw-written to a drive using 'dd' or similar utilities.
|
||||
This method is intended for use with USB thumb drives.
|
||||
|
||||
Booting the Install Media
|
||||
|
||||
Reboot your computer with the Arch Linux Archboot CD in the drive.
|
||||
Make sure your BIOS is set in a way to allow booting from your CD-ROM or
|
||||
USB device. Refer to your motherboard manual or your system manufacturer
|
||||
for details if you have no clue how to do that.
|
||||
Once the CD or USB is booted from, you will see a boot prompt waiting for
|
||||
you pressing a key or wait 30 seconds, explaining what your options are at
|
||||
this point. Most users can just hit Enter.
|
||||
|
||||
At the end of the boot procedure, you should be dropped into a root
|
||||
shell with a handful of instructions filling the upper half of your
|
||||
screen. At this point you are ready to commence the actual
|
||||
installation, or do any manual preparation you consider necessary.
|
||||
|
||||
Common Installation Procedure
|
||||
|
||||
Running Setup
|
||||
|
||||
On first login /arch/setup is launched automatically. After an
|
||||
informational message you will be prompted to the main menu.
|
||||
|
||||
When navigating the setup script, make sure that you select DONE from
|
||||
the submenus after performing each step. This saves any settings you
|
||||
make in preparation for the next step. Further, avoid arbitrary steps
|
||||
through the installation process as this can also confuse the
|
||||
installer.
|
||||
|
||||
At any point in the install process, you can switch to your 7th
|
||||
virtual console (ALT-F7) to view the output from the commands the
|
||||
setup is running. Use (ALT-F1) to get back to your first console where
|
||||
the installer is running, and any F-key in between if you need to open
|
||||
another console to intervene manually for any reason.
|
||||
|
||||
Set Keyboard And Console Font
|
||||
|
||||
Use this menu to change your keyboard to your desired keymap
|
||||
and console font.
|
||||
|
||||
Set up Network
|
||||
|
||||
Use this menu to configure your network.
|
||||
|
||||
Set Time And Date
|
||||
|
||||
Use this menu to change time and date of your running system.
|
||||
|
||||
Prepare Storage Drive
|
||||
|
||||
Prepare Storage Drive will lead you into a submenu offering two
|
||||
alternatives of preparing your target drive for installation.
|
||||
|
||||
The first choice is Auto-Prepare, which will automatically partition
|
||||
your storage drive into a /boot, swap, and root partition, and then
|
||||
create filesystems on all three. These partitions will also be
|
||||
automatically mounted in the proper place. To be exact, this option
|
||||
will create:
|
||||
* a /boot ext2 partition
|
||||
* a swap partition
|
||||
* a root partition
|
||||
* a /home partition with the remaining space
|
||||
|
||||
AUTO-PREPARE WILL ERASE ALL DATA ON THE CHOSEN STORAGE DRIVE!
|
||||
Read the warning presented by the installer very carefully, and make
|
||||
sure the correct device is about to be partitioned!
|
||||
|
||||
You will be asked if you want to use GUID (gpt) partition table.
|
||||
If you have no clue for what you will need it or plan to use grub(2),
|
||||
it's save to answer no.
|
||||
|
||||
You will be asked if you want to use UUID for device name scheme.
|
||||
It is recommended to use UUID, in order to avoid name collisions or
|
||||
name switching of devices.
|
||||
|
||||
If you prefer to do the partitioning manually, use the other two
|
||||
options, Partition Storage Drives and Set Filesystem Mountpoints to
|
||||
prepare the target media according to your specifications as outlined
|
||||
below. Then Return to Main Menu after a successful preparation.
|
||||
|
||||
Partition Storage Drives
|
||||
|
||||
You will be asked if you want to use GUID (gpt) partition table.
|
||||
If you have no clue for what you will need it or plan to use grub(2),
|
||||
it's save to answer no.
|
||||
|
||||
You should select the disk(s) you want to partition, and
|
||||
you'll be dropped into the cfdisk program where you can freely modify
|
||||
the partitioning information.
|
||||
|
||||
You will need at least a root partition to continue the installation,
|
||||
and it's helpful to note somewhere which partition you're going to
|
||||
mount where, as you'll be asked exactly that in the next step.
|
||||
|
||||
Create Software Raid, Lvm2 or Luks encryption
|
||||
|
||||
Use this menu for the mentioned above special devices.
|
||||
Help is provided in each submenu.
|
||||
|
||||
Set Filesystem Mountpoints
|
||||
|
||||
You should select this choice once the partition information is edited
|
||||
to your liking with the previous menu selection, or already existent through
|
||||
whatever other means.
|
||||
|
||||
You will be asked if you want to use UUID for device name scheme.
|
||||
It is recommended to use UUID, in order to avoid name collisions or
|
||||
name switching of devices.
|
||||
|
||||
The first question to answer is what partition to use as swap. Select
|
||||
the previously created swap partition from the list, or NONE, if you
|
||||
don't want to use a swap partition. Using a swap file is not directly
|
||||
supported by the installer; Instead choose NONE here, finish the
|
||||
mountpoint associations, and activate a swap file on your desired,
|
||||
formatted partition with the swapon command.
|
||||
|
||||
After setting up the swap partition, you'll be asked to specify the
|
||||
partition to be used as the root partition. This is mandatory.
|
||||
|
||||
The association process is then repeated until you choose DONE from
|
||||
the list, ideally after all listed partitions have been associated
|
||||
with their intended mountpoints. The installer will suggest /boot for
|
||||
all following mountpoints after choosing swap and root.
|
||||
|
||||
Every time you specify a partition to mount, you will be asked if you
|
||||
want to create a filesystem on the respective partition. If you select
|
||||
YES, you will be asked what filesystem to create (a matter of taste,
|
||||
really. Choose ext4 if you have no clue), and the partition will be
|
||||
formatted with the chosen filesystem, destroying all data in the
|
||||
process. It should be no problem, however, to say NO at this point to
|
||||
preserve any existing files on the partition.
|
||||
|
||||
If you want to preserve existing data on a partition, you are strongly
|
||||
advised to create backups instead of hoping that nothing will go wrong
|
||||
during the install. Don't say I didn't warn you!
|
||||
|
||||
You will be asked whether to create a filesystem on your swap
|
||||
partition, and since this partition uses a specific filesystem of it's
|
||||
own, you should always answer YES here.
|
||||
|
||||
If you want to mount any other partitions, for example a separate
|
||||
/boot or /home partition, you will be able to do so. Simply
|
||||
* select a partition to mount
|
||||
* choose a filesystem (if you want to create one instead of keeping
|
||||
the data)
|
||||
* enter a unique mountpoint for the partition
|
||||
|
||||
Repeat these steps until you're satisfied, then select DONE to create
|
||||
any filesystems and mount the partitions in their respective places.
|
||||
Before the actual formatting is done, the installer will present a list
|
||||
of all of your choices for review. After formatting and mounting all
|
||||
partitions, you may return to the Main Menu and proceed with the next step.
|
||||
|
||||
Select Source
|
||||
|
||||
Please note that you will probably run into trouble if you have a
|
||||
complex proxy setup with authentication when using the NETWORK
|
||||
installation.
|
||||
|
||||
Choose Mirror (NETWORK method)
|
||||
|
||||
You need to select a mirror for installing the packages, else the NETWORK
|
||||
installation will not work.
|
||||
|
||||
Select Packages
|
||||
|
||||
Select Packages will let you select the packages you wish to install
|
||||
from the media or your mirror.
|
||||
|
||||
Whatever source you chose, after fetching the package list you'll be
|
||||
dropped into the package category selection screen.
|
||||
|
||||
If you are presented an error while fetching the package database, you
|
||||
should either choose another mirror, make sure your network is
|
||||
working at all, and you didn't slip any typos into your custom server
|
||||
address. You might also have goofed mounting of your source media in
|
||||
the /src directory, if you chose that option. Read the messages
|
||||
presented to you carefully, in most cases all you need is a little
|
||||
tweaking of the directory layout on your source media or server,
|
||||
respectively.
|
||||
|
||||
Now, once that is tackled, you have the opportunity to specify whole
|
||||
package groups from which you'd generally like to install packages,
|
||||
then fine-tune your coarse selection by (de)selecting individual
|
||||
packages from the groups you have chosen.
|
||||
|
||||
Any packages in the BASE category should stay selected under all
|
||||
circumstances, and you should select any other group which contains a
|
||||
package you might need. Please note that the upcoming individual
|
||||
package selection screen will only offer packages which are in the
|
||||
categories you select here, so if you only select BASE, you won't be
|
||||
able to add any other packages than those in the BASE category.
|
||||
|
||||
If you want to only select the bare minimum for installation, but be
|
||||
able to browse through all available packages nevertheless to see if
|
||||
anything interesting is there to add, you should select all package
|
||||
categories, but choose to NOT select all packages by default.
|
||||
|
||||
The "Select all packages by default?" question can be easily
|
||||
misunderstood; Basically you are asked whether you want all the
|
||||
packages in the categories you just chose to be selected or not.
|
||||
If you select YES, the whole list of packages contained in the chosen
|
||||
categories will be displayed and selected, and your job will be to
|
||||
deselect what you do not want.
|
||||
If you select NO, the same list of packages will displayed, but only
|
||||
packages of the BASE category will be selected, and you'll have to
|
||||
explicitly select any other packages you want to install.
|
||||
|
||||
Choosing NO helps to install a lean system!
|
||||
|
||||
It is recommended that you install all the BASE packages, but not
|
||||
anything else at this point. Don't worry about getting all the
|
||||
packages you want - you can easily install more of them once the basic
|
||||
system boots by itself.
|
||||
|
||||
Once you're done selecting the packages you need, leave the selection
|
||||
screen and continue to the next step, Install Packages.
|
||||
|
||||
Install Packages
|
||||
|
||||
Install Packages will now install pacman and any other packages you
|
||||
selected with resolved dependencies onto your storage disk. Don't be
|
||||
surprised if more packages are installed than you selected! Those
|
||||
packages are dependencies for your selection, and the installer will
|
||||
not explicitly ask for permission to install these extra packages, as
|
||||
it assumes you know what you're doing.
|
||||
|
||||
Error messages and debugging output is echoed as usual to terminal
|
||||
five (ALT-F7). During normal, successful operation, you shouldn't find
|
||||
much to read there, though. After the packages have been installed,
|
||||
proceed to the next step, Configure System.
|
||||
|
||||
The media includes the latest kernel at the time the image was made.
|
||||
If you are using the NETWORK Installation method, the kernel about to be
|
||||
installed will be the current version waiting on your NETWORK source,
|
||||
and might therefore introduce changes and/or incompatibilities unknown
|
||||
at the present time. This is unlikely, but keep this in mind.
|
||||
|
||||
Configure System
|
||||
|
||||
Configure System allows you to edit the configuration files crucial
|
||||
for your newly installed system. Initially you will be asked whether
|
||||
to allow the hwdetect script to try and detect your hardware, and
|
||||
produce some (even more) sensible defaults for your configuration
|
||||
files. Unless you're having problems/crashes, you should let it have
|
||||
it's way, and work from what it generates.
|
||||
|
||||
After this automatic preconfiguration you'll be asked for your
|
||||
favorite editor to use for manually fine-tuning the generated
|
||||
configuration files, either VIM or nano. When in doubt, choose nano.
|
||||
|
||||
If you're in a real hurry, you may skip the following step of
|
||||
reviewing the configuration entirely and hope the defaults will work
|
||||
for you, but it's strongly recommended to iterate through the list of
|
||||
configuration files presented here and review the settings carefully.
|
||||
|
||||
Install Bootloader
|
||||
|
||||
Choose the bootloader you want to use, if you are unsure which one to use
|
||||
choose grub(2) bootloader.
|
||||
|
||||
Exit Install
|
||||
|
||||
Remove the media from your computer, type reboot at the
|
||||
command line and cross your fingers!
|
||||
|
||||
Congratulations! Now you can proceed to getting into the nitty-gritty of
|
||||
configuring the interesting parts of your system, and adapt it to your
|
||||
needs!
|
||||
|
||||
System Configuration
|
||||
|
||||
If you need help configuring a specific service, please read the
|
||||
appropriate manpage or refer to any online documentation you need.
|
||||
In many cases, the Archlinux Wiki and forums are a rich source for
|
||||
help as well.
|
||||
|
||||
Arch Linux does not use any abstraction layers to administrate your
|
||||
system. As a result, you can usually stick to any instructions
|
||||
published by the author of a software, or whatever you find in a
|
||||
search engine of your choice, and it'll work out without confusing
|
||||
your system, because your system just does not care.
|
||||
|
||||
Useful links
|
||||
|
||||
Archboot resourses
|
||||
Developer: Tobias Powalowski <tpowa@archlinux.org>
|
||||
Latest version: http://mirror.rackspace.com/archlinux/iso/archboot/latest
|
||||
Git repository: https://gitlab.archlinux.org/tpowa/archboot/
|
||||
Wiki entry: https://wiki.archlinux.org/title/Archboot
|
||||
|
||||
Arch Linux resources
|
||||
Homepage: https://www.archlinux.org
|
||||
Wiki: https://wiki.archlinux.org
|
||||
Forum: https://bbs.archlinux.org
|
||||
Bugtracker: https://bugs.archlinux.org
|
||||
AUR: https://aur.archlinux.org
|
||||
Subversion: https://www.archlinux.org/svn
|
||||
|
||||
vim: ft=text autoindent tabstop=4 shiftwidth=4 expandtab
|
Loading…
Reference in a new issue