• 
• 
• 
• 
• 
• 

NILFS2 is now available on official Debian apt repositories (for lenny and sid).

The following instructions show how to install official or unofficial packages (NILFS2 kernel module and its user-land tools) with APT.

Available Debian Releases

• sid
• lenny
• etch (unofficial package served in this site)

The kernel module package depends on kernel versions. Installation against incompatible kernels (i.e. kernels with different version or ABI number) will fail. The official Debian kernel module of NILFS2 is available only for the 2.6.25 kernel or later.

APT configurations to install packages from this site

Skip this section if you are using lenny or sid.

In order to install the unofficial packages, the following two preparations are required,

• Adding apt lines to /etc/apt/sources.list
• Importing a GnuPG (gpg) public key of the NILFS archive from a public key server

The URL of the apt repository is as follows,

• http://www.nilfs.org/pub/debian/

And the component name in the apt line is ``main''. The apt lines that should be added to /etc/apt/sources.list will become as follows,

 deb http://www.nilfs.org/pub/debian etch main
 deb-src http://www.nilfs.org/pub/debian etch main

In order to obtain and install the gpg public key, use gpg commands and apt-key as follows,

 $ gpg --keyserver hkp://subkeys.pgp.net --recv-keys 38CC8C3FEDB80C09
 ...
 $ gpg --export -a 38CC8C3FEDB80C09 | sudo apt-key add -
 OK
 $ sudo apt-key list
 ...
 pub   1024D/EDB80C09 2008-03-21 [expires: 2011-03-21]
 uid                  NILFS Archive Automatic Signing Key 
 sub   1024g/C02671F0 2008-03-21 [expires: 2011-03-21]

Without installing the gpg public key, you will see some warnings when updating package database.

For more details on the GnuPG, please refer to http://gnupg.org/

Installing userland tools

Install nilfs2-tools package as follows,

 $ sudo apt-get update
 $ sudo apt-get install nilfs2-tools

To install the unofficial package, specify nilfs2-utils instead of nilfs2-tools.

Though the example is described with the standard APT tool, equivalent tools such as aptitude or GUI-based package managers are also available.

Installing kernel module

This can be done by installing the nilfs2-modules package whose version number matches the target kernel.

 $ sudo apt-get install nilfs2-modules
 Reading package lists...
 Building dependency tree...
 Package nilfs2-modules is a virtual package provided by:
   nilfs2-modules-2.6.25-2-vserver-amd64 2.6.25+2.0.2-5
   nilfs2-modules-2.6.25-2-amd64 2.6.25+2.0.2-5
 You should explicitly select one to install.
 E: Package nilfs2-modules has no installation candidate
 $ uname -r
 2.6.25-2-amd64
 $ sudo apt-get install nilfs2-modules-2.6.25-2-amd64

You likely want to make the APT follow kernel changes automatically. In that case, use a meta package like nilfs2-modules-2.6-<arch name> instead.

 $ sudo apt-get install nilfs2-modules-2.6-amd64
 Reading package lists... Done
 Building dependency tree       
 Reading state information... Done
 The following extra packages will be installed:
   nilfs2-modules-2.6.25-2-amd64
 The following NEW packages will be installed:
   nilfs2-modules-2.6-amd64 nilfs2-modules-2.6.25-2-amd64
 0 upgraded, 2 newly installed, 0 to remove and 4 not upgraded.
 Need to get 0B/87.3kB of archives.
 After this operation, 348kB of additional disk space will be used.
 Do you want to continue [Y/n]? y
 ...
 Setting up nilfs2-modules-2.6.25-2-amd64 (2.6.25+2.0.2-5) ...
 Setting up nilfs2-modules-2.6-amd64 (2:2.6.25-5) ...

If you are using NILFS2 built from the original source package, uninstall it before installing the deb package. This can be performed by make uninstall,

 $ cd (working directory)/nilfs-2.0.2
 $ sudo make uninstall

You can verify which NILFS2 module is enabled by using modinfo command; if the installed NILFS2 module comes from a deb package, its installation path shall include extra/nilfs2 as shown in the filename: line.

 $ modinfo nilfs2
 filename:       /lib/modules/2.6.25-2-amd64/extra/nilfs2/nilfs2.ko
 license:        GPL
 version:        2.0.2
 description:    A New Implementation of the Log-structured Filesystem (NILFS)
 author:         NTT Corp.
 srcversion:     9255940F4C7325AD5BFD9F7
 depends:        
 vermagic:       2.6.25-2-amd64 SMP mod_unload 

Updating NILFS2 packages

You can upgrade installed NILFS2 packages as usual.

 $ sudo apt-get update
 $ sudo apt-get dist-upgrade

When upgrading a kernel module in use, you should reboot the system after installation, or unmount all NILFS2 partitions before upgrading.