Difference between revisions of "Installation"
(→compilation from sources on gentoo)
Revision as of 22:27, 21 November 2011
There are two ways to use FSArchiver. You can either download a livecd with this program on it (eg: any recent SystemRescueCd), or you can install it on a linux system on your computer. If you want to install FSArchiver, you have three solutions:
- you can use the official fsarchiver package that comes with your Linux distribution (recommended method)
- you can just copy the official static binary (very easy: you just have one standalone binary file to copy)
- you can compile fsarchiver from sources
Installation from sources
If you want to compile it from sources, you will need to have the following libraries installed on your system, including their header files. On RPM based distributions, you often have to install packages such as libXXX-devel.rpm to have the header files, since the base package (libXXX.rpm) does not provide these files. Here are the required libraries:
- zlib (and zlib-devel)
- liblzo (and lzo-devel)
- bzip2-libs (and bzip2-devel)
- libgcrypt (and libgcrypt-devel)
- libblkid (and libblkid-devel)
- e2fsprogs-libs (e2fsprogs-devel)
- xz-utils-5.00 (and xz-devel)
If libraries or header files are missing:
- In case you don't have the xz/liblzma or liblzo installed, you have the ability to compile fsarchiver with no support for lzma or lzo:
./configure --prefix=/usr --disable-lzma --disable-lzo && make && make install
You can also use the static that provides support for all the compression levels and which does not require the libraries to be installed on your system.
To compile the sources, you have to run follow these instructions:
1. download the latest sources
First, you have to download the latest sources, it's a file called fsarchiver-x.y.z.tar.gz. Just save it to a temporary directory.
2. extract the sources in a temporary directory
mkdir -p /var/tmp/fsarchiver cd /var/tmp/fsarchiver tar xfz /path/to/fsarchiver-x.y.z.tar.gz
3. compile and install from sources
cd /var/tmp/fsarchiver/fsarchiver-x.y.z ./configure --prefix=/usr make && make install
Installation of the precompiled binary
If the compilation does not work, you can just download the static binary, extract it, and copy the binary somewhere on your system (/usr/sbin for instance). There is just one 32bit binary for i386. If you are using a 64bit linux, this binary should work since most the 64bit linux kernels are able to execute 32bit binary, thanks to the option CONFIG_IA32_EMULATION.
Uninstalling fsarchiver is easy since it only installs one file on your system, which is the compiled binary. To uninstall fsarchiver, just remove
FSArchiver has to kind of dependencies: libraries and file-system tools.
Several libraries with their header files are necessary to compile the sources (cf previous section about installation) and to execute the program if it has not been compiled in a static way. You can avoid the problem with libraries dependencies by using the static binary that you can download from the sourceforge download page.
file-system tools required
The file-system tools for the file-system you are using are required to restore a file-system.
You should not have any problem with the file-system tools (such as a program which is missing because it is not installed) when you save the file-system (using
fsarchiver savefs). You only need the file-system tools (such as e2fsprogs, reiserfsprogs, xfsprogs, ...) when you want to restore a file-system. And it should not really be a problem since you often want to restore a file-system by booting from a livecd such as SystemRescueCd, since you cannot restore your root file-system when you are using it, so booting from a livecd / usb-stick is mandatory in that case.
FSArchiver only requires the tools that match the file-system of the restoration. For instance, if you are trying to restore an archive to a reiserfs partition, you will need the reiserfsprogs to be available, even if the original filesystem was ext3 when you saved the file-system to an archive.
Distribution specific information
installation on fedora (using yum)
Recent Fedora releases provide an official package for fsarchiver where all the optional features are enabled (lzma compression, encryption, ...). You can just use the following command to download and install fsarchiver and all its dependencies.
yum install fsarchiver
installation on ubuntu (using apt-get)
sudo apt-get install fsarchiver
If you want to compile it by hand on Ubuntu, here are the instructions to install the required libraries and to compile the sources:
apt-get install zlib1g-dev libssl-dev libbz2-dev liblzo2-dev e2fslibs-dev attr-dev libblkid-dev uuid-dev libgcrypt11-dev liblzma2 tar xfz fsarchiver-0.6.11.tar.gz cd fsarchiver-0.6.11 ./configure --prefix=/usr && make && make install
installation on debian (using apt-get)
Thanks to Michael Biebl there is now a fsarchiver deb package for debian. You can just install it with the normal command:
apt-get update apt-get install fsarchiver/testing
installation on arch-linux (using pacman)
pacman -S fsarchiver
installation on SUSE (using zypper)
- There is an official fsarchiver package for Suse.
- There are three ways to install software in SUSE:
- First, following the link above with "one click install" -- simpliest way.
- Second, add additional repository and install with GUI-tool YaST.
- Third, add additional repository and install with CLI-tool zypper.
- To add a repository with the CLI: zypper ar <repository-url> (see repository addresses below)
- To install fsarchiver with the CLI: zypper in fsarchiver
- openSUSE 11.2 stable:
- openSUSE 11.2 unstable:
- openSUSE 11.1
- openSUSE 11.0
- SLE 11 (SLES+SLED)
- openSUSE Factory
- Here is the command to install development packages if you want to compile it by hand:
- zypper install libgcrypt-devel lzo-devel zlib-devel xz-devel libbz2-devel libext2fs-devel libblkid-devel libuuid-devel libattr-devel
compilation from sources on debian
Here are the instructions to install the required libraries and to compile the sources on Debian-6.0 (Squeeze):
apt-get install e2fsprogs zlib1g-dev libbz2-dev liblzma-dev liblzo2-dev libgcrypt11-dev e2fslibs-dev uuid-dev libblkid-dev libattr1-dev pkg-config tar xfz fsarchiver-0.6.11.tar.gz cd fsarchiver-0.6.11 ./configure --prefix=/usr && make && make install
Here are the instructions to install the required libraries and to compile the sources on Debian-5.0 (Lenny):
apt-get install e2fsprogs e2fslibs-dev libblkid-dev liblzo2-dev libbz2-dev zlib1g-dev uuid-dev libattr1-dev libgcrypt11-dev pkg-config tar xfz fsarchiver-0.6.11.tar.gz cd fsarchiver-0.6.11 ./configure --prefix=/usr --disable-lzma && make && make install
Unfortunately, there is no stable package for liblzma for Lenny, so you cannot compile support for lzma if you only have stable packages on your system. If you want to enable the support for lzma in fsarchiver, you will have to install liblzma-dev from testing using apt-get:
apt-get install liblzma-dev/testing tar xfz fsarchiver-0.6.11.tar.gz cd fsarchiver-0.6.11 ./configure --prefix=/usr && make && make install
compilation from sources on rhel / centos
Here are the instructions to install the required libraries and to compile the sources on RHEL/CentOS version 6:
yum install zlib-devel bzip2-devel lzo-devel xz-devel e2fsprogs-devel libgcrypt-devel libattr-devel libblkid-devel tar xfz fsarchiver-0.6.11.tar.gz cd fsarchiver-0.6.11 ./configure --prefix=/usr && make && make install
Here are the instructions to install the required libraries and to compile the sources on RHEL/CentOS version 5: Unfortunately there was no xz-utils package in version 5, so you won't get support for xz/lzma compression:
yum install zlib-devel bzip2-devel e2fsprogs-devel libgcrypt-devel libattr-devel libblkid-devel tar xfz fsarchiver-0.6.11.tar.gz cd fsarchiver-0.6.11 ./configure --prefix=/usr --disable-lzma --disable-lzo && make && make install
compilation from sources on gentoo
Gentoo implements the support for packages using ebuild files. There is now an official ebuild for fsarchiver in gentoo, so you can directly install it using the "emerge" command as long as your portage tree is recent. You may also have to change the keywords to make the installation possible:
- Add app-backup/fsarchiver to your /etc/portage/package.keyworks if required:
echo "app-backup/fsarchiver ~*" >> /etc/portage/package.keywords
- Change the USE if you want non-default compilation options:
echo "app-backup/fsarchiver lzma lzo gcrypt static" >> /etc/portage/package.use
- Run the installation command: