HowTo:Configuring iFolder Peer to Peer on SUSE Linux 10.0

From iFolder

Table of contents
1 Introduction
2 Prerequisites

2.1 Option #1 - Download the SUSE Linux 10.0 iFolder 3 RPMs from ifolder.com
2.2 Option #2 - Add a YaST repository that contains the SUSE Linux 10.0 iFolder 3 RPMs

3 Installing and configuring iFolder 3 client with Peer-to-Peer (P2P) simias-bonjour plugin

3.1 Install iFolder 3 RPMs
3.2 Configure mdns and simias-bonjour

4 Configuring SUSE Firewall for iFolder simias-bonjour P2P traffic

4.1 Disabling SUSE Firewall
4.2 Configuring SUSE Firewall to allow iFolder traffic and mdns broadcasts

[edit]

Introduction

This HowTo will walk you through the process of configuring the iFolder client to leverage the simias-bonjour Peer-to-Peer (P2P) functionality on SUSE Linux 10.0.

[edit]

Prerequisites

You will need to install a couple workstations on the same subnet with SUSE Linux 10.0 OSS (http://www.opensuse.com). The iFolder 3 RPMs are included on the SUSE Linux 10.0 OSS DVD. If your workstation(s) was installed using the SUSE Linux 10.0 OSS CDs, then you should follow one of the options outlined below on how to download the RPMs and configure YaST to utilize them.

[edit]

Option #1 - Download the SUSE Linux 10.0 iFolder 3 RPMs from ifolder.com

  • Open YaST
  • Select Software | Installation Source
  • Add a "Local Directory". Browse to the directory that contains the iFolder 3 RPMs. After selecting Ok, a warning dialog regarding "no product information" will be displayed. This dialog can safely be ignored by pressing continue
  • After saving the new repository, exit YaST
[edit]

Option #2 - Add a YaST repository that contains the SUSE Linux 10.0 iFolder 3 RPMs

  • Open YaST
  • Select Software | Installation Source
  • Add a HTTP repository like 
 http://ftp.opensuse.org/pub/opensuse/distribution/SL-10.0-OSS/inst-source/
  • Specify the "Server Name" as ftp.opensuse.org 
 NOTE: You may want to replace ftp.opensuse.org with your favorite mirror.
  • Specify the "Directory on the Server" as /pub/opensuse/distribution/SL-10.0-OSS/inst-source/
  • After saving the new repository, exit YaST
[edit]

Installing and configuring iFolder 3 client with Peer-to-Peer (P2P) simias-bonjour plugin

[edit]

Install iFolder 3 RPMs

  • Open YaST | Software | Software Management
  • Specify the "Search" filter and then search for ifolder3
  • Select and install the iFolder 3 RPM 
 Optionally you can install the nautilus-ifolder3 plugin for integration with Nautilus File Manager
  • When prompted about "Automatic Changes" (ie simias, simias-bonjour, mono-core, etc), select continue
[edit]

Configure mdns and simias-bonjour

  • Before the Peer-to-Peer funcionality will work, the following line in the /etc/nsswitch.conf needs to be modified
  • from
   hosts:      files dns
  • to
   hosts:      files dns mdns
  • After saving the changes to the /etc/nsswitch.conf file, the Name Service Cache Daemon (nscd) service must be restarted. As the user root, from a console, issue the following command 
 rcnscd restart

or 

 /etc/init.d/nscd restart
[edit]

Configuring SUSE Firewall for iFolder simias-bonjour P2P traffic

This section is only required if your workstation's Firewall is enabled. The Firewall service is enabled by default during the installation of SUSE Linux 10.0. There are two ways to deal with a Firewall, disable it (NOT Recommended) or configure it to allow traffic for the necassary services.

[edit]

Disabling SUSE Firewall

This method is not recommend. However, in certain situations like setting up iFolder P2P for the first time, it might be worth it to get iFolder P2P working without the hassle of configuring/troubleshooting the firewall.

- Open YaST | Security and Users | Firewall

- Select the "Stop Firewall Now" button 

 NOTE: To stop the Firewall on every reboot, change the Service Start from 
 "When Booting" to "Manually" and save the change.
[edit]

Configuring SUSE Firewall to allow iFolder traffic and mdns broadcasts 

 NOTE: This HowTo is making the assumption that you have a single network card
 in your workstations. If you have a more advanced setup, please review the 
 Firewall's documentation on how to apply the following settings to your 
 environment.
  • Open YaST | Security and Users | Firewall
  • Go to the Allowed Services section
  • Verify that the "Allowed Services for Selected Zone" drop down list has "External Zone" selected
  • Select the Advanced button
  • In the UDP Ports section add 5353 for the mdnsd service
  • In the TCP Ports section add the port that iFolder (technically it's the simias process) listens on. 
 NOTE: On initial startup, the iFolder client dynamically assigns a TCP port to 
 be used. This setting is then stored in the ~/.local/share/simias/Simias.config 
 file and re-read on subsequential iFolder client startups. Thare are two methods 
 to determine what TCP port iFolder listens on.

 Method #1 - If the iFolder app is running, stop it. Once it has been stopped, 
 open a console and issue the following command

 /usr/bin/ifolder

 There will be output from the command that looks something like this

 Listening on port: 1099

 In this case the TCP port 1099 would be added to the allowed services

 Method #2 - Open the ~/.local/share/simias/Simias.config and look for the 
 following entry

 <setting name="WebServiceUri" value="http://127.0.0.1:1027/simias10/antec" />

 In this case the TCP port 1027 would be added to the allowed services
Retrieved from "http://www.ifolder.com/index.php/HowTo:Configuring_iFolder_Peer_to_Peer_on_SUSE_Linux_10.0"