In this guide there are some things are done in YAST and others in the terminal. I like YAST for installing software because I can see the version and the repo, and you can cancel if you like. The terminal is a must for other things but the entire install could be done in the terminal if you know how.

I own a Mac, have administered windows machines since 2000 and have been using linux since 2004. That being said I still consider myself a linux newb however I’m learning quickly. I take no responsibility for any damage to data or property, back it up!

This guide assumes that you have a general working knowledge of computers and have at least played around with linux namely openSuSE which is available from http://www.opensuse.org.

System requirements will depend on how many users access the iFolder server, the speed of your network and how often items are changing. I am a home user running openSuSE 11.3 64bit on a Pentium D 920 2.GHz, 4GB DDR2, GeForce 6800, 2.5TB. The system is also a MythTV Frontend and Backend server, FTP server and local print server Xen virtual machine with one 2.4GHz processor, 512mb ram, 1TB storage on a raid5 LVM allocated to it and no desktop, just the shell minimal server install. The host is running OpenSuSE 11.3 64bit on a Core 2 Quad Q6600 Kentsfield 2.4GHz 2 x 4MB L2 Cache, Cooler Master Silent Pro M 600W PSU, Asus P5QL-CM motherboard, 4GB PC6400 DDR2. It has 2@250gb hard drives in a raid1 array for the OS and 3@2TB WD Green drives (6TB) in a raid5 array (4TB) and a LVM on top of that for the VMs and additional storage, GNOME desktop (with all visual effects) accessing HULU and the rest of the internet as well as being the media server for the house and an FTP/Samba server for personal use. It sits in a cabinet under the TV hidden away in a black Silverstone LC13-e case. I use SSH and FreeNX to remotely administer the machine. It has bluetooth and a Logitech PlayStation 3 Cordless MediaBoard Pro. Two users are syncing around 350GB between 5 machines and it is an active DVR and everything is fine. One day I’ll drop a quad core in there. Got it!!

Your FQDN may or may not include the ‘www’ prefix and your installation needs to reflect this. If you browse to your domain name with ‘www’ and it stays there then use it. If it does not then don’t use it. If both work, pick one and stick with it. I prefer not to use the ‘www’ prefix for all my sites. Your SSL cert should reflect the correct FQDN.

File or folder move operations are handled as if the file was deleted and then uploaded again. Renaming is handled just as a rename function. Basically if you move something expect a high bandwith cost for the operation.

Windows users watch out for long filenames. Files cannot exceed a path and filename exceeding 256 characters or you will get errors in syncing. (needs verifying)

NOTE: USE THE 3.8.0.3 CLIENTS FROM SOURCEFORGE!!! 3.8.0.0 WILL NOT WORK!!

iFolder client files

http://sourceforge.net/projects/ifolder/files/

iFolder server files for openSuSE 11.3

ifolder3-enterprise

http://software.opensuse.org/search?q=ifolder3-enterprise&baseproject=openSUSE%3A11.3&lang=en&exclude_debug=true

novell-ifolder-enterprise-plugins (use the server snapshot with the same version of the ifolder3-enterprise eg. 3.8.4)

http://software.opensuse.org/search?q=novell-ifolder-enterprise-plugins&baseproject=openSUSE%3A11.3&lang=en&exclude_debug=true

iFolder Community

http://community.kablink.org/

irc

irc.freenode.net #ifolder

Download and install openSUSE 11.3 here: http://software.opensuse.org/113/en with GNOME (or KDE) as Desktop Environment (DE) (a DE is not required, but easy when needing to manage the system.). As iFolder utilizes Mono, GNOME seems a natural choice.

During partitioning you may want to edit the default configuration and NOT create a separate home partition.

Turn off the firewall either during the setup or in Yast. Security and Users after the install.

