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.
To install Kerberos and Active Directory support for Sharity, please repeat the steps above for the Sharity 3 Kerberos Module (named sharity-mod-krb).
- 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.
- Download Sharity from our web site: http://www.obdev.at/products/sharity/. 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.
- 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 http://www.gzip.org/ or gnutar from http://www.gnu.org/software/tar/. You can unpack the package with the command
gzcat PACKAGE.tar.gz | tar xf -
- 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.
- The setup script will guide you through the installation. Please follow the instructions given by the script.
- 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".
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.
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.
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).