Novell iFolder Linux Client Readme

1.0 Installing the iFolder Client on Your Linux Workstations
2.0 Prerequisites
3.0 For iFolder Icon to be Visible on the Panel
4.0 Installing the iFolder Client on a Linux Desktop
5.0 Configuration Procedures
6.0 Using iFolder
6.1 Automatically Starting iFolder Linux Client
7.0 Known Issues
7.1 General
7.2 Sync Related
8.0 Legal Notices

1.0 Installing the iFolder Client on Your Linux Workstations

Install the iFolder client on every workstation that you typically use, including your desktops and laptops at work and home. The client supports the following Linux desktops:

You need the iFolder client on your workstation to take advantage of the automatic synchronization feature of iFolder. However, you can access your files on the iFolder server from any computer or handheld device using a Web browser and an active Internet or network connection.


2.0 Prerequisites

Your iFolder administrator must provision your username for iFolder services before you can create and activate an iFolder account for that username. Typically, your username is the same as your network user ID. If you want to share an iFolder account with a small group of users, ask your iFolder administrator to create and provision a shared identity in the LDAP directory.

Before you install the client, make sure your workstation meets the following prerequisites:


3.0 For iFolder Icon to be Visible on the Panel

For iFolder icon to be visible on the panel, ensure Notification Area / System Tray is present on GNOME /KDE.


4.0 Installing the iFolder Client on a Linux Desktop

  1. Log on to the super user mode. This ensures that you have privileges to install software.

  2. (Conditional) Uninstall any prototype version of the client that exists on the desktop. This ensures a clean install.

  3. Download the novell-ifolder-client.rpm file, the client install program.

    1. Launch a Web browser.

    2. Go to the beta download Web site.

    3. From the beta Web site, download the .rpm file to a local download directory

  4. Extract and install the .rpm file by executing the following command at the console prompt:

    rpm -i novell-ifolder-client.rpm -h -v

    Or

    rpm -U novell-ifolder-client.rpm -h -v

    where

    rpm

    Installs the package

    -i

    Option to install

    -U

    Option to upgrade. (However, because this is the first release, this option is similar to the -i option.)

    -h

    Prints hashes as the package archive is unpacked

    -v

    Displays verbose messages

    --test

    Tests the install

    For more details, refer to the man page of rpm command by executing man rpm at the system console.

    Wait while the rpm extracts and installs the package.

  5. Verify that the package was installed successfully by executing the following:

    rpm -qa | grep novell-ifolder-client

    where

    -grep: Enables the search for the specified file

  6. View the list of files by executing the following:

    rpm - ql novell-ifolder-client

    where

    ql: Enables query list

  7. View the iFolder man page by executing man novell-ifolder-client at the system console.

  8. Continue with 5.0 Configuration Procedures.


5.0 Configuration Procedures

