View source for Enmotus: Installation and set up

== Installation ==

Run the binary provided....

<syntaxhighlight>
./FuzeDriveServer_install_linux64_XXXX
</syntaxhighlight>

Install the licence...

<syntaxhighlight>
evsp --license AAAA-BBBB-CCCC-DDDD
</syntaxhighlight>

Check the licence...

<syntaxhighlight>
evsp --license
</syntaxhighlight>

== Create a Fuze Drive ==
There are several pssoble ways to create a tiered volume, depending on the number and configuration of the disk required. Before creating a disk you will need to list the available disks that can be used:
List the available drives:

<syntaxhighlight>
evsp --list
</syntaxhighlight>

The general create command is mused to make intermediate virtual volumes (vdisks) that form the tiers as well as the tiered volumes (tdisks).

The command follows a set format:

<syntaxhighlight>
evsp --create <disk-type> <device1> <device2> ... {options}

#disk-type = vdisk or tdisk
#device = the disks to be used
#options = type or inital mode of the volume
</syntaxhighlight>

== Creating Single Disk-per-Tier tidsks ==

When combining a single pair of fast and slow devices together into a tdisk, there is no need to create intermediate vdisk devices and a single command can be used where device 1 is the fast device and device 2 is the slow tier. 

<syntaxhighlight>
evsp --create /dev/sdb /dev/sdc
</syntaxhighlight>

There are three options that can be passed to determine the mapping of the fast and slow tiers to the logical blocks address space:

# fast_first  - the fast tier is placed at logical address 0
# slow_first  - The slow device is placed at logical address 0
# fast_part   - 20% of the fast tier is placed at logical address 0, with the remaining 80% placed at the end.


== Creating Multi-Disk vdisk tiers ==

The create command can use two internal Enmotus disks as arguments instead of raw block devices.  In this case a vdisk needs to be preconfigured prior to being placed as a tier.

=== Creating vdisks ===

The tiering engine support pooling of physical disk drives in either a linear concatenation or stripe mode.  Striping is implemented around tiering page boundaries with a stripe size the same as the page size setting for the tdisk (default 4M). Up to a maxium of 16 devices can be combined into a pool, with valid modes of linear or stiping. 

<syntaxhighlight>
evsp --create vdisk <device1> <device2> ... {mode}
</syntaxhighlight>

== Changing the default promote parameters and policies ==

The mode of the tiering engine may be changed from its default settings.  Promote thresholds, rates and policies can all be set up using the evsp command. 

<syntaxhighlight>
evsp --promote <mode> <tdevice>
</syntaxhighlight>

The promote policy can be changed with the evsp command:

<syntaxhighlight>
evsp --policy <mode> <tdevice>
</syntaxhighlight>

=== Changing promote rates  ===

Promote options:

# aggressive
# normal
# slow

<syntaxhighlight>
evsp --promote aggressive /dev/eba
</syntaxhighlight>

=== Changing Promote Policies ===

Policy Options:

# rdio - decisions based on read io activity only
#rwio - decisions based on read and write io activity 
#rdblock  - decisions based on read block volume activity 
#rwblock - decisions based on read and write block volume activity 

<syntaxhighlight>
evsp --policy rwio /dev/eba
</syntaxhighlight>