Attention: The following is a work in progress. The following is EXPERIMENTAL and should be used by experienced users only.
Problems? Suggestions? Able to help with packaging? Please join the following group: http://groups.google.com/group/ifolder-ubuntu-debian-dev
This guide covers installing the iFolder Client and installing the iFolder server. Both of these require that Simias be installed first. Thus, this guide is divided into three sections: Installing Simias, Installing iFolder Client 3.8, and iFolder Server 3.8.
64-bit platforms: Known to work using gcc-4.3. May also work with gcc-4.4 (please edit if true.) Based on this thread it appears that when simias is compiled with gcc-4.5 (which is the default gcc on Natty) simias fails to run on x64 platforms. Installing debs which were compiled with gcc-4.4 (i.e., those compiled on Ubuntu 10.04 (Lucid) or Ubuntu 10.10 (Maverick)) onto more recent versions of Ubuntu seemed to work for at least one user.
32-bit platforms: gcc-4.6 (Oneiric) seems to work. gcc-4.5 (Natty) might also work (please edit if true).
Ubuntu 10.10 (Maverick) main and universe repositories contain all packages needed to install iFolder.
Ubuntu 10.04 LTS (Lucid) requires you to add an extra repository:
sudo bash -c "echo '# Badgerports repository. Contains cli-common-dev required by iFolder.' > /etc/apt/sources.list.d/badgerports-lucid.list" sudo bash -c "echo 'deb http://badgerports.org/ lucid main' >> /etc/apt/sources.list.d/badgerports-lucid.list" wget http://badgerports.org/directhex.ppa.asc -O - | sudo apt-key add - sudo apt-get update
(Debian Squeeze contains all packages needed except libflaim*. Experienced users should add the Ubuntu Maverick universe repository to pull in the libflaim* dependency. Debian Wheezy (testing) 32-bit compiles successfully using gcc-4.6, but 64-bit does not.)
Install packages required for building.
sudo apt-get install bzr bzr-builddeb equivs
Get the source code and install build dependencies.
cd /tmp bzr branch http://bazaar.launchpad.net/~csights/+junk/simias/ cd simias mk-build-deps sudo dpkg -i simias-build-deps_1.0_all.deb
You will likely see errors. They indicate that dpkg doesn't install dependencies automatically. Use your favourite package manager to install any missing build dependencies. (e.g.: sudo apt-get -f install)
During execution of bzr-buildpackage you will receive the following error message, which you can safely ignore. It's related to package signing which can only be done by the maintainer.
running debsign failed bzr: ERROR: The build failed.
If you run into other problems, try installing these dependencies:
sudo apt-get install build-essential automake autoconf mono-complete liblog4net1.2-cil uuid-dev libxml2-dev mono-apache-server mono-apache-server2 gsoap libapache2-mod-mono libncurses-dev libtool g++ gcc
The last step is to install the generated packages.
cd ../build-area sudo dpkg -i libsimias*deb simias-client*deb
Make sure there are no broken dependencies using your favourite package manager. (e.g.: sudo apt-get -f install)
Installing iFolder Client 3.8
1. Follow the instructions to compile and install Simias above.
2. Get the source code and install build dependencies.
cd /tmp bzr branch http://bazaar.launchpad.net/~csights/+junk/ifolder-client/ cd ifolder-client mk-build-deps sudo dpkg -i ifolder3-build-deps_1.0_all.deb
3. Use your favourite package manager to install any missing build dependencies. (e.g.: sudo apt-get -f install)
5. Install the generated packages.
cd ../build-area sudo dpkg -i ifolder3-client*deb
6. Workaround if ~/.local/share/simias is on (some types of) encrypted directories. If not using encryption, skip the next steps. The example user is named user1. Create a directory in a non-encrypted directory:
sudo mkdir /tmpsimias sudo chown user1:user1 /tmpsimias ln -s /tmpsimias ~/.local/share/simias
Run iFolder for the first time and exit. This initializes iFolder's database. Then move the unencrypted directory into the encrypted directory.
rm ~/.local/share/simias mv /tmpsimias ~/.local/share/simias
End Workaround for encrypted directory. iFolder is now happy.
7. Start the program. (Should also be in desktop GUI menus.)
Notice : Do not run as superuser (root)! Otherwise you will receive the following error : Authentification error : Timeout.
Clients for Macintosh and Windows can be found here: http://sourceforge.net/projects/ifolder/files/
iFolder Server 3.8
1. Follow the instructions to compile and install Simias above Follow the instructions to compile and install Simias above. This is already done if you followed the instructions to compile iFolder Client.
2. Then install these packages:
cd ../build-area sudo dpkg -i simias-server*deb libsimias0*deb
3. Again, make sure there are no broken dependencies using your favourite package manager. (e.g.: sudo apt-get -f install)
A number of configuration questions will appear on screen. This tool is creating configuration files for Apache and Simias. If you find out later that you made a mistake you can reconfigure Simias using the command dpkg-reconfigure simias-server.
When the configuration prompts finish, again make sure there are no broken dependencies using aptitude or your favourite package manager.
The following section describe how to enable SSL on Apache2. As it's not a documentation about Apache or Security, it's just describe the easiest way to get it work. Generate a SSL certificate with the following command.
sudo make-ssl-cert generate-default-snakeoil
Enable SSL module and rewrite module for apache.
sudo a2enmod ssl sudo a2enmod rewrite
Add the following content at the top of /etc/apache2/sites-available/default.
<VirtualHost _default_:443> SSLEngine on SSLOptions +StrictRequire SSLCertificateFile /etc/ssl/certs/ssl-cert-snakeoil.pem SSLCertificateKeyFile /etc/ssl/private/ssl-cert-snakeoil.key </VirtualHost>
Make sure mod_mono is enabled
sudo a2enmod mod_mono
sudo /etc/init.d/apache2 restart
Configure iFolder Server
iFolder is configured through http://yourserver/admin . Add at least one user, then connect using iFolder Client.