Difference between revisions of "Accessing DFS"

From RHLUG Wiki
Jump to navigation Jump to search
(Major fixes for consistency now.)
Line 1: Line 1:
Sometimes you will need to access DFS (Distributed File System) to install software or upload files to a class's "dropbox".
Sometimes you will need to access DFS (Distributed File System) to install software or upload files to a class's "dropbox".


You can connect to Rose-Hulman DFS through samba (smb). (As of July 10, 2020, sftp no longer works, so you will have to use smb.)
You can connect to Rose-Hulman DFS through Samba (smb). (As of July 10, 2020, sftp no longer works, so you will have to use Samba.)


To access the Rose-Hulman DFS, you will need to be on campus. If you are off campus, you will need to use the '''GlobalProtect VPN via OpenConnect'''. Please see [[Accessing the Off-Campus VPN]] for more details.
To access the Rose-Hulman DFS, you will need to be on campus. If you are off campus, you will need to use the '''GlobalProtect VPN'''. '''Please see [[Accessing the Off-Campus VPN]] for more details.'''


= Samba =
= Samba =
Line 10: Line 10:


== Through the terminal ==
== Through the terminal ==
Open a terminal and type:
We will be using the "smbclient" utility to download from the DFS server. This is a command line utility.


<code>/usr/bin/smbclient //rose-hulman.edu/DFS -U [Your RHIT network user name]@rose-hulman.edu</code> ('''you must type in your full email here'''!)
Open a terminal and type the following (substitute ROSE-USERNAME with your username):


Note the '''forward slashes''' instead of the backslashes. In the terminal, the backslash (\) is an escape character. To type one backslash (which you can also do), type \\. To type two, type \\\\.
<code>smbclient //rose-hulman.edu/DFS -U ROSE-USERNAME@rose-hulman.edu</code>


Also, we are typing /usr/bin/smbclient to avoid possible mistakes due to backslashes.
then press ENTER.


If you get a message saying <code>/usr/bin/smbclient: Can't load /etc/samba/smb.conf - run testparm to debug it</code>, run <code>sudo touch /etc/samba/smb.conf</code> in a terminal to create an empty SMB configuration. Usually this is not needed, but sometimes smbclient is finicky.
Note the '''forward slashes''' instead of the backslashes. If you want to use backslashes in the terminal, note that a single backslash (\) is an escape character. So, to type one backslash (which you can also do), type \\. To type two backslashes, type \\\\.
 
Then type in your password and press ENTER.


If this doesn't let you type in your password, there may be an issue with a connection method not reaching their servers. Try an [[#No_password_prompt_comes_up|alternate connection method]].
Wait up to 2 minutes for the <code>smb: \></code> prompt to appear. If it doesn't show up within 2 minutes, try logging out and logging back in again. It may take a few tries (probably because the SMB share doesn't do a good job of responding to connections).


