USE.md



Filesharing setup
[[File shares|intro]] is accessible in different ways. Via the
Macintosh-friendly afp or the more generic sftp.
Macintosh-friendly access (afp)
The easiest method is using the "Apple Filesharing Protocol", afp.
It is integrated in both MacOS X and the older MacOS Classic, and provides
separate access to each personal and group share.

Open filesharing:


With MacOS X choose "Connect to server..." from the desktop.
With MacOS Classic choose "AppleShare" from "Chooser" in the apple
menu.


Connect to the server [[!template id=filehost]]


Log on using your personal access info, and choose the file shares
you want bound to your machine.


Alternatively in some cases, e.g. with the MacOS X web-browser Safari,
you can double-click the address <afp://[[!template id=filehost]]>
When finished using the shares, "eject" it by dropping it in the trash
can.
General access (sftp)
Windows and Linux unfortunately cannot (in a simple way) use afp, and
their own similar builtin methods are either too insecure (ftp, nfs) or
problematic to get to work through the Internet (smb).
The alternative SSH-based sftp works on all three platforms with a helper
application installed:


Use an sftp application:

With Windows the Free Software application
WinSCP is recommended.
With MacOS X the Free Software application
Fugu is recommended.
With MacOS X for terminal use you can use the builtin command line
tool "sftp".
With MacOS Classic you can use the shareware application
MacSFTP
With Linux on X11 desktop, both Gnome and KDE have sftp support builtin.
With Linux on a text terminal, the application "Midnight Commander" (the
command "mc") is recommended.


Type in the server address [[!template id=filehost]], and your personal
access info.


Alternatively your can in some cases double-click the address
<sftp://[[!template id=filehost]]>
/!\ Sftp provides access to all of your personal account, without any
userfriendly wrapping. Avoid moving around folders and files you do not
know what is. For example the "Maildir" folder, containing all of your
emails.
Sftp only provides access to your personal account. With some adjustment
on the server you can also be granted access to some types of group
shares as well. If you can only access personal file shares using sftp, and you
need access to group shares too, then please tell your technicians to adjust
your access on the server.