Fster-how-to-start

FSter – How to start

Download

First of all you have to download FSter, it is distribuited under GPL 3.0 license, so you can freely take

Install

In order to compile and install FSter you need:

  • cmake >= 2.8.0
  • fuse >= 2.8.1
  • tracker-client >= 0.7.11
  • libxml2 >= 2.7.4

The simplest way to compile and install FSter from sources is as follows:

  1. $ cd /path/to/fster-source-root
    Go to the root folder of the FSter code.

  2. $ mkdir build
    Create a directory where you want to compile your software. In this case the newly created build directory is within the unpacked downloaded software.

  3. $ cd build

  4. $ cmake ..
    From within the build directory, call cmake, pointing to the root of the unpacked software. While running, cmake will check your prerequisites and create the makefiles[1]. To install FSter in a custom location you may want to use -DCMAKE_INSTALL_PREFIX="/my/target/installation" as an argument.

  5. $ make
    Invoke the make program to build your software.

  6. $ sudo make install
    This command will install executables and libraries on your system. By default the install will place executables and libraries under /usr/local.

On Gentoo and Sabayon

If you are running any Gentoo or Sabayon distro, you can follow these steps:

  • Compiling and installing from Portage: layman -fa sabayon && emerge -av sys-fs/fster
  • Installing from Entropy (binary package, Sabayon only): equo update && equo install sys-fs/fster

On Debian and Ubuntu

  • installing tha package: dpkg -i FILE_NAME.deb

Note: Tracker 0.7.11 is required, you can find a package here: https://launchpad.net/~alex-hunziker/+archive/ppa

Configure

After downloading, you have to define what you want FSter to do for you: just use the FSter xml configuration

Run

Once you have FSter installed on your system, and a valid configuration, it is time to run your virtual filesystem!
Read how in the FSter files and options page.

Troubleshooting

Something like this might happen:
$ fster ~/Desktop/fster/
fster: error while loading shared libraries: libtracker-common.so.0: cannot open shared object file: No such file or directory

You can solve it by following these steps:
$ sudo find / | grep libtracker-common.so.0
Password: [type your password]

You’ll get something like this (it’s the path you need):
/usr/lib/tracker-0.7/libtracker-common.so.0.712.0
/usr/lib/tracker-0.7/libtracker-common.so.0

Type the following command (using the path you got above):
$ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/lib/tracker-0.7/

[1] The build directory might have any name and be placed in any convenient location: in this case you need to run cmake from the build directory with the command: $ cmake /path/to/fster-source-root.