Novell iFolder Open Source User guide

forge.novell.com

Novell Confidential Manual (ENU) 21 December 2004

iFolder

TM

September 29, 2005

USER GUIDE

Novell Confidential Manual (ENU) 21 December 2004

Legal Notices

Novell, Inc., makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express

or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc., reserves the right to revise this publication and to

make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.

Further, Novell, Inc., makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties

of merchantability or fitness for any particular purpose. Further, Novell, Inc., reserves the right to make changes to any and all parts of Novell software,

at any time, without any obligation to notify any person or entity of such changes.

You may not use, export, or re-export this product in violation of any applicable laws or regulations including, without limitation, U.S. export

regulations or the laws of the country in which you reside.

Free Documentation License (GFDL), Version 1.2 or any later version, published by the Free Software Foundation with no Invariant Sections, no

Front-Cover Texts, and no Back-Cover Texts. A copy of the GFDL can be found at http://www.fsf.org/licenses/fdl.html.

THIS DOCUMENT AND MODIFIED VERSIONS OF THIS DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREE

DOCUMENTATION LICENSE WITH THE FURTHER UNDERSTANDING THAT:

1. THE DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,

INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS FREE

OF DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING. THE ENTIRE RISK AS TO THE

QUALITY, ACCURACY, AND PERFORMANCE OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS WITH YOU.

SHOULD ANY DOCUMENT OR MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL WRITER,

AUTHOR OR ANY CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS

DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED

VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER; AND

2. UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT,

OR OTHERWISE, SHALL THE AUTHOR, INITIAL WRITER, ANY CONTRIBUTOR, OR ANY DISTRIBUTOR OF THE DOCUMENT OR

MODIFIED VERSION OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY

DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT

LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND

ALL OTHER DAMAGES OR LOSSES ARISING OUT OF OR RELATING TO USE OF THE DOCUMENT AND MODIFIED VERSIONS OF

THE DOCUMENT, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES.

Novell, Inc., has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and

without limitation, these intellectual property rights may include one or more of the U.S. patents listed at http://www.novell.com/company/legal/

patents/ and one or more additional patents or pending patent applications in the U.S. and in other countries.

Novell, Inc.

404 Wyman Street, Suite 500

Waltham, MA 02451

U.S.A.

www.novell.com

iFolder User Guide

September 29, 2005

Online Documentation: To access the online documentation for this and other Novell products, and to get updates, see

www.novell.com/documentation.

Novell Confidential Manual (ENU) 21 December 2004

Novell Trademarks

iFolder is a trademark of Novell, Inc.

GroupWise is a registered trademark of Novell, Inc., in the United States and other countries.

Mono is a registered trademark of Novell, Inc., in the United States and other countries.

Novell is a registered trademark of Novell, Inc., in the United States and other countries.

Novell iFolder is a registered trademark of Novell, Inc., in the United States and other countries.

Red Carpet is a registered trademark of Novell, Inc., in the United States and other countries.

ZENworks is a registered trademark of Novell, Inc., in the United States and other countries.

Third-Party Materials

All third-party trademarks are the property of their respective owners.

Novell Confidential Manual (ENU) 21 December 2004

5

Novell Confidential Manual (99a) 21 December 2004

Contents

About This Guide 7

1 Overview of iFolder 9

iFolder Sharing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Benefits of iFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Key Features of iFolder. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

The iFolder Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

iFolder Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Shared iFolders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

iFolder Access Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

File Synchronization and Data Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Synchronization Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Cross-Platform Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

What’s Next. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

2 Using iFolder with SimpleServer 13

Simple Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Benefits of Using Simple Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Sharing iFolders Through a Simple Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Key Features of iFolder When Used with Simple Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

iFolder Simple Server Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Shared iFolders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

How to Install and Configure a Simple Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

What’s Next. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

3 Coexistence Issues 17

Coexistence of Novell iFolder 2.1x and iFolder Clients. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Coexistence Peer-to-Peer, Simple Server, and Novell iFolder 3.x Accounts. . . . . . . . . . . . . . . . . . . . . . . 17

4 Getting Started 19

Prerequisites and Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Client Computers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Mono . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Web Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Network Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Simple Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Downloading the iFolder Client Install Files for Use with Simple Server . . . . . . . . . . . . . . . . . . . . . . . . . 21

