I will be taking nearly all my information from the ReadMe file that comes with NAS4Free 126.96.36.199.x. I will also lean heavily on the developers. This information and the NAS4Free application itself (as a FreeNAS branch) is the great work of Zoon01 and Daoyama, thanks!!
Vacation is over and so is the NAS4Free install! Perfecto! Please comment as necessary! Last edit 7/8/2012 10PM
- 1. Ensure you have FreeNAS 0.7.2.8191 installed and running on your NAS. Upgrade your version if you have an older version. The FreeNAS 0.7.2.8191 files are here.
- You CAN upgrade through the firmware upgrade in the webGUI if you have an older version than FreeNAS 0.7.2.8191.
- You CANNOT upgrade through the firmware upgrade in the webGUI to NAS4FREE if you are already at FreeNAS 0.7.2.8191.
2. Save your FreeNAS config file from System|Backup/Restore screen and hit "Download configuration". Save it somewhere.
3. If you have lots of HDDs of the same size like me, save a copy of your Disk|Management screen. This will link ad## to HDD size and HDD serial number. Could be useful later.
*NOTE: Later versions automatically convert the config and import disks, so it is no longer desirable or necessary to manually edit config.xml, so feel free to skip step #4. While the automatic conversion works fine in most cases it is still good to have a backup and keep this procedure handy just in case of trouble. - Al
4. Find the downloaded file with an extension XML, add ".TXT" to the end of the file name and bring it up in an editor like Notepad++ in Windoze. Don't use a word processor, they add info and it won't be saved correctly. Notepad will not view it correctly but will save it correctly. Wordpad will view it correctly but not save it correctly. Of course if you have an XML editor then you can just edit the original downloaded file. Edit the file as follows:
- Find all "freenas" labels, replace with "nas4free".
- Find all "FreeNAS" labels, replace with "NAS4Free". (let's be precise with our capitalizations )
- Find "<version>8.9</version>", replace with "<version>1.0</version>".
- Keep the editor open to be ready to do ad## to ada## conversions from information collected in step 8.
5. Burn a copy of NAS4Free 188.8.131.52.x on a bootable CD/DVD or make an embedded version.
- I expect the vast majority of people know how to create a bootable CD/DVD from the NAS4Free ISO so get to it.
- As for the embedded version that is a lot more tricky. The image (.IMG) file is uncompressed so it can be put right to some smaller storage instead of wasting some tiny amount of space on a HDD which then couldn't be used for a RAID. That smaller storage (usually flash media) can be a CF card or a USB stick. I heard the IMG file can be placed into flash media by other programs like Win32 Image Writer but I prefer to use m0nowall's PhysDiskWrite. Here is a good explanation of writing the image, just substitute your NAS4Free image for the pfSense one they mention. A couple of suggestions:
- - Don't use a USB stick larger than 2 GB, it's a PhysDiskWrite limitation unless overruled. Otherwise use whatever size you like.
- - Note PhysDiskWrite CAN overwrite your HDDs if you pick the wrong "PhysicalDrive"! (that's why the 2 GB limit mentioned above)
- - Rename your image file to something simple, like n4f.img before you use it with PhysDiskWrite (easier to type than NAS4Free-x64-embedded-184.108.40.206.img!).
- - Don't forget to give PhysDiskWrite's DOS window administrator rights in Vista and Win7!
- - If your flash media does not finish it's transfer during the image writing through PhysDiskWrite no fear, try again (I've sometimes had to do it a dozen times).
- - If your flash media does not start image writing, no fear. What always works for me is to format the flash media in anything (FAT, NTFS, etc.) and physically pull the media from its socket in the middle of the format. Now the flash media is NOT formatted and then PhysDiskWrite always works with it. Odd but always works for me, especially if the USB stick was previously used (i.e. was formatted).
6. Boot up the CD or embedded flash device with NAS4Free 220.127.116.11.x on it. If you have the embedded version make changes to get it to talk to the network card but that should be it so then skip to step 7.
7. Install NAS4Free 18.104.22.168.x from your CD/DVD to your HDD. Make changes to get it to talk to the network card. Note LAN IP address if you don't have it set to a specific LAN IP address. Now browse to your NAS, default login into NAS4Free's webGUI is username: admin, password: nas4free.
8. Get a list through NAS4Free of your HDDs from the Diagnostics|Information|Disks screen. Make sure to find links for each HDD to HDD ada## and HDD size as well as HDD serial number just in case. Finish the editing you started in step 4.
9. Go into NAS4Free and import the edited FreeNAS (now NAS4Free) config file from step 4. Reboot and now you have NAS4Free configured as your old FreeNAS was on your NAS. NOTE: If you do not have the NAS4Free logo come up in the webGUI, find some way to flush your browser's cache (it doesn't always work the first time for me ).
10. Import your HDDs.
- All HDDs, ZFS and non-ZFS, should be up and running if you did the ad## to ada## translation correctly.
- If your non-ZFS and ZFS HDDs are not there (i.e. not show up in the Disk|Management screen), you should be able to add them. As long as you don't format anything but indicate the data HDDs are already formatted, they should be accepted as is in NAS4Free (i.e. data on the HDD is NOT changed).
- For ZFS HDDs there is one more step to upgrade the ZFS on the HDDs from v13 to v28. To verify the pools are not upgraded merely display ZFS pool status and ZFS will tell you your pools are running on an older version. That's expected, of course. The older ZFS pools can be upgraded one of two ways through the:
- - webGUI - Goto Disks|ZFS|Pools|Tools, set Command = upgrade and Option = All, then click Send Command. All will upgrade all ZFS pools in the system, Display will only display ZFS pool version info and Pool will only upgrade only by pool, repetitive if you have more than one pool like me.
- - CLI - Goto Advanced|Command, Beside Command put "zpool upgrade -a" and click on Execute. Same as the webGUI action above.
11. You're now up and running with NAS4Free. Welcome to our world!