From fd5b9c9f6b13dbfe9127fd8dc6646f9fb2d0a0db Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Mon, 8 Aug 2016 18:05:17 +0200 Subject: Restructure to new file naming convention. Drop doc/use.md covered by USE.md (was doc/setup.md). --- README.md | 15 ++++++++++++++ USE.md | 68 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ doc/intro.md | 15 -------------- doc/setup.md | 68 ------------------------------------------------------------ doc/use.md | 25 ---------------------- 5 files changed, 83 insertions(+), 108 deletions(-) create mode 100644 README.md create mode 100644 USE.md delete mode 100644 doc/intro.md delete mode 100644 doc/setup.md delete mode 100644 doc/use.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..ce2f843 --- /dev/null +++ b/README.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/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 + +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 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. diff --git a/doc/intro.md b/doc/intro.md deleted file mode 100644 index ce2f843..0000000 --- a/doc/intro.md +++ /dev/null @@ -1,15 +0,0 @@ -# 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 deleted file mode 100644 index e464b91..0000000 --- a/doc/setup.md +++ /dev/null @@ -1,68 +0,0 @@ -# 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 - -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 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. diff --git a/doc/use.md b/doc/use.md deleted file mode 100644 index 29e2c98..0000000 --- a/doc/use.md +++ /dev/null @@ -1,25 +0,0 @@ -# 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.net/) - 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. -- cgit v1.2.3