Skip to content

Commit

Permalink
Updated README for v1.0.1 release and corrected various issues.
Browse files Browse the repository at this point in the history
  • Loading branch information
diederikdehaas committed May 18, 2014
1 parent 8587720 commit 6f34087
Showing 1 changed file with 13 additions and 12 deletions.
25 changes: 13 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,19 +36,19 @@ Obtaining installer files on Windows and Mac
--------------------------------------------
Installer archive is around **9MB** and contains all firmware files and the installer.

https://github.com/hifi/raspbian-ua-netinst/releases/download/v1.0/raspbian-ua-netinst-v1.0.zip
Go to https://github.com/hifi/raspbian-ua-netinst/releases/latest and download the .zip file.

Format your SD card as **FAT32** (MS-DOS on _Mac OS X_) and extract the installer files in.

SD card image for Linux
-----------------------
Prebuilt image is around **6MB** xz compressed and **32MB** uncompressed. It contains the same files as the .zip but is more convenient for Linux users.
Prebuilt image is around **6MB** xz compressed and **31MB** uncompressed. It contains the same files as the .zip but is more convenient for Linux users.

https://github.com/hifi/raspbian-ua-netinst/releases/download/v1.0/raspbian-ua-netinst-v1.0.img.xz
Go to https://github.com/hifi/raspbian-ua-netinst/releases/latest and download the .img.xz file.

To flash your SD card on Linux:

xzcat /path/to/raspbian-ua-netinst-latest.img.xz > /dev/sdX
xzcat /path/to/raspbian-ua-netinst-<latest-version-number>.img.xz > /dev/sdX

Replace _/dev/sdX_ with the real path to your SD card.

Expand All @@ -66,21 +66,21 @@ The system is almost completely unconfigured on first boot. Here are some tasks

The default **root** password is **raspbian**.

> Set new root password: `passwd`
> Configure your default locale: `dpkg-reconfigure locales`
> Set new root password: `passwd`
> Configure your default locale: `dpkg-reconfigure locales`
> Configure your timezone: `dpkg-reconfigure tzdata`
> Install latest kernel and firmware package: `apt-get update && apt-get install linux-image-rpi-rpfv raspberrypi-bootloader-nokernel`
> Replace old kernel.img with latest kernel: `cp /vmlinuz /boot/kernel.img`
> Reboot to new kernel and firmware: `reboot`
Installing the firmware package is **strongly** recommended because the installer does not install any kernel modules which are required for ipv6, sound and many more stuff you might need.
The latest kernel and firmware packages are now automatically installed during the unattended installation process.
When you need a kernel module that isn't loaded by default, you will still have to configure that manually.
Also, when a new kernel becomes available in the archives, you have to tell the system to use the new kernel by doing:
`cp /vmlinuz /boot/kernel.img`

> Optional: `apt-get install raspi-copies-and-fills` for improved memory management performance.
> Optional: Create a swap file with `dd if=/dev/zero of=/swap bs=1M count=512 && mkswap /swap` (example is 512MB) and enable it on boot by appending `/swap none swap sw 0 0` to `/etc/fstab`.
Reinstalling or replacing an existing system
--------------------------------------------
If you want to reinstall with the same settings you did your first install you can just move the original _config.txt_ back and reboot. Make sure you still have _kernel_emergency.img_ and _installer.cpio.gz_ in your _/boot_ partition. If you are replacing your existing system which was not installed using this method, make sure you copy those two files in and the installer _config.txt_ from the original image.
If you want to reinstall with the same settings you did your first install you can just move the original _config.txt_ back and reboot. Make sure you still have _kernel_install.img_ and _installer.cpio.gz_ in your _/boot_ partition. If you are replacing your existing system which was not installed using this method, make sure you copy those two files in and the installer _config.txt_ from the original image.

mv /boot/config-reinstall.txt /boot/config.txt
reboot
Expand All @@ -90,6 +90,7 @@ If you want to reinstall with the same settings you did your first install you c
Installer customization
-----------------------
While defaults should work for most power users, some might want to customize default configuration or the package set even further. The installer provides support for this by reading a configuration file _installer-config.txt_ from the first vfat partition. The configuration file is read in as a shell script so you can abuse that fact if you so want to.
See `scripts/etc/init.d/rcS` for more details what kind of environment your script will be run in (currently 'busybox sh').

Easiest way to do this is to first _xzcat_ the image to your SD card and then mount the first partition to add your configuration file.

Expand Down Expand Up @@ -127,7 +128,7 @@ Presets set the `cdebootstrap_cmdline` variable. For example, the current _serve

> _--flavour=minimal --include=kmod,fake-hwclock,ifupdown,net-tools,isc-dhcp-client,ntp,openssh-server,vim-tiny,iputils-ping,wget,ca-certificates,rsyslog,dialog,locales,less,man-db_
There's also a post-install script support which is executed just before unmounting the filesystems. You can use it to tweak and finalize your automatic installation. The script should reside in the first vfat partition and have a name of _post-install.txt_. See `scripts/etc/init.d/rcS` for more details what kind of environment your script will be run in.
There's also a post-install script support which is executed just before unmounting the filesystems. You can use it to tweak and finalize your automatic installation. The script should reside in the first vfat partition and have a name of _post-install.txt_.

Disclaimer
----------
Expand Down

0 comments on commit 6f34087

Please sign in to comment.