aboutsummaryrefslogtreecommitdiff
path: root/USE.md
diff options
context:
space:
mode:
Diffstat (limited to 'USE.md')
-rw-r--r--USE.md68
1 files changed, 68 insertions, 0 deletions
diff --git a/USE.md b/USE.md
new file mode 100644
index 0000000..e464b91
--- /dev/null
+++ b/USE.md
@@ -0,0 +1,68 @@
+# 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.net/) 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.