- install any Linux
- setup ZFS
- on Ubuntu: apt-get install zfsutils-linux
- on Debian 8.6, use apt-get install lsb-release, wget ..zfsonlinux..deb, dpkg ...deb,
apt-get update, apt-get install debian-zfs
- On Debian you must install sudo: apt-get install sudo
- napp-it expects a pool ex tank to be mounted under /tank
- start napp-it
- open a console, enter su and cd /root and run
wget -O - www. napp-it.org/nappit | perl
This downloads napp-it
Start napp-it for the first time with root permissions via
sudo sh /var/web-gui/data/tools/linux/napp-it
After the initial start, you can start via commands "sudo napp-it" and stop via "sudo napp-it-stop"
There is no autostart enabled during boot.
When you have created a pool, you should export/import to pool to use wwn disk enumaration
On some Linux napp-it may run if you install sudo, netcat and mini-http manually:
On ESXi you must enable UUID disk detection:
Power off the guest.
Select the guest and select Edit Settings.
Select the Options tab on top.
Select General under the Advanced section.
Select the Configuration Parameters... on right hand side.
Check to see if the parameter disk.EnableUUID is set, if it is there then make sure it is set to TRUE.
If the parameter is not there, select Add Row and add it.
Power on the guest.
The following is obsolete with current napp-it
Linux (currently Debian 7, Ubuntu 14 LTS)
I support Linux with basic ZFS, disk and job management, monitoring and remote replication with OmniOS
Linux is not my preferred or main platform. Many napp-it features rely on Solaris projects like
the CIFS server with Windows SID and ACL support, Comstar iSCSI or Crossbow network virtualisation.
A napp-it version with similar functionality like on OmniOS is currently not planned.
current state: preview, work in progress
Setup napp-it on Ubuntu 14 LTS (console commands)
## Setup on ESXi ##
- create a new Linux VM with 16 GB (OS) and 3 x 10 GB (Testpool)
- edit Settings of this VM (we need to identify disks by-id):
By default VMWare doesn't provide information needed by udev to generate /dev/disk/by-id.
This can be done by setting the following: http://www.novell.com/support/kb/doc.php?id=7002966
Start the vSphere Client, and log in to a vCenter Server.
Select Virtual Machines and Templates and click the Virtual Machines tab.
Right-click the virtual machine for which you are enabling the disk UUID attribute, and select Power > Power Off.
The virtual machine powers off.
Right-click the virtual machine, and click Edit Settings.
Click the Options tab, and select the General entry in the settings column.
Click Configuration Parameters. The Configuration Parameters window appears.
Click Add Row.
In the Name column, enter disk.EnableUUID
In the Value column, enter TRUE
Click OK and click Save.
Power on the virtual machine.
## Download Ubuntu 14 LTS setup ISO and install onto the 20 GB disk
download from http://releases.ubuntu.com/trusty/ and install
- add SSH server during setup
- create a new admin user during setup ex "me"
after setup, reboot and
- login as this user
## enable root (disable with delete pw)
sudo passwd root
login as root (or start commands with sudo)
## If network is down after setup, bring it up with dhcp like
ifconfig eth0 up
check your ip config:
## Install SSH (for Putty or WinSCP)
apt-get install ssh (if not installed during setup)
/etc/ssh/sshd_config (use midnight commander or nano):Find the line
PermitRootLogin no (or other restriction) and change it to
sudo service ssh restart
## You can now connect from Windows as user root via WinSCP (file browser/editor) and Putty (remote console)
where you can copy paste commands with a mouse right-click). If you use putty as me, switch to root with su
## var 1: install ZoL manually on Ubuntu 14 LTS, use Putty to allow copy/paste of commands with a mouse-right-click
## Server-Update to use ZFS and napp-it:
apt-get update && apt-get dist-upgrade -y
## PPA setup:
apt-add-repository ppa:zfs-native/stable -y
## Install build environment
apt-get install build-essential --no-install-recommends -y
## Add NFS/SMB Server
apt-get install nfs-kernel-server samba -y
apt-get install ubuntu-zfs -y
opt: add iSCSI
apt-get install targetcli --no-install-recommends -y
## On Ubuntu 12 LTS I did it in this order:
## http://www.latentexistence.me.uk/zfs-and-ubuntu-home-server-howto/ or others
## apt-get install python-software-properties -y
## add-apt-repository ppa:zfs-native/stable
## apt-get update
## apt-get install ubuntu-zfs -y
## apt-get install nfs-kernel-server samba -y
## Napp-it setup: you can now run the online installer from your home directory:
wget -O - www.napp-it.org/nappit | perl
After online updates, do a napp-it logout/login
The installer does the following:
- install basic tools like bonnie, mc, netcat and smartmontools
- adduser napp-it --shell /bin/false --no-cretae-home --disabled-password --gecos ''
- add the foolowing to /etc/sudoers:
- edit /etc/sudoers
#no passwd for napp-it sudo (place at the end of the file)
napp-it ALL=(ALL) NOPASSWD: ALL
- Configure napp-it with mini-httpd
- edit /etc/default/mini-httpd (autostart with START=1)
- edit /etc/mini-httpd.conf for these settings
## Manage napp-it from a Browser (replace serverip with your current ip from ifconfig)
If you cannot connect; please rerun the wget installer a second time!!
## Stop napp-it manually (as root)
## Start napp-it manually (as root)
Discuss Problems at
- use device by-id disk names, if your pool use id's like sda, export/import the pool, it will use then ata, iscsi or wwn names.
Setup napp-it on Debian 7.3
setup mostly similar to Ubuntu
- Download netinstall iso
- upload to ESXi datastore
- new VM with UUID enabled (see Ubuntu setup)
- connect DVD to netinstall iso
- create a 16 GB bootdisk and install Debian
with SSH Server
Install ZFS via Putty as root
wget http://archive.zfsonlinux.org/debian/pool/main/z/zfsonlinux/zfsonlinux 1%7Ewheezy all.deb
dpkg -i zfsonlinux_1~wheezy_all.deb
apt-get install debian-zfs parted ntfs-3g mountall
apt-get install sudo
Install SMB and NFS Server
apt-get install nfs-kernel-server samba
Install napp-it per wget
wget -O - www.napp-it.org/nappit | perl
add napp-it to group sudo with command: gpasswd -a napp-it sudo
Edit /etc/sudoers (use WinSCP connected as root):
# This file MUST be edited with the 'visudo' command as root.
# Please consider adding local content in /etc/sudoers.d/ instead of
# directly modifying this file.
# See the man page for details on how to write a sudoers file.
## supress Console messages from sudo
# Host alias specification
# User alias specification
# Cmnd alias specification
# User privilege specification
root ALL=(ALL:ALL) ALL
# Members of the admin group may gain root privileges
%admin ALL=(ALL) ALL
# Allow members of group sudo to execute any command
%sudo ALL=(ALL:ALL) ALL
# See sudoers(5) for more information on "#include" directives:
#no passwd for napp-it sudo (place at end of file)
napp-it ALL=(ALL) NOPASSWD: ALL
Start/stop napp-it manually
/etc/init.d/napp-it start (stop)
Setup napp-it on other Linux distributions
- you must setup ZFS with NFS and SMB server
- sudo is required (for user napp-it without password)
- mini-httpd webserver is required for napp-it (run as user napp-it)
- disk identification is dev by-id
optionally compare the setup with Debian/ Ubuntu 7 and the
wget online installer in function "sub linux"