Downloading Additional Files for Peer-to-Peer Sharing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Installing the iFolder Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Installing iFolder for Novell Linux Desktop 9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Installing iFolder for Windows 2000/XP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Installing iFolder for Macintosh OS X v10.3 and Later . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Updating iFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Updating Mono for Linux and Macintosh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

What’s Next. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

6 iFolder User Guide for Novell iFolder 3.x

Novell Confidential Manual (99a) 21 December 2004

5 Managing iFolder Accounts and Preferences 27

Starting the iFolder Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Configuring an iFolder Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Logging In to an iFolder Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Viewing and Modifying iFolder Account Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Deleting an iFolder Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Configuring iFolder Preferences for the Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Configuring Local Firewall Settings for iFolder Traffic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Configuring Local Virus Scanner Settings for iFolder Traffic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

6 Managing iFolders 37

Guidelines for Locating iFolders. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Guidelines for File Types and Sizes to Be Synchronized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Naming Conventions for an iFolder and Its Folders and Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Creating an iFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Creating iFolders in a File Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Creating iFolders in the iFolders Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Creating iFolders on a FAT32 Mount Point (Linux) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Sharing an iFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Understanding User Access Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Adding a User to an iFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Modifying User Access Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Removing a User from an iFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Setting Up an Available iFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Viewing and Configuring Properties of an iFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Synchronizing Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Resolving File Conflicts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Reverting an iFolder to a Normal Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Moving an iFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Deleting an iFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

A Uninstalling the iFolder Client 49

Before You Uninstall iFolder. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

iFolder Client for Novell Linux Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

iFolder Client for Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

iFolder Client for Macintosh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

B Troubleshooting 53

iFolder File Fails to Synchronize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

All iFolders in an Account Fail to Synchronize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Problem Synchronizing Some Files on a FAT32 File System on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Client Fails to Set Up a New iFolder Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Repopulating Contents of a Read Only iFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

GroupWise Files Become Corrupted in an iFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

C Documentation Updates 57

September 29, 2005. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

About This Guide 7

Novell Confidential Manual (ENU) 21 December 2004

About This Guide

This guide describes how to install and use the iFolder

TM

client. This guide is intended for users

and is divided into the following sections:

 Chapter 1, “Overview of iFolder,” on page 9

 Chapter 2, “Using iFolder with SimpleServer,” on page 13

 Chapter 3, “Coexistence Issues,” on page 17

 Chapter 4, “Getting Started,” on page 19

 Chapter 5, “Managing iFolder Accounts and Preferences,” on page 27

 Chapter 6, “Managing iFolders,” on page 37

 Appendix A, “Uninstalling the iFolder Client,” on page 49

 Appendix B, “Troubleshooting,” on page 53

Documentation Conventions

In Novell documentation, a greater-than symbol (>) is used to separate actions within a step and

items in a cross-reference path.

A trademark symbol (

®

,

TM

, etc.) denotes a Novell trademark. An asterisk (*) denotes a third-party

trademark.

When a single pathname can be written with a backslash for some platforms or a forward slash for

other platforms, the pathname is presented with a backslash. Users of platforms that require a

forward slash, such as Linux* or UNIX*, should use forward slashes as required by your software.

User Comments

We want to hear your comments and suggestions about this manual and the other documentation

included with this product. Please use the User Comment feature at the bottom of each page of the

online documentation, or go to www.novell.com/documentation/feedback.html and enter your

comments there.

Documentation Updates

For the most recent version of the iFolder User Guide, see the iFolder open source documentation

