aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/intro.md15
-rw-r--r--doc/setup.md75
-rw-r--r--doc/use.md32
3 files changed, 122 insertions, 0 deletions
diff --git a/doc/intro.md b/doc/intro.md
new file mode 100644
index 0000000..ce2f843
--- /dev/null
+++ b/doc/intro.md
@@ -0,0 +1,15 @@
+# Overview of file sharing info
+
+Each user [[account]] provides access to personal and shared files.
+
+
+## Setup
+
+ * Short [[files/intro]] to accessing file shares
+ * [[Configuration|files/setup]] more detailed
+
+
+## Use
+
+ * The file shares are restricted by a disk [[quota]]
+ * [[Problem]] reporting
diff --git a/doc/setup.md b/doc/setup.md
new file mode 100644
index 0000000..aaddcac
--- /dev/null
+++ b/doc/setup.md
@@ -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.
diff --git a/doc/use.md b/doc/use.md
new file mode 100644
index 0000000..afc288d
--- /dev/null
+++ b/doc/use.md
@@ -0,0 +1,32 @@
+# Introduction to filesharing
+
+Your account 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 (ask your technicians for the hostname)
+ 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 (ask your technicians for the hostname), 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.