Editing FUSE

This page describes how to setup FUSE (filesystem in userspace) inside a VE.

[http://git.openvz.org/?p=linux-2.6.18-openvz;a=blob;h=a584f05403a412e778cf359e84d3690d5a22d1e4;hb=045f4a5fcb8c2625fe7505a8d9d4ebffd7e0d905;f=Documentation/filesystems/fuse.txt FUSE] is a filesystem in which data and metadata are provided by an ordinary userspace process. The filesystem can be accessed normally through the kernel interface.

== Preparations ==
To use FUSE you need the following:
# OpenVZ kernel version [http://git.openvz.org/?p=linux-2.6.18-openvz;a=commit;h=045f4a5fcb8c2625fe7505a8d9d4ebffd7e0d905 028test005] or higher
# [http://mesh.dl.sourceforge.net/sourceforge/fuse/fuse-2.6.0.tar.gz Fuse lib]
# Any FUSE-based [http://fuse.sourceforge.net/wiki/index.php/FileSystems filesystem]

In the examples below [http://fuse.sourceforge.net/sshfs.html sshfs] is used.

== Setup ==
=== Kernel ===
Download appropriate kernel from [http://download.openvz.org/ openvz.org] or compile kernel with <code>CONFIG_FUSE_FS</code> option set

=== Userspace ===

You have to fuse libraries and some fuse filesystem modules (here we use sshfs as an example).

The best way to have it installed is to use the packages from your distro vendor. An alternative is compiling the stuff from source.

==== Gentoo ====

 # emerge sys-fs/sshfs-fuse

==== Fedora ====

 # yum install fuse-sshfs

==== Debian/Ubuntu ====

* FIXME

==== Compiling from source ====
If there are no packages provided for you distribution, you have to compile from source.

First, compile libfuse in a VE without kernel module
<pre>
# vzctl enter 100
# tar xzf fuse-2.6.0.tar.gz
# cd fuse-2.6.0
# ./configure --disable-kernel-module
...
# make
...
# make install
</pre>

{{note|Sometimes <code>libfuse.so.X</code> is unseen by your programs. Usually this file is installed in <code>/usr/local/lib</code> directory so don't forget to add this directory into your <code>/etc/ld.so.conf</code> and then run <code>ldconfig</code>.}}

Next, download and compile filesystem.
<pre>
# vzctl enter 100
# tar xzf sshfs-fuse-1.7.tar.gz
# cd sshfs-fuse-1.7
# ./configure
...
# make
...
# make install
</pre>

=== VE tuning ===
You need to make a character device named <code>/dev/fuse</code> and grant your VE permissions to it
<pre>
# vzctl set 100 --devices c:10:229:rw --save
...
# vzctl exec 100 mknod /dev/fuse c 10 229
...
</pre>

=== Mounting filesystem ===
After this you may try to mount FUSE in a VE
<pre>
# vzctl enter 100
# sshfs root@foo.org:/root /mnt/foo.org.root
</pre>

==== Unmounting filesystem ====
In case of <code>sshfs</code> after umounting an appropriate daemon must be killed. This may be done by the following command:
<pre>
# fusermount -u moutpoint
</pre>

== Using fusectl filesystem ==
Fusectl is a helper filesystem for FUSE. You may mount it in a VE as well
<pre>
# vzctl enter 100
# mount -t fusectl none /fuse_ctl
</pre>

== External links ==

* [http://fuse.sourceforge.net/ FUSE site]

[[Category:HOWTO]]
@@ Line 1: / Line 1: @@
-This page describes how to setup FUSE (filesystem in userspace) inside a container.
+This page describes how to setup FUSE (filesystem in userspace) inside a VE.
 [http://git.openvz.org/?p=linux-2.6.18-openvz;a=blob;h=a584f05403a412e778cf359e84d3690d5a22d1e4;hb=045f4a5fcb8c2625fe7505a8d9d4ebffd7e0d905;f=Documentation/filesystems/fuse.txt FUSE] is a filesystem in which data and metadata are provided by an ordinary userspace process. The filesystem can be accessed normally through the kernel interface.
@@ Line 13: / Line 13: @@
 == Setup ==
 === Kernel ===
-* Download appropriate kernel from [http://download.openvz.org/ openvz.org] or compile kernel with <code>CONFIG_FUSE_FS</code> option set
+Download appropriate kernel from [http://download.openvz.org/ openvz.org] or compile kernel with <code>CONFIG_FUSE_FS</code> option set
-* Debian/Ubuntu: You can alternatively add the line <code>fuse</code> into /etc/modules, and apply immediately with the command: <pre>modprobe --first-time fuse</pre>
 === Userspace ===
@@ Line 31: / Line 30: @@
 ==== Debian/Ubuntu ====
-===== Debian 5.0 (lenny) =====
-FUSE cannot be installed due to udev/hotplug dependency (explained in [http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=503953 bug report 503953])
-===== Ubuntu, Debian 6.0 (squeeze), Debian 4.0 (etch) and older =====
+* FIXME
- # apt-get install sshfs
-(Debian 4.0 note: see [[Installing udev in VE based on Debian-4.0]])
 ==== Compiling from source ====
 If there are no packages provided for you distribution, you have to compile from source.
-First, compile libfuse in a container without kernel module
+First, compile libfuse in a VE without kernel module
 <pre>
 # vzctl enter 100
@@ Line 68: / Line 62: @@
 </pre>
-=== Container tuning ===
+=== VE tuning ===
-You need to make a character device named <code>/dev/fuse</code> and grant your container permissions to it
+You need to make a character device named <code>/dev/fuse</code> and grant your VE permissions to it
 <pre>
 # vzctl set 100 --devices c:10:229:rw --save
@@ Line 76: / Line 70: @@
 ...
 </pre>
-Or more simply:
-<pre>
-# vzctl set 103 --devnodes fuse:rw --save
-...
-</pre>
-Note that restart (or moving to root container device cgroup before mounting) might be required.
 === Mounting filesystem ===
-After this you may try to mount FUSE in a container.
+After this you may try to mount FUSE in a VE
 <pre>
 # vzctl enter 100
-# sshfs <nowiki>root@foo.org</nowiki>:/root /mnt/foo.org.root
+# sshfs root@foo.org:/root /mnt/foo.org.root
 </pre>
@@ Line 95: / Line 81: @@
 In case of <code>sshfs</code> after umounting an appropriate daemon must be killed. This may be done by the following command:
 <pre>
-# fusermount -u mountpoint
+# fusermount -u moutpoint
 </pre>
 == Using fusectl filesystem ==
-Fusectl is a helper filesystem for FUSE. You may mount it in a container as well.
+Fusectl is a helper filesystem for FUSE. You may mount it in a VE as well
 <pre>
 # vzctl enter 100