Skip to content

Commit 840be80

Browse files
SebastianPrehnSebastianPrehn
committed
Add networkdrive info for SIF
1 parent 2f7ddbf commit 840be80

File tree

5 files changed

+152
-0
lines changed

5 files changed

+152
-0
lines changed

‎docs/index.rst

+1
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,7 @@ ERDA/SIF: User Guides
3434

3535
sections/sif/signup/index
3636
sections/sif/project/index
37+
sections/sif/networkdrive/index
3738

3839

3940
Welcome to the documentation site for ERDA and SIF! `ERDA <https://erda.ku.dk/>`_ and `SIF <https://sif.ku.dk/>`_ simplifies storing, sharing, analyzing and archiving research data for KU/UCPH employees, their collaboration partners, and KU/UCPH students.

‎docs/sections/sif/networkdrive/index.rst

+82
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
.. _sif-networkdrive-start:
2+
3+
=====================
4+
Efficient Data Access
5+
=====================
6+
7+
As a SIF user, you can work locally on your cmoputer with your SIF files by connecting SIF as a network drive for efficient and transparently integrated file access through different interfaces.
8+
9+
10+
These interfaces allow you to transfer many or big files more efficiently and to map your individual SIF project files and folders on your local PC or workstation.
11+
In that way you can work with them as if they were local files.
12+
13+
14+
Please note that the strict SIF project isolation applies to these interfaces as well, so you can only have one project open at a time.
15+
If you have more than one SIF project you configure efficient access for each of them individually.
16+
17+
18+
All the interfaces use a secure connection to SIF, so they are accessible from anywhere where you have an Internet connection.
19+
Thus, you do not need VPN or anything like that to access them from outside UCPH.
20+
However, they require you to have an active two-factor authentication session from the same computer for added security.
21+
22+
23+
+--------------------+-------------------------------------------------------------------------+
24+
| 1. WebDAVS | WebDAVS is an abbreviation for Web-based Distributed Authoring |
25+
| | |
26+
| | and Versioning. A "S" is for secure, as it all runs on a |
27+
| | |
28+
| | secure connection. |
29+
| | |
30+
| | ☑ Can be used from Windows, Mac and Linux/UNIX |
31+
| | |
32+
| | ☑ Easy to get started |
33+
| | |
34+
| | ☑ Does not require software installation |
35+
| | |
36+
| | 𐄂 Limit on file size on Windows - 50 MB as a starting point |
37+
| | |
38+
| | 𐄂 Sensitive to network outages |
39+
| | |
40+
| | 𐄂 WebDAVS is less efficient at transferring many and/or large files. |
41+
| | |
42+
+--------------------+-------------------------------------------------------------------------+
43+
| 2. SSHFS with SFTP | SSHFS is an abbreviation for Secure Shell File System and is the |
44+
| | client |
45+
| | |
46+
| | that connects an SFTP service as a network drive on your |
47+
| | |
48+
| | |
49+
| | computer. SFTP is an abbreviation for Secure File Transfer Protocol. |
50+
| | |
51+
| | ☑ Can be used from Windows, Mac and Linux/UNIX |
52+
| | |
53+
| | ☑ Efficient handling of many/large files |
54+
| | |
55+
| | ☑ Robust regarding network outages |
56+
| | |
57+
| | ☑ Unlimited file size |
58+
| | |
59+
| | 𐄂 You have to install two small programs - once |
60+
| | |
61+
+--------------------+-------------------------------------------------------------------------+
62+
63+
64+
.. TIP::
65+
**We recommend SSHFS with SFTP, particularly for users who feel comfortable with the technology and/or who work intensively with their data.**
66+
67+
⏩️ :doc:`WebDAVS </sections/sif/networkdrive/webdavs/index>`
68+
WebDAVS is a popular protocol to access remote storage using extensions to the HTTP protocol and is the simpler option.
69+
70+
⏩️ :doc:`SSHFS with SFTP </sections/sif/networkdrive/sshfs/index>`
71+
SSHFS with SFTP is another popular option to access remote storage that uses the SSH File Transfer Protocol, and is the more robust, but more complex option.
72+
73+
⏩️ :doc:`Workarounds </sections/sif/networkdrive/workarounds/index>`
74+
Sometimes workarounds are necessary. Those can be found here.
75+
76+
.. toctree::
77+
:maxdepth: 3
78+
:hidden:
79+
80+
WebDAVS </sections/sif/networkdrive/webdavs/index>
81+
SSHFS with SFTP </sections/sif/networkdrive/sshfs/index>
82+
Workarounds </sections/sif/networkdrive/workarounds/index>

‎docs/sections/sif/networkdrive/sshfs/index.rst

+4
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
SSHFS
2+
=====
3+
4+
WIP

‎docs/sections/sif/networkdrive/webdavs/index.rst

+4
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
WebDAVS
2+
=======
3+
4+
WIP

‎docs/sections/sif/networkdrive/workarounds/index.rst

+61
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
===========
2+
Workarounds
3+
===========
4+
5+
Sometimes we need to introduce a workaround either due to limitations in our own systems, or due to how something works at the KU level. Such workarounds are (for now) placed here.
6+
7+
8+
SOCK5 connection to SIF
9+
=======================
10+
11+
This workaround can sometimes be necessary if you cannot get 2FA to work on your remote KU server.
12+
Based on `https://linuxize.com/post/how-to-setup-ssh-socks-tunnel-for-private-browsing <https://linuxize.com/post/how-to-setup-ssh-socks-tunnel-for-private-browsing>`_.
13+
14+
Prerequisites
15+
-------------
16+
17+
* Server at KU running any flavor of Linux, with SSH access to route your traffic through it.
18+
* A web browser (Google Chrome, Firefox etc.).
19+
* SSH client.
20+
21+
22+
Set up the SSH tunnel
23+
---------------------
24+
25+
Linux and MacOS (tested)
26+
^^^^^^^^^^^^^^^^^^^^^^^^
27+
28+
Run the following command::
29+
30+
ssh -D 9090 [USER]@[SERVER_IP]
31+
32+
[USER]@[SERVER_IP] - Your remote SSH user and server IP address.
33+
34+
9090 is simply a port number, and can be configured.
35+
36+
Configuring your browser to use proxy
37+
-------------------------------------
38+
39+
Google Chrome (tested)
40+
^^^^^^^^^^^^^^^^^^^^^^
41+
42+
**Linux:**::
43+
44+
/usr/bin/google-chrome \
45+
--user-data-dir="$HOME/proxy-profile" \
46+
--proxy-server="socks5://localhost:9090"
47+
48+
**MacOS:**::
49+
50+
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
51+
--user-data-dir="$HOME/proxy-profile" \
52+
--proxy-server="socks5://localhost:9090"
53+
54+
**Windows:**::
55+
56+
"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" ^
57+
--user-data-dir="%USERPROFILE%\proxy-profile" ^
58+
--proxy-server="socks5://localhost:9090"
59+
60+
Once open, simply navigate to sif.ku.dk and login. After that, you can use sftp on the machine you SSH'ed to, as you have logged into SIF on that machine through the proxy.
61+

0 commit comments

Comments
 (0)