Then type in your password and press ENTER.
Otherwise, try one of the fixes listed here: [[Troubleshooting#smb: \> prompt still not showing up]].


Once you're connected, you can type help and get a list of commands to use.
Once you're connected, you can type help and get a list of commands to use.
For example, you can use "cd" to move around the virtual file system, "ls" to see what files are available in the current directory, "pwd" to see which directory you're in, and "get" to download a file from the sftp server.


Source: [https://help.ubuntu.com/community/Samba/SambaClientGuide#Samba_Client_-_Manual_Configuration Ubuntu Samba Client Guide]
Source: [https://help.ubuntu.com/community/Samba/SambaClientGuide#Samba_Client_-_Manual_Configuration Ubuntu Samba Client Guide]


= Troubleshooting =
= Troubleshooting =
Make sure you are on the [https://github.com/samba-team/samba/releases latest stable version of smbclient] (install updates) first. (In the link, don't look for rc releases, just the samba-... ones)
Make sure you are on the latest stable version of smbclient first. Check your distro's package repos and cross-reference that with the version from [https://github.com/samba-team/samba/releases] (do not worry about -rc versions).
 
If your distro does not have the latest version in their package repos, download and use the executable from here: [https://github.com/samba-team/samba/releases]. (In the link, don't look for rc releases, just the samba-... ones)


== No password prompt comes up ==
 
=== Testparm Error ===
If you get a message saying <code>/usr/bin/smbclient: Can't load /etc/samba/smb.conf - run testparm to debug it</code>, run <code>sudo touch /etc/samba/smb.conf</code> in a terminal to create an empty SMB configuration. Usually this is not needed, but sometimes smbclient is finicky.
 
Then try connecting to DFS with smbclient again.
 
=== No password prompt comes up ===
==== Fix 1 ====
'''Make sure to include <code>-U</code>''' in your smbclient command.
 
==== Fix 2 ====
Try typing in:
Try typing in:


Line 42: Line 58:


[https://wiki.archlinux.org/index.php/samba SMB - ArchWiki] (relevant sections: 2, 2.5 for specific desktop environment integration e.g. Gnome/KDE/XFCE)
[https://wiki.archlinux.org/index.php/samba SMB - ArchWiki] (relevant sections: 2, 2.5 for specific desktop environment integration e.g. Gnome/KDE/XFCE)
=== smb: \> prompt still not showing up ===
What you can also do is try without the <code>/dfs</code>.
Open a terminal and type the following (substitute ROSE-USERNAME with your username):
<code>smbclient //rose-hulman.edu/ -U [email protected]</code>
then press ENTER.
Once you see <code>smb: \></code>, you can now try to get to the dfs folder using <code>cd dfs</code>. Then, if you type <code>ls</code>, a bunch of folders (including Software) should show up.
If that doesn't work, your connection to the campus network may be unreliable. Disconnect and reconnect from the VPN or eduroam if on campus.
=== NT_STATUS_CONNECTION_RESET when downloading files ===
Your VPN or eduroam connection is unreliable. Make sure you're using <code>openconnect</code> as root in a terminal and not in KDE or GNOME's "Networks" panel (or anything else that uses NetworkManager).
I am not aware of other fixes. As far as I know, you can also access the DFS via the web after logging in at https://sslvpn.rose-hulman.edu. This option might have been removed around March 2020 though...

Revision as of 13:51, 12 July 2020

Sometimes you will need to access DFS (Distributed File System) to install software or upload files to a class's "dropbox".

You can connect to Rose-Hulman DFS through Samba (smb). (As of July 10, 2020, sftp no longer works, so you will have to use Samba.)

To access the Rose-Hulman DFS, you will need to be on campus. If you are off campus, you will need to use the GlobalProtect VPN. Please see Accessing the Off-Campus VPN for more details.

Samba

You will need to have smbclient installed in your repo's packages.

Through the terminal

We will be using the "smbclient" utility to download from the DFS server. This is a command line utility.

Open a terminal and type the following (substitute ROSE-USERNAME with your username):

smbclient //rose-hulman.edu/DFS -U [email protected]

then press ENTER.

Note the forward slashes instead of the backslashes. If you want to use backslashes in the terminal, note that a single backslash (\) is an escape character. So, to type one backslash (which you can also do), type \\. To type two backslashes, type \\\\.

Then type in your password and press ENTER.

Wait up to 2 minutes for the smb: \> prompt to appear. If it doesn't show up within 2 minutes, try logging out and logging back in again. It may take a few tries (probably because the SMB share doesn't do a good job of responding to connections).

Otherwise, try one of the fixes listed here: Troubleshooting#smb: \> prompt still not showing up.

Once you're connected, you can type help and get a list of commands to use.

For example, you can use "cd" to move around the virtual file system, "ls" to see what files are available in the current directory, "pwd" to see which directory you're in, and "get" to download a file from the sftp server.

Source: Ubuntu Samba Client Guide

Troubleshooting

Make sure you are on the latest stable version of smbclient first. Check your distro's package repos and cross-reference that with the version from [1] (do not worry about -rc versions).

If your distro does not have the latest version in their package repos, download and use the executable from here: [2]. (In the link, don't look for rc releases, just the samba-... ones)


Testparm Error

If you get a message saying /usr/bin/smbclient: Can't load /etc/samba/smb.conf - run testparm to debug it, run sudo touch /etc/samba/smb.conf in a terminal to create an empty SMB configuration. Usually this is not needed, but sometimes smbclient is finicky.

Then try connecting to DFS with smbclient again.

No password prompt comes up

Fix 1

Make sure to include -U in your smbclient command.

Fix 2

Try typing in:

  • /usr/bin/smbclient //rose-hulman.edu/DFS -U ROSE-HULMAN\\[Your RHIT network user name] (or ROSE-HULMAN/[Your RHIT network user name])

This is because ROSE-HULMAN is the "domain" on Windows computers that connects to the internal network.

See also

In case you have any issues, please refer to the following pages. This tutorial may be updated depending on user demand.

SMB - ArchWiki (relevant sections: 2, 2.5 for specific desktop environment integration e.g. Gnome/KDE/XFCE)

smb: \> prompt still not showing up

What you can also do is try without the /dfs.

Open a terminal and type the following (substitute ROSE-USERNAME with your username):

smbclient //rose-hulman.edu/ -U [email protected]

then press ENTER.

Once you see smb: \>, you can now try to get to the dfs folder using cd dfs. Then, if you type ls, a bunch of folders (including Software) should show up.

If that doesn't work, your connection to the campus network may be unreliable. Disconnect and reconnect from the VPN or eduroam if on campus.

NT_STATUS_CONNECTION_RESET when downloading files

Your VPN or eduroam connection is unreliable. Make sure you're using openconnect as root in a terminal and not in KDE or GNOME's "Networks" panel (or anything else that uses NetworkManager).

I am not aware of other fixes. As far as I know, you can also access the DFS via the web after logging in at https://sslvpn.rose-hulman.edu. This option might have been removed around March 2020 though...