Web site (http://www.novell.com/documentation/ifolderos/).

For emerging issues, see the iFolder Readme (http://www.novell.com/documentation/ifolderos/

readme/data/readme.html).

8 iFolder User Guide

Novell Confidential Manual (ENU) 21 December 2004

Additional Documentation

 iFolder Project Web site (http://www.ifolder.com)

 iFolder Software Developers Kit (http://forge.novell.com/modules/xfmod/docman/

?group_id=1372).

 Novell iFolder 3.x documentation Web site (http://www.novell.com/documentation/ifolder3/

index.html)

 Novell Linux Desktop 9 product Web site (http://www.novell.com/products/desktop/)

 Novell Linux Desktop 9 documentation Web site (http://www.novell.com/documentation/nld/

treetitl.html)

The iFolder Documentation Project

For information about how to join and contribute to the iFolder Documentation Project, see the

iFolder Doc Project (http://forge.novell.com/modules/xfmod/docman/?group_id=1372).

Overview of iFolder 9

Novell Confidential Manual (ENU) 21 December 2004

1 Overview of iFolder

iFolder

TM

is a file-sharing application for Linux, Windows*, and Macintosh* clients. You can

share files in multiple iFolders, each with a different group of users. You control who can

participate in an iFolder and the access level for each member. You can also participate in iFolders

that others share with you.

This section familiarizes you with the various benefits and features of iFolder:

 “iFolder Sharing” on page 9

 “Benefits of iFolder” on page 9

 “Key Features of iFolder” on page 10

 “Cross-Platform Considerations” on page 12

 “What’s Next” on page 12

iFolder Sharing

Typically, when you work in multiple locations or in collaboration with others, you must

conscientiously manage file versions. With iFolder, the most recent version of your files can

follow you to any computer where you have installed the iFolder client and set up the shared

iFolder. iFolder also allows you to share multiple iFolders and their separate content with other

authorized users. You decide who participates in each iFolder and the level of access for each

member. Similarly, you can participate in shared iFolders that are owned by others in your

collaboration environment.

The iFolder client supports sharing by synchronizing files across multiple computers through a

central computer. It allows you to do the following:

 Share files across computers

 Share files with others

 Own multiple iFolders

 Participate in multiple iFolders that other users share with you

 Participate as the owner or a member of iFolders in multiple accounts

Benefits of iFolder

iFolder provides the following benefits:

 Integrates with your native desktop environment, making it easy to create and manage

multiple iFolders

 Is highly scalable and flexible, with no practical limit on the number of iFolders per user or

on the number of members per iFolder

10 iFolder User Guide

Novell Confidential Manual (ENU) 21 December 2004

 Allows you to easily and selectively share personal and business files

 Allows you to control the access level of member users of the iFolders you own or where you

have the necessary rights to control the access rights of members

 Transparently updates your files to member iFolders on multiple workstations

 Tracks and logs changes made while you work offline, and synchronizes those changes when

you go online

 Provides secure authentication of member iFolders to synchronize data

 Offers an alternative to exchanging files via e-mail, which avoids the file-size limits on e-mail

attachments and reduces your e-mail storage requirements

Key Features of iFolder

Before you begin to use iFolder, it is important to understand the following key features:

 “The iFolder Client” on page 10

 “iFolder Account” on page 10

 “Shared iFolders” on page 11

 “iFolder Access Rights” on page 11

 “File Synchronization and Data Management” on page 11

 “Synchronization Log” on page 12

The iFolder Client

The iFolder client integrates with your operating system to provide iFolder services in your native

desktop environment. iFolder supports the following operating systems:

 Novell Linux Desktop 9

 Windows 2000/XP

 Macintosh OS X v10.3 or later

The iFolder client allows you to manage your own iFolders and to select which shared iFolders to

set up on each computer. For information, see “Managing iFolders” on page 37.

iFolder Account

You must configure at least one iFolder services account before you create iFolders. An iFolder

session begins when you log in to an iFolder services account and ends when you log out, or when

you exit the iFolder client. Your iFolders synchronize files with other active iFolders only when

your session is active and you are working online. You can access data in your local iFolders at

any time, whether you are logged in to the account, or not. For information, see “Configuring an

iFolder Account” on page 28.

Overview of iFolder 11

Novell Confidential Manual (ENU) 21 December 2004

Shared iFolders

An iFolder is a local directory that selectively shares and synchronizes files via a central computer

with a user-specified group of users. The iFolder files are accessible to all iFolder members and

can be changed by those with the rights to do so. You can access your iFolders across multiple

workstations and share them with others.

You work with iFolders directly in your file manager or in the iFolders browser that is part of the

client. Within the iFolder, you can set up any subdirectory structure that suits your personal or

corporate work habits. The subdirectory structure is constant across all member iFolders. When

you share an iFolder, member users with the Write right can modify the directory structure, and

those changes apply to all copies of the iFolder. Each user can locate the shared iFolder anywhere

on his or her own computer that satisfies the “Guidelines for Locating iFolders” on page 37.

iFolder Access Rights

The iFolder client supports the owner and three levels of access for members of an iFolder:

 Owner: Only one user serves as the owner of an iFolder. This is typically the user who creats

the iFolder. The owner user can use the iFolder client to transfer ownership to another member

of the iFolder.

The owner of an iFolder has the Full Control right. This user has read/write access to the

iFolder, manages membership and access rights for member users, and can remove the Full

Control right for any member.

 Full Control: A member of the shared iFolder, with the Full Control access right. This

member has read/write access to the iFolder and manages membership and access rights for

all users except the owner.

 Read/Write: A member of the shared iFolder, with the Read/Write access right to directories

and files in the iFolder.

 Read Only: A member of the shared iFolder, with the Read Only access right to directories

and files in the iFolder. This member can modify a file, but the local changes are not

synchronized to other members’ copies of the iFolder.

Any iFolder user can own some iFolders and be a member of other iFolders. As an owner user,

you always have the Full Control right. As a member user, your level of access in each shared

iFolder can differ, depending on the access granted to you by any member with the Full Control

right.

File Synchronization and Data Management

When you set up an iFolder account, you can enable Remember Password so that iFolder can

synchronize iFolder invitations and files in the background as you work.

You can configure the iFolder client to run automatically each time you log in to your computer’s

desktop environment. The session runs in the background as you work with files in your local

iFolders, tracking and logging any changes you make.

You can synchronize the files at specified intervals or on demand.

12 iFolder User Guide

Novell Confidential Manual (ENU) 21 December 2004

Synchronization Log

The synchronization log displays a log of your iFolder background activity, such as uploading and

downloading files for different iFolders.

Cross-Platform Considerations

The user intefaces for the Linux, Windows, and Macintosh versions of the iFolder client conform

to interface conventions of their individual platforms. The way you perform common tasks is

parallel in each platform, but you might observe slight differences in the buttons, the display area,

function labels, the location of the desktop notification area, the start iFolder preference, and so on

as you perform the tasks. Except where procedures differ explicitly, this guide provides

instructions for only one of the three platforms.

The following table lists some typical differences in the client interface:

What’s Next

For instructions for downloading, installing, and configuring iFolder, see “Getting Started” on

page 19.

For information about using the iFolder client with Simple Server, see Chapter 2, “Using iFolder

with SimpleServer,” on page 13.

For information about coexistence issues for using iFolder, see Chapter 3, “Coexistence Issues,”

on page 17.

Task Linux Windows Macintosh

iFolder menu Quit Exit Quit

iFolder Preferences >

Accounts

Add and Remove buttons New and Delete buttons Plus (+) and Minus (-) buttons

Multiple locations Close button

Actions are committed when

you perform the action.

OK, Cancel, and Apply

buttons

Actions are committed only

when you click Apply or OK.

Close button

Actions are committed when

you perform the action.

iFolder Preferences Leave the iFolder client

running when you shut down

(and GNOME restarts it

automatically on startup)

Enable Start iFolder on login Add iFolder to the desktop’s

Startup items

Notification area Notification area Status and Notification area Notification area

iFolders > iFolder menu Properties Properties Get Info

Using iFolder with SimpleServer 13

Novell Confidential Manual (ENU) 21 December 2004

2 Using iFolder with SimpleServer

This section discusses how the iFolder

TM

client works with Simple Server.

 “Simple Server” on page 13

 “Benefits of Using Simple Server” on page 14

 “Sharing iFolders Through a Simple Server” on page 14

 “Key Features of iFolder When Used with Simple Server” on page 15

 “How to Install and Configure a Simple Server” on page 15

 “What’s Next” on page 15

Simple Server

Simple Server is an open source component of Simias (the synchronization engine that runs

iFolder). It is designed for developers to provide a basic iFolder Server to host iFolders.

Installation Is Manual

Simple Server must be manually compiled and configured. It is not integrated into YaST for easy

setup and configured.

HTTP Server

Simple server contains an embedded HTTP server, which does not support secure HTTP (SSL)

connections.

User Accounts Setup via XML

Simple Server uses a simple XML file for user account creation and authentication.

Administration Is Manual

Simple Server does not provide built-in administration functionality. Users and credentials are

stored in an XML file that must be manually edited.

Web Access Is Not Supported

Simias Server does not provide browser-based access to iFolders and their contents.

Backup Is Not Supported

Simple Server does not provide mechanisms for automatic back up of the iFolder database (the

Simias store).

14 iFolder User Guide

Novell Confidential Manual (ENU) 21 December 2004

Benefits of Using Simple Server

In addition to the “Benefits of iFolder” on page 9, using the iFolder client with Simple Server

provides the following capabilities:

 Allows you to create iFolders and store files on a central server, which can provide higher

availability to users than does peer-to-peer sharing

 Allows you to set up predetermined user accounts in an XML file

 Backs up local files to a server

 Centralizes the hosting of iFolders so the iFolder data store is available for backup to media

using a third-party backup solution

Sharing iFolders Through a Simple Server

Simple server accounts can coexist with peer-to-peer sharing. In the following example, Ulrik

owns an iFolder named Denmark and shares it via his iFolder account with Nigel, Luc, and Alice.

Nigel travels frequently, so he also set up the iFolder on his laptop. In addition, Alice shares a non-

work iFolder with her friend Ulrik using peer-to-peer sharing. In this example, an asterisk next to

the folder name indicates the iFolder owner.

Figure 1 Collaboration and Sharing with Simple Server and iFolder

The iFolder client synchronizes the most recent version of documents to all authorized users of

your shared iFolder. All that you and other iFolder members need is an active network connection

and the iFolder client. With a server, your iFolders are stored centrally where they are easily

accessed by all iFolder members.

Internet

Nigel's Desktop

Denmark

Liverpool

MyDocs

Luc's Desktop

Denmark

HR

Mtn Biking

Alice's Desktop

Denmark

Scooters*

Utah

Ulrik's Desktop

Denmark*

Scooters

MyStuff

Nigel's Laptop

Denmark

TeamOne

Customers

Simple Server

Workgroup Host:

Scooters

* iFolder Owner

Simple Servers

Host: Scooters

Using iFolder with SimpleServer 15

Novell Confidential Manual (ENU) 21 December 2004

Key Features of iFolder When Used with Simple Server

In addition to the “Key Features of iFolder” on page 10, using the iFolder client with Simple

Server provides enhanced capabilities for the following features:

 “iFolder Simple Server Account” on page 15

 “Shared iFolders” on page 15

iFolder Simple Server Account

The administrator of the Simple Server provisions accounts for users in an XML file. You can have

a only one account on any given Simple Server, but you can have multiple accounts. Contact your

administrator for the IP address (such as 192.168.1.1) or DNS name (such as

ifolderss.example.com) of the server where you have been assigned account. Log in using your

assigned username and password.

You must set up your Simple Server account before you can set up iFolders for it. The iFolder

client allows you to set up multiple accounts, where a single account represents a given server or

the workgroup account. You specify the server address, username, and password to uniquely

identify an account. On your computer, log in as the local user identity you plan to use to access

an account and its iFolders, then set up the iFolder. Under your local login, you can set up multiple

iFolder accounts, but each account must belong to a different Simple Server.

For information, see “Configuring an iFolder Account” on page 28.

Shared iFolders

For your Simple Server account, you can share iFolders only with other users who also have an

account on the same server. Contact your Simple Server administrator if you need to share iFolders

with a user or group of users who are not yet provisioned for services on that server.

The server hosts every iFolder created for that account. When you create an iFolder, the enterprise

server makes it available to the specified list of users.

How to Install and Configure a Simple Server

For more information about how to install and configure a Simple Server, see HowTo: Set Up a

Simple Server (http://www.ifolder.com/index.php/HowTo:Set_up_Simple_Server) on the iFolder

Web site (http://www.ifolder.com).

What’s Next

If you currently use Novell

®

iFolder

®

2.1x or 3x in your environment, make sure to read Chapter

3, “Coexistence Issues,” on page 17, then go to Chapter 4, “Getting Started,” on page 19.

16 iFolder User Guide

Novell Confidential Manual (ENU) 21 December 2004

Coexistence Issues 17

Novell Confidential Manual (ENU) 21 December 2004

3 Coexistence Issues

This section discusses the following coexistence issues for the open source iFolder

TM

client.

 “Coexistence of Novell iFolder 2.1x and iFolder Clients” on page 17

 “Coexistence Peer-to-Peer, Simple Server, and Novell iFolder 3.x Accounts” on page 17

Coexistence of Novell iFolder 2.1x and iFolder Clients

The open source iFolder client and the Novell iFolder 2.1x client can coexist on the same

computer, but they are not integrated and their software should not be installed in the same folder.

If you plan to also use Novell iFolder 2.1x on your computer, you must comply with the following

restrictions:

 Any local directory where you store your Novell iFolder 2.1x data should not be converted to

an iFolder.

 Any directory that contains a local directory where you store your Novell iFolder 2.1x data

should not be converted to an iFolder.

You can copy any files from your iFolder 2.1x directory to an iFolder.

Coexistence Peer-to-Peer, Simple Server, and Novell iFolder 3.x

Accounts

The open source iFolder client is designed to support Peer-to-Peer accounts, Simple Server

accounts, and Novell iFolder 3.x accounts. However, when the client is used with an iFolder 3.x

enterprise server and Web Access server, administrators might not allow peer-to-peer and Simple

Server accounts to be used in the enterprise environment.

18 iFolder User Guide

Novell Confidential Manual (ENU) 21 December 2004

Getting Started 19

Novell Confidential Manual (ENU) 21 December 2004

4 Getting Started

This section discusses the following:

 “Prerequisites and Guidelines” on page 19

 “Downloading the iFolder Client Install Files for Use with Simple Server” on page 21

 “Downloading Additional Files for Peer-to-Peer Sharing” on page 22

 “Installing the iFolder Client” on page 22

 “Updating iFolder” on page 25

 “Updating Mono for Linux and Macintosh” on page 25

 “What’s Next” on page 26

Prerequisites and Guidelines

To use iFolder

TM

, your workstation must meet the prerequisites discussed in the following sections:

 “Hardware” on page 19

 “Client Computers” on page 20

 “Mono” on page 20

 “Web Browser” on page 21

 “Network Connection” on page 21

 “Simple Server” on page 21

Hardware

The iFolder client requires the following minimum hardware:

 For each workstation:

 At least enough space on your hard drive to download and install the iFolder client for

your system

 A network adapter

 A network connection

 When working with a Novell

®

iFolder

®

3.x enterprise server, workstations can use static or

dynamic IP addresses

20 iFolder User Guide

Novell Confidential Manual (ENU) 21 December 2004

Client Computers

The iFolder client supports the following workstation operating systems:

 Novell Linux Desktop 9 (requires the Mono

®

framework)

The Mono modules you need for this release are included in the iFolder install file. For

information, see “Mono” on page 20.

 Windows 2000/XP with the latest Microsoft

®

.NET support patches

Make sure you have installed the latest critical updates for your operating system and for

.NET. See the Windows Update Web site (http://windowsupdate.microsoft.com).

 Macintosh OS X v10.3 and later (requires the Mono framework)

The Mono modules you need for this release are included in the iFolder install file. For

information, see “Mono” on page 20.

Mono

For a Linux or Macintosh workstation, the iFolder client requires the Mono framework. Mono is

a development platform for running and developing modern applications. Based on the ECMA/

ISO Standards, Mono can run existing programs that target the .NET or Java frameworks. The

Mono Project is an open source effort led by Novell and is the foundation for many new

applications. For information about Mono, see the Mono Project Web site (http://www.mono-

project.com).

When you install the iFolder client for Linux and Macintosh, you must also install Mono as a

dependent application for iFolder. The required version of Mono is packaged in the iFolder client

installation file that you download from the iFolder server. (For information, see “Downloading

the iFolder Client Install Files for Use with Simple Server” on page 21.) The following table lists

the versions of Mono used in the different iFolder releases on Linux and Macintosh:

IMPORTANT: Make sure to use the required version of Mono. If you have a different version of Mono on your

Linux or Macintosh computer, uninstall it before you install iFolder and the required version of Mono.

The iFolder client for Linux or Macintosh supports only the version of Mono included in the install

software. If you need to upgrade Mono for another reason, please check the iFolder 3.x online

documentation to see if we explicitly support that Mono version and to learn any necessary steps

to make the upgrade work correctly. For information, see the latest version of the iFolder 3.x

Readme on the Novell iFolder 3.x Documentation Web site (http://www.novell.com/

documentation/ifolder3).

iFolder Client Version Mono Version for Linux Mono Version for Macintosh

iFolder client for Novell iFolder 3.0

(released for OES Linux)

1.1.7.1.44342 1.1.7.2

iFolder client for Novell iFolder 3.1

(released for OES SP1 Linux)

1.1.7.7 1.1.7.7x

Page is loading ...

Novell iFolder Open Source User guide

Novell iFolder Open Source User guide

Related papers

Other documents