Requirements and Prerequisites
 - Host Platforms
 - Supported Servers
Installing and Removing Sharity 3
 - Installation
 - Upgrading to a new Version
 - Removing Sharity 3
Working with Sharity 3
 - Configuring
 - Logging in and out
 - Authentication with Kerberos
 - Using the Keychain
 - Browsing Resources
 - /CIFS as a Magic Directory
 - Login and Keychain Access from the Command Line
 - Mounting Shares from the Command Line
 - Accessing ACLs
 - General Information
Configuring a Windows PC to share Files
 - Configure the Network
 - Sharing a Directory
 - Name and Browsing Services
Tips and Tricks
 - Help for Configuration Options
 - Make a Permanent Mount
 - Default Login for Domain
 - Set up a Default Account
 - Creating a Debug Log
 - Recovering from a Daemon Crash
 - Debugging Kerberos and AD
Unix Home Directories on SMB Shares
 - Overview
 - Sharity and DirectControl
 - Integrating Sharity with Other Software
 - Limitations
Release Notes
Software License

Installing and Removing Sharity 3


These are the Generic Unix instructions. If you use an installer package on Mac OS X, read the instructions given by the installer instead.
  1. Be sure to have the following information at hand:
    • The directory where Sharity shall be installed.
    • The directory where your local/personal binaries reside.
    • (Optionally) the name of your workgroup or if you are in a domain, the full DNS name of the domain. You can obtain this information from your system administrator. If you have no system administrator because this is your home network, simply leave it blank.
    • If your network uses a WINS server, the IP address of that server. Again, you can ask your system administrator for this information. If this is your home network, you probably don't have a WINS.
  2. Download Sharity from our web site: Packages are available in tar.gz format for all supported platforms. Please choose the Sharity 3 package which suits your operating system and processor type.
  3. Unpack the package. You need gzip and tar. Both tools are distributed with most operating systems. If you lack one of them, please download gzip from or gnutar from You can unpack the package with the command
    gzcat PACKAGE.tar.gz | tar xf -
  4. This will create a directory with the same name as the package (except the .tar.gz extension) in the current directory. Change to the newly created directory and run the setup script as root user:
    It is important that you run this script from the current directory.
  5. The setup script will guide you through the installation. Please follow the instructions given by the script.
  6. Sharity 3 comes with a built-in trial mode which allows one connection (one mounted share), one installation and one user. During the beta phase we may provide free expiring demo license keys on our web site. If you have a license key, install it from the command line:
    sharity license license-key
    or through the GUI application "sharitygui".
To install Kerberos and Active Directory support for Sharity, please repeat the steps above for the Sharity 3 Kerberos Module (named sharity-mod-krb).

If you have gone through these steps and no errors occurred, Sharity 3 is installed on your system. You should now start the Sharity GUI in an X session. Sharity will use the GUI to ask for passwords when required. The Sharity GUI is installed in the binaries directory and has the name "sharitygui".

Once the GUI is running, you can start browsing your network at the browse directory. By default, this is at /CIFS.

Upgrading to a new Version

When a new version becomes available, you can upgrade in the same way as described above. The setup script will ask you whether you want to upgrade or perform a new install. A new install will give you a clean start while an upgrade preserves your preferences and settings. The upgrade skips most of the questions and uses the answers given during the original install. Please note that upgrading from Sharity 2 to 3 is not possible, you need to install from scratch.

Removing Sharity 3

The Sharity package contains the script "uninstall" along with the "setup" script described above. Run this "uninstall" script to remove Sharity. The script will ask you for the path where Sharity was installed.

A copy of the "uninstall" script is also available at Sharity's installation directory. If you use this instance of the script, make a backup copy before you run it because it will destroy itself (it is part of the installation, after all).

Copyright © 2004 - 2007 by OBJECTIVE DEVELOPMENT Software GmbHprinter friendly version