EON Configurations and ZPOOL

Edit automatic boot configuration

Contents

  1. 1 Edit automatic boot configuration
  2. 2 Create a ZPOOL
  3. 3 Create a ZFS swap
  4. 4 When to update image
Pre-requisite(s): Burn - Boot - Store
Locate and edit "POOL=zpool name" in /mnt/eon0/.exec to match your zpool name. This defines the ZPOOL storage that will hold the binary kit, web server, Perl, PHP, Python and more, if/when it is installed. This also automounts ZFS swap and defines where "/usr/local" will be symlinked (ie point to).
# define zpool name(s) POOLX
export POOL=abyss

If the "vi" editor is a challenge, your zpool name edit can be made using either of the following commands(sed option creates a backup, perl option does not). Be sure to substitute your zpool name for "YOUR_POOLNAME".
sed -i.bak 's|=abyss|=YOUR_POOLNAME|g' /mnt/eon0/.exec
or
perl -p -i -e 's/=abyss/=YOUR_POOLNAME/g' /mnt/eon0/.exec

Create a ZPOOL

Please read "ZPOOL Notes" for more detailed view on different types of zpools that can be built.
A (1) disk zpool
poolname = abyss
growable = no
redundancy = none
disk(s) = c0t0d0
zpool create abyss c0t0d0

A (2) disk pool
poolname = abyss
redundancy = yes, allows 1 disk failure
disk(s) = c0t0d0, c0t0d1
zpool create abyss mirror c0t0d0 c0t0d1
growable = yes, requires 2 additional disk each growth increase
zpool add    abyss mirror c0t0d2 c0t0d3

A (3) disk pool
poolname = abyss
redundancy = yes, allows 1 disk failure
disk(s) = c0t0d0 c0t0d1 c0t0d2
zpool create abyss raidz c0t0d0 c0t0d1 c0t0d2
growable = yes, requires 3 additional disk each growth increase
zpool add    abyss raidz c0t0d3 c0t0d4 c0t0d5

Create a ZFS swap

For better performance and process launching, a ZFS swap is highly recommended. The size should be at least 1 x RAM. A ZFS swap helps when running "updimg.sh" which uses /tmp or swap (ie RAM or ZFS swap)
Let's create a ZFS swap to match 1 x 4GB of system RAM (zpool name = abyss in the example). The "-b 4k" is optional (creates 4k blocksize swap) but recommended for better space utilization.
zfs create -V 4G -b 4k abyss/swap

Let's mount the ZFS swap that was just created. This step will be automatically performed for all future boots, once your ZPOOL name is properly edited in /mnt/eon0/.exec, Step 1.
swap -a /dev/zvol/dsk/abyss/swap

If later you add more RAM to your system, totaling 8GB. Your ZFS swap should be updated to match. Please remember to substitute your zpool name instead of "abyss"
swap -d /dev/zvol/dsk/abyss/swap
zfs destroy abyss/swap
zfs create -V 8G abyss/swap
swap -a /dev/zvol/dsk/abyss/swap

When to update image

This is the default USB key mount location and files edited here(.exec, .backup, .remove, .disable) DO NOT require an update image.
/mnt/eon0/*

This location will default to the "POOL=zpool name" (your zpool) and files edited here DO NOT require an update image.
/usr/local/*

Files edited in other system default paths WILL require an update image before the next reboot if you wish the changes to be persistent. Note that /usr/local is in /usr but is an exception because it is a symlink to a different location. In this case the location repoints /usr/local/ to your zpool. Symlinks of these kind, are exceptions and DO NOT require an update.
/usr/*
/etc/*
/kernel/*
...

EON, Storage for Life.

Comments