After install, open terminal. As root (that’s what this ‘#’ means) ensure ssh starts at boot (only if you need ssh).

# chkconfig sshd on

In Yast

Network Settings > Global Options

Disable IPv6 if not used

Network Settings > Overview

Edit your interface so it has a static ip

Network Settings > Hostname/DNS

Edit to match your configuration

Software Management

Remove the following

1. beagle

Add the following

1. kernel-source
2. gcc
3. gcc-c++
4. apache2-prefork
5. apache2-utils
6. apache2-mod_mono
7. mono-core
8. mono-data
9. mono-data-sqlite
10. mono-web
11. mono-winforms
12. libapr-util1
13. libapr1
14. libflaim
15. log4net
16. xsp
17. yast2-http-server
18. nano (optional)

Close Yast

REBOOT

# zypper ref

# zypper up

In the terminal, generate an ssl cert (5 year) using the FQDN of the iFolder Server.

# gensslcert -Y 1825 -n FQDN -e EMAIL@EXAMPLE.COM

Open Yast > HTTP Server module that was added (yast2-http-server). Using the defaults is fine here. Click Finish.

In the terminal, enable the apache2 modules that are needed.

# a2enmod ssl

# a2enmod mono

# a2enmod rewrite

In the terminal, ensure apache2 starts at boot then start it.

# chkconfig apache2 on

# rcapache2 start

In the terminal, set up the apache2 vhost-ssl.conf.

# cp /etc/apache2/vhosts.d/vhost-ssl.template /etc/apache2/vhosts.d/vhost-ssl.conf

Edit the /etc/apache2/vhosts.d/vhost-ssl.conf file and ensure the FQDN of the iFolder server is present as the ServerName in the file.

ServerName FQDN:443

Edit the /etc/hosts file and ensure the FQDN and the HOSTNAME of the iFolder server is present in the file. PUT BOTH!

127.0.0.1 localhost HOSTNAME

127.0.0.1 FQDN HOSTNAME

Edit the /etc/sysconfig/apache2 file and ensure APACHE_SERVER_FLAGS=”SSL” is present in the file.

Change your release version to OpenSuSE 11.3 before you search

Search for and ’1-Click Install’ the following two items.

1. ifolder3-enterprise (29MAR2011 using snapshot_snapshot)
2. novell-ifolder-enterprise-plugins (29MAR2011 using server_snapshot)

or click the links below

ifolder3-enterprise

http://software.opensuse.org/search?q=ifolder3-enterprise&baseproject=openSUSE%3A11.3&lang=en&exclude_debug=true

novell-ifolder-enterprise-plugins (use the server snapshot with the same version of the ifolder3-enterprise eg. 3.8.4)

http://software.opensuse.org/search?q=novell-ifolder-enterprise-plugins&baseproject=openSUSE%3A11.3&lang=en&exclude_debug=true

You can also run a oneclick from terminal by running the following. INCLUDE THE QUOTES.

# su -c “OCICLI url of the file.ymp”

Currently these are (but please verify at http://software.opensuse.org/ before using):

# su -c "OCICLI http://software.opensuse.org/ymp/network:ifolder:server_snapshot/openSUSE_11.3/ifolder3-enterprise.ymp"

# su -c "OCICLI http://software.opensuse.org/ymp/network:ifolder:server_snapshot/openSUSE_11.3/novell-ifolder-enterprise-plugins.ymp"

REBOOT

First of all, restart the apache service (I know we JUST rebooted the machine). Look for errors and fix them first.
# rcapache2 restart

Unless you have a good reason:

• The default data path is ‘/var/simias/data’. You may want to store the iFolder data in another location. You can change the default path or you can modify the mount point on another partition, drive or LV.
• The FQDN of the iFolder server for BOTH public and private addresses: ‘https://FQDN/simias10′
• System name & description can be modified to suite your needs
• If you have an LDAP(v3) source for provisioning users, go ahead select Y (yes) for LDAP, otherwise choose N (no) to set up a local user store. If you don’t know what LDAP is, choose N (no)
• Configure apache – YES!
• Other settings are default values

Run the Simias Server Setup

# simias-server-setup

Check the owner and group of the Simias data store

# chown -R wwwrun:www /var/simias/ (or the path you entered)

Restart apache and check for errors

# rcapache2 restart

Run the iFolder web interface setups and restart apache

# ifolder-admin-setup

# ifolder-web-setup

# rcapache2 restart

Have lots of fun

1. login with the admin credentials
2. create a new user
3. set the user’s home server
4. click save
5. look around

1. login with the new user
2. create a new ifolder
3. look around

http://sourceforge.net/projects/ifolder/files/

Install it and enter the address for the server as well as your credentials. I do not choose to create my default iFolder because I want to pick the folders already existing on my computer.

If you are syncing  different platforms and or multiple machines, you can setup an iFolder client and do an inital sync on one machine (preferably local to the server if applicable) then copy the physical files with an external drive or other way to the additional machine, using the SAME FOLDER NAME, and tell the client on the new machine to ‘Merge’ the folder. This will not do a complete upload/download of the files but will compare the files saving you bandwidth and time.  You may see files with ‘Conflicts’ that need to be resolved when doing this. Use the ‘Resolve’ button in the iFolder client to manually compare the file name, size and date. Usually they are the same.  You can choose to sync to the ‘Local’ or ‘Server’ version of the file. If I do a merge like stated above, I will use the ‘Server’ version.

USE THE 3.8.0.3 CLIENTS FROM SOURCEFORGE!!! 3.8.0.0 WILL NOT WORK!!

You can check the exact version of the client in Windows
C:\Program Files\iFolder
RT click on iFolderApp.exe > properties > details tab
Make sure its 3.8.0.3 or higher
If its 3.8.0.0 you need to uninstall it, delete the simias directory in %appdata% in winxp or %localappdata% in vista/7 and install the correct version

iFolder files

http://sourceforge.net/projects/ifolder/files/

iFolder Administrator Guide

http://ifolder.com/docs/ifolder38_admin.pdf

iFolder Community

http://community.kablink.org/

irc

irc.freenode.net #ifolder

On the iFolder Server

Unless you have a good reason to, DO NOT

WARNING – This will delete all simias server data as well as all local users and their files! If you run the simias-server-setup and type something incorrectly, remove the localsimias data store before rerunning (command is for the default location)

# rm -r /var/simias/

On the iFolder Client

Unless you have a good reason to, DO NOT:

WARNING – This will delete the local iFolder client data! You will need to reconnect to the iFolder server with a client.

OpenSuSE

# rm -r /home/user/.local/share/simias/

OS X

# rm -r /Users/user/.local/share/simias/

Windows Vista-7

delete %localappdata%\simias

Windows XP

delete %appdata%\simias

First of all ask yourself this. Is this iFolder server in production or is it a preproduction /test server.

For production machines in use be careful to protect the simias data folder!!!

For preproduction/test servers that are having troubles with the initial setup and configuration try to delete the simias directory on the server.
# rm -r /var/simias/

The below items are found in the “Configure Apache” section above

Recheck your /etc/hosts file for proper configuration

Recheck your /etc/apache2/vhosts.d/vhost-ssl.conf for proper configuration

Recheck your /etc/sysconfig/apache2 file for proper configuration

Restart apache

The below items are found in the “iFolder Server Setup” section above

Run simias-server setup

Check your simias folder owner and group

Run ifolder-admin-setup

Run ifolder-web-setup

USE THE 3.8.0.3 CLIENTS FROM SOURCEFORGE!!! 3.8.0.0 WILL NOT WORK!!

You can check the exact version of the client in Windows
C:\Program Files\iFolder
RT click on iFolderApp.exe > properties > details tab
Make sure its 3.8.0.3 or higher
If its 3.8.0.0 you need to uninstall it, delete the simias directory in %appdata% in winxp or %localappdata% in vista/7 and install the correct version

More to come