  
ARECA SATA/SAS/NVMe Raid Controller for FreeNAS 11.0

		
  ===========================================
	FreeNAS Raid driver technical support 
	mail address: support@areca.com.tw
	Web site:     www.areca.com.tw
  ===========================================


*********************************************************************************
*  1. Contents
*********************************************************************************

readme.txt  - The readme file of ARECA Raid driver for FreeNAS
arcmsr.ko   - adapter driver for FreeNAS 11.0

*********************************************************************************
*  2. The first-time installation
*********************************************************************************

A. Before Installing

	Copy driver arcmsr.ko to a USB flash drive.

B. Installation
	a. Installing system

		1. Power on your computer.
		2. Insert the FreeNAS Installation CD/DVD and driver USB .
		3. When "FreeNAS 11.0-RELEASE Console Setup" window display, Press 2 to shell and ENTER.
		   # mount_msdosfs /dev/da0s1 /mnt
		   # kldload /mnt/arcmsr.ko
		   # umount /mnt
		   # exit
		4. Now start to install OS.
		5. After system is installed completely, enter into command shell before reboot.
	
		6. Updating driver module arcmsr.ko  <---- !!! IMPORTANT IMPORTANT !!!

		   After system is installed completely, and system return to
		  "FreeNAS xxx Console Setup" screen:
		   Select 2) Shell, system will enter into command prompt.
	
		  Type following command to copy arcmsr.ko to installed FreeNAS volume.
		  We assume that USB flash drive is device da0.

		  # mkdir /tmp/mnt /tmp/mnt1
		  # mount -t msdosfs /dev/da0s1 /tmp/mnt1
		  # zfs set mountpoint=/tmp/mnt freenas-boot/ROOT/default
		  # cp -f /tmp/mnt1/arcmsr.ko /tmp/mnt/boot/kernel
		  # umount /tmp/mnt1
		  # zfs set mountpoint=legacy freenas-boot/ROOT/default
		  # exit

		  Remove USB flash drive.

		  Select 3) Reboot System, to reboot the system

	b. During the very first boot, type e to edit grub configuration as below.

		kfreebsd_loadenv /ROOT/default@/boot/device.hints
		kfreebsd_module_elf /ROOT/default/@/boot/kernel/arcmsr.ko         <-------- adding this line

	   
	c. After system boot completely, enter "shell" to go to command shell.

		# vi /boot/grub/grub.cfg

		kfreebsd_loadenv /ROOT/default@/boot/device.hints
		kfreebsd_module_elf /ROOT/default/@/boot/kernel/arcmsr.ko         <-------- adding this line


*********************************************************************************
*  3. To install arcmsr driver into an existing FreeNAS system
*********************************************************************************
	At system console, type 9 then press Enter to go to command shell.
	Insert the USB flash drive which with adapter Raid driver for your system.
	Type following command to install arcmsr driver, here assume driver disk is da5.
	# mkdir /mnt0
	# mount -t msdosfs /dev/da5s1 /mnt0
	# cp /mnt0/arcmsr.ko /boot/kernel
	# umount /mnt0

	Add a loading driver line in grub.cfg as below.
	# vi /boot/grub/grub.cfg
	
	kfreebsd_loadenv /ROOT/default@/boot/device.hints
	kfreebsd_module_elf /ROOT/default/@/boot/kernel/arcmsr.ko                 <-------- adding this line
	
	# kldload /boot/kernel/arcmsr.ko
	# exit
