For more information about Sharity please visit http://www.obdev.at/products/sharity/

Welcome to Sharity on Mac OS X!

Installing Sharity

To install Sharity, please perform the following steps:

1.	Remove any older versions of Sharity (see the documentation for that version for how to remove it).

2.	Open a Finder window and go to the "Library" folder directly on your Mac OS X startup volume. (There are several folders named "Library". We mean the one in the root of the startup volume.)

3a. If there is a folder named "StartupItems", drop the "Sharity" folder into it. The Sharity folder is in the "StartupItems" folder in the distributed disk image.
3b. If there is no such folder, drop the whole folder "StartupItems" from the distributed disk image directly into the "Library" folder.
	You should have created a directory hierarchy like this in any case:

	/Library/StartupItems/Sharity

4.	Copy the Sharity application to whatever destination you like. We strongly recommend the "Applications" folder on the startup volume.

5.	Open the System Preferences, go to the "Login" section and add the Sharity application to your Login Items.

6.	Restart the computer

7.	Sharity will ask you for the network parameters.

After you have entered your network parameters, open a Finder window, click the "Computer" button in the tool bar, open "Network", open "CIFS" and you should see the Windows computers in your network. When you open a computer, you see the shares exported by the computer (after you have been asked for your user name and passwod on that computer, if the computer is set up to ask for user credentials).

If you have a license key, please set it before you touch any servers. License keys can only be set when no users are logged in and no shares are mounted. This can be tricky if you used Sharity in demo mode before. The easiest way to get rid of all servers is to close all Finder windows and restart the machine.

If you are a Unix expert, please also read the Readme file in the Unix folder. It contains information how to install the commandline interface to Sharity.

Quick Troubleshooting Guide

If the "CIFS" folder is empty (except maybe the "Entire_Network" subfolder), browsing does not work with your network setup. There are many possible reasons and many things you can try. See the "Troubleshooting" chapter in the manual for a detailled and really technical description of the problem and what you can do. You get to the manual by clicking the "Help" menu item in the Sharity application or by opening /Library/StartupItems/Sharity/manual/01-index.html.

If you don't care about "real" browsing, you can enter the computers of your network manually: Open the Sharity application, go to the "CIFS Servers" section and for each computer in your network click the "Add" button and enter the computer's name. The computers will appear in the "CIFS" folder.

If you still can't see the shares on these computers, your WINS server setting might be incorrect. If you don't care to fix it, you can configure the IP addresses of all your computers manually. Please note that the computer's IP address is an expert setting. Never set an IP address for the ".default" entry!

Sharity depends on the BSD subsystem in Mac OS X. The BSD subsystem is installed by default, you must have made a custom installation if you don't have it. If you are not sure whether it is installed, please look at the folder /Library/Receipts on your Mac OS X start volume. You can find all installed packages there. The BSD subsystem can be installed at any time. It is on the Mac OS X CD in the folder /System/Installation/Packages.

Please be sure to visit our support pages at

	http://www.obdev.at/products/sharity/support.html

they always contain the most recent version of the manual, a list of known bugs and answers to the most frequently asked questions.

Removing Sharity

To remove Sharity from your machine:

1.	Delete the Sharity application.

2.	Delete the Sharity folder in /Library/StartupItems on your Mac OS X  startup volume.

3.	Restart your computer.

_________________________________________
Copyright 2001, Heger, Schwarzott, Starkjohann & Tiefenbrunner OEG.