EON Configurations and ZPOOL

Edit automatic boot configuration

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.

Next - Setup CIFS/Samba sharing (also see CIFS Server Howto)