2 files changed, 106 insertions, 0 deletions
diff --git a/files/intro.mdwn b/files/intro.mdwn
new file mode 100644
index 0000000..a6ff55e
--- /dev/null
+++ b/files/intro.mdwn
@@ -0,0 +1,32 @@
+# Introduction to filesharing
+
+Your account at [[template id=realm]]  provides access to file shares. Some
+personal shares and some shares common to the groups you are member of.
+
+
+## Access from Macintosh
+
+ 1. Change to the application "Finder" (switch to the desktop)
+ 2. Choose "Go" from the menu, and then "Connect to server..." at the bottom
+ 3. Type in the server address **[[template id=filehost]]**
+ 3. Provide your username and password
+ 4. Choose the file shares to use
+
+
+## Access from Windows
+
+ 1. Download and install the application [WinSCP](http://winscp.org/)
+ 2. Start the application "WinSCP"
+ 3. Type in the server address **[[template id=filehost]]**, and
+    your username and password
+ 4. Work only in the supfolders containing normal documents!
+
+/!\ Contact your technicians if you need access to **shared** documents from
+Windows, as it requires a few adjustments on the server.
+
+
+## More info
+
+ * [[Setup]] more detailed.
+ * [[Overview|files]] of filesharing info.
+ * [[Overview|account]] of possibilities with your account.
diff --git a/files/setup.mdwn b/files/setup.mdwn
new file mode 100644
index 0000000..fde80bd
--- /dev/null
+++ b/files/setup.mdwn
@@ -0,0 +1,74 @@
+# 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 **[[template id=filehost]]**
+
+ 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 <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:
+
+ 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 **[[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.
+
+
+## More info
+
+ * [[Overview|files]] of filesharing info.
+ * [[Overview|account]] of possibilities with your account.