[alpine-devel] Install handbook ideas

Natanael Copa
Details
Message ID
<1263228338.26038.49.camel@ncopa-desktop.nor.wtbts.net>
Sender timestamp
1263228338
DKIM signature
missing
Download raw message
I'd like an "Install Handbook" or similar. Something like:

Introduction - Ways to run Alpine:
 - explain the different ways you can run Alpine. I.E run from RAM, or  
 run form disk. Explain when why/when you want run "live" form ram and
 when you want install alpine on disk.
 We should probably also create a name for running from RAM, "ram mode",
 "disk-less mode" or "live mode" or similar.

Prepare Boot media:
 - explain where to find the iso
 - explain how to burn it the cdrom or create a bootable USB.

Booting Alpine (not sure if this is needed):
 - explain how to boot the cd/usb. (mention that you might set up BIOS
 so it boots from cdrom/usb)
 - mention boot options that might be needed for vmware

Setup (install?) Alpine:
 - Write a simple walkthrough of setup-alpine. Its a nice handholding
 for newbies.
 - Explain how to use setup-disk if you want install alpine to disk
 - might be an idea to tell how to run fdisk to create custom partition
 tables for setup-disk.
 - Explain how to use 'lbu commit' if "disk-less mode" (or what we end
 up calling it) and explain why you don't need it when installing on
 disk.

at this point the user should have a basic bootable alpine system. The
handbook could continue with things like:

Configuring the network:
 - explain shortly about the network interface names (eth0, eth1,
 ppp0 etc)
 - explain how to do the simple networking setup, dhcp, static ip etc.
 - explainhow to start/stop interfaces
 - advanced network configuration like pppoe, bridges, bonding, vlans,
 wifi?

Installing/removing software packages:
 - explain the basic usage for apk-tools
 - setting up http repositories - mention http proxies
 - installing packages
 - deleting packages
 - upgrade, explain how to set up the apk cache

Services:
 - tell what openrc is
 - explain how to start stop services
 - explain about runlevels and how to add services to "default" runlevel
 - explain about openrc dependencies
 - maybe mention how to configure services (/etc/conf.d) and maybe
 tell about the difference between /etc/daemon.conf
 and /etc/conf.d/daemon

Upgrading alpine(?):
 - tell how to upgrade alpine to new version
 - mention the .apk-new files, maybe as an advanced topic.


Configure X11(?):
 - explain how to set up x11 and create an xorg.conf

Ideas?

Something else we should have in the alpine install handbook?

Thanks!

-nc



---
Unsubscribe:  alpine-devel+unsubscribe@lists.alpinelinux.org
Help:         alpine-devel+help@lists.alpinelinux.org
---