You must configure the iFolder client before you can use it.The first time you log in to the iFolder server, iFolder creates and activates an iFolder account for you on the iFolder server. Your iFolder administrator sets iFolder client and server policies that govern which features and settings of the iFolder client you can personalize and which are mandatory. Some of the options mentioned in the following instructions might be disabled based on the policies set for your account.

  1. Verify that the Internet or network connection is enabled.

  2. Start an iFolder client session, by executing the following command in the system console:

    novell-ifolder-client

    Or

    Launch it from the Menu Panel

    The inactive iFolder icon appears on your status bar.

  3. Complete the login information.

    1. Enter your iFolder user ID.

      For example, acatt or jsmith.

    2. Enter your password.

    3. Specify the iFolder server where your iFolder data and account information reside.

      Get the server information from your iFolder administrator.

    4. To place a shortcut to your local iFolder directory on your current desktop, check the iFolder Shortcut check box. This setting can vary between workstations.

    5. Click Login.

  4. Browse to and select the area on your hard drive where you want to create your local iFolder directory and store your iFolder files, then click OK.

    Your local iFolder directory can be in a different location on each of your workstations, if desired. If the iFolder location is a remote filesystem, then it should be in users home directory. The complete location path cannot exceed 259 characters. Also, the path is the exact location of your iFolder files.

  5. Specify your security preferences.

    1. Check the Save Password check box to enable the iFolder client to save your password and log in to the iFolder server from this workstation.

      iFolder prompts you for the user password whenever you log in to the iFolder server.

      Although automatic login is convenient, it might not be a desirable option in an environment where passwords change frequently. iFolder authenticates your password against the LDAP directory and is not aware of password changes made at the network level. You must be logged in to iFolder to disable the Remember Password option. If you change your password while logged out of iFolder, you might inadvertently lock yourself out of the iFolder client.

      In addition, iFolder synchronizes your files as soon as you log in to the iFolder server and intermittently after that as long as you have an active connection to the server. There might be occasions when you do not want iFolder to synchronize files automatically, such as when you want to reserve limited bandwidth for other activities.

      To modify your Save Password preference later: Log in to iFolder, right-click the iFolder icon in the system tray, click Account Information > Preferences, then check or uncheck the Remember Password check box.

    2. (Highly recommended) Check the Encrypt Files check box to encrypt your files for transmission and for storage on the iFolder server.

      iFolder stores your iFolder data locally in clear text. If you enable encryption, iFolder encrypts your iFolder data before it sends files across public or private connections to be stored on the iFolder server and synchronized to your other workstations. Files remain encrypted on the iFolder server and in transit. When it downloads files from the iFolder server, iFolder decrypts files as they arrive at the workstation and stores them locally in clear text. Currently, iFolder uses the Blowfish encryption algorithm.

      This setting applies for the life of the account and across all workstations.

    3. Click OK.

  6. (Conditional) If you enabled encryption in Step 5, specify your encryption passphrase preferences.

    1. Specify your encryption passphrase, then type it again to confirm it.

      iFolder uses the passphrase to create the encryption key that it uses to encrypt files it uploads and decrypt files it downloads between your computer and the iFolder server.

    2. Specify a hint that helps remind you of your passphrase.

      If you forget your passphrase or type an incorrect passphrase, iFolder automatically responds with the hint you provide. For example, Mother's maiden name, Dog's nickname, or My favorite song.

    3. Check the Remember Passphrase check box to enable the iFolder client to save your passphrase and enter the passphrase automatically during the login process.

      iFolder prompts you for the encryption passphrase whenever you log in to the iFolder server. If you save the passphrase, you do not see the Passphrase dialog box during the iFolder login process.

      To modify your Remember Passphrase preference later: Log in to iFolder, right-click the iFolder icon on the status bar, click Account Information > Preferences, then check or uncheck the Remember Passphrase check box.

    4. Click OK.

    5. (Highly recommended) Check the Enable Passphrase Recovery check box to enable your iFolder administrator to recover your passphrase.

      If this option is enabled, iFolder encrypts your passphrase using the iFolder administrator's Security Passphrase and stores it encrypted on the iFolder server. If you forget your passphrase and your passphrase hint does not help you recall it, your iFolder administrator can access your passphrase and tell you what it is.

    6. Click OK.

    Your Passphrase, Hint, and Passphrase Recovery settings apply for the life of the account and across all workstations. The Remember Passphrase option applies only to the current workstation and is modifiable.

The iFolder client logs in to the iFolder server and uses your configuration information to create and activate your account on the iFolder server. If the login succeeds and the connection between the iFolder client and the iFolder server is active, the iFolder icon changes from inactive to active in your system tray.

If you enabled the desktop shortcut in Step 3e, iFolder places the shortcut on the desktop. If there is no shortcut, right-click the iFolder icon on the status bar, then click Open iFolder to access your local iFolder directory.


6.0 Using iFolder

  1. Launch the iFolder help for detailed instructions on the tasks that you can perform using the iFolder client.

    To launch help, right-click the iFolder Client > Help.

  2. Synchronize your files.

    1. Place the files you want to synchronize in the local iFolder directory that you specified in Step 4.

    2. Open your directory browser, then move or copy the files to your local iFolder directory.

    3. Click the iFolder icon, then click Sync Now.

      If your system administrator enabled automatic synchronization, the iFolder client synchronizes files with the iFolder server immediately.

      The iFolder uploads the files from the local iFolder directory to the iFolder server. For subsequent client installs to other workstations, iFolder downloads files from the iFolder server to the local iFolder directory.


6.1 Automatically Starting iFolder Linux Client

To automatically start iFolder Linux client, when the Linux System reboots, complete the following:


On Ximian Desktop

  1. Select System > Personal Settings >Sessions.

  2. In Sessions screen, select Startup Programs tab, Press Add and then add the following to the start up command:

    /opt/novell/ifolder/bin/novell-ifolder-client


On KDE

Include the link in $HOME/.kde/Autostart.


7.0 Known Issues


7.1 General


7.2 Sync Related


8.0 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.

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.

Copyright © 2005 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.

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

SUSE is a registered trademark of SUSE AG, a Novell business.

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