1 files changed, 75 insertions, 0 deletions
diff --git a/files/setup.mdwn b/files/setup.mdwn
new file mode 100644
index 0000000..aaddcac
--- /dev/null
+++ b/files/setup.mdwn
@@ -0,0 +1,75 @@
+# 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.
+
+
+ 1. Open filesharing:
+   * With MacOS X choose "Connect to server..." from the desktop.
+   * With MacOS Classic choose "AppleShare" from "Chooser" in the apple
+     menu.
+
+ 2. Connect to the server (ask your technicians for the hostname)
+
+ 3. 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 if written with "afp://" in front of the
+hostname.
+
+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:
+
+ 1. Use an sftp application:
+    * With Windows the Free Software application
+      [WinSCP](http://winscp.org/) is recommended.
+    * With MacOS X the Free Software application
+      [Fugu](http://rsug.itd.umich.edu/software/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](http://pros.orange.fr/chombier/MacSFTP/SFTP_info.html)
+    * 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.
+
+ 2. Type in the server address (ask your technicians for the hostname), and
+    your personal access info.
+
+Alternatively your can in some cases double-click the address if written with
+"sftp://" in front of the hostname.
+
+/!\ 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.
+
+
+## More info
+
+ * [[Overview|files]] of filesharing info.
+ * [[Overview|account]] of possibilities with your account.