From c23514ba8d95df7a62dbb8be11a4ffe473cc33a6 Mon Sep 17 00:00:00 2001 From: Georgios Kafanas Date: Thu, 20 Jun 2024 09:30:39 +0200 Subject: [PATCH 1/6] [BUG FIX] Delete spurious swap file --- docs/data/.transfer.md.swp | Bin 36864 -> 0 bytes 1 file changed, 0 insertions(+), 0 deletions(-) delete mode 100644 docs/data/.transfer.md.swp diff --git a/docs/data/.transfer.md.swp b/docs/data/.transfer.md.swp deleted file mode 100644 index ea2b1247254e2ee1cb880ad791bb800d5fc16953..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 36864 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 From 69f649693cf4ae3fa06bbe961caf3a599f7167e3 Mon Sep 17 00:00:00 2001 From: Georgios Kafanas Date: Fri, 12 Jul 2024 11:14:35 +0200 Subject: [PATCH 2/6] [BUGFIX:data-transfer] Add explanation to all file transfer commands --- docs/data/transfer.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/data/transfer.md b/docs/data/transfer.md index 0a3ec85b..a82f0338 100644 --- a/docs/data/transfer.md +++ b/docs/data/transfer.md @@ -374,6 +374,7 @@ copies a file from the SAMBA directory to the local machine. Notice the use of d ``` smbclient //atlas.uni.lux/users --directory='name.surname' --user=name.surname@uni.lu --command='put "full path/to/local file.txt" "full path/to/remote file.txt"' ``` +copies a file from the local machine to the SMB directory. Moving whole directories is a bit more involved, as it requires setting some state variables for the session, both for interactive and non-interactive sessions. To download a directory for instance, use ```bash From 3b8f2fa21b0a613a354b621337aab00ac92464ee Mon Sep 17 00:00:00 2001 From: Georgios Kafanas Date: Fri, 12 Jul 2024 11:16:45 +0200 Subject: [PATCH 3/6] [STYLE:sata-transfer] Replace all reference of SAMMBA with SMB --- docs/data/transfer.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/data/transfer.md b/docs/data/transfer.md index a82f0338..a8be77e0 100644 --- a/docs/data/transfer.md +++ b/docs/data/transfer.md @@ -343,7 +343,7 @@ The `smb-storage` script provides a optional flags to modify the default options ### Accessing SMB shares with `smbclient` -The `smbclient` program is available in both login and compute nodes. In compute nodes the only way to access SMB shares is through the client program. With the SMC client one can connect to the `users` share and browse their personal directory with the command: +The `smbclient` program is available in both login and compute nodes. In compute nodes the only way to access SMB shares is through the client program. With the SMB client one can connect to the `users` share and browse their personal directory with the command: ``` smbclient //atlas.uni.lux/users --directory='name.surname' --user=name.surname@uni.lu ``` @@ -358,7 +358,7 @@ Type `help` to get a list of all available commands or `help (command_name)` to - `mkdir (directory_name)` to create a directory, - `rm (file_name)` to remove a file, - `rmdir (directory_name)` to remove a directory, -- `scopy (source_full_path) (destination_full_path)` to move a file _within_ the SAMBA shared directory, +- `scopy (source_full_path) (destination_full_path)` to move a file _within_ the SMN shared directory, - `get (file_name) [destination]` to move a file _from_ Atlas to the local machine (placed in the working directory, if the destination is not specified), and - `put (file_name) [destination]` to move a file _to_ Atlas from the local machine (placed in the working directory, if a full path is not specified), - `mget (file name pattern) [destination]` to download multiple files, and @@ -366,11 +366,11 @@ Type `help` to get a list of all available commands or `help (command_name)` to The patterns used in `mget`/`mput` are either normal file names, or globular expressions (e.g. `*.txt`). -Connecting into an interactive SAMBA session means that you will have to maintain a shell session dedicated to SAMBA. However, it saves you from entering your password for every operation. If you would like to perform a single operation and exit, you can avoid maintaining an interactive session with the `--command` flag. For instance, +Connecting into an interactive SMB session means that you will have to maintain a shell session dedicated to SMB. However, it saves you from entering your password for every operation. If you would like to perform a single operation and exit, you can avoid maintaining an interactive session with the `--command` flag. For instance, ``` smbclient //atlas.uni.lux/users --directory='name.surname' --user=name.surname@uni.lu --command='get "full path/to/remote file.txt" "full path/to/local file.txt"' ``` -copies a file from the SAMBA directory to the local machine. Notice the use of double quotes to handle file names with spaces. Similarly, +copies a file from the SMB directory to the local machine. Notice the use of double quotes to handle file names with spaces. Similarly, ``` smbclient //atlas.uni.lux/users --directory='name.surname' --user=name.surname@uni.lu --command='put "full path/to/local file.txt" "full path/to/remote file.txt"' ``` From 778d7db8260b8fe8100b518ad29abcbba498f307 Mon Sep 17 00:00:00 2001 From: Georgios Kafanas Date: Fri, 12 Jul 2024 11:32:08 +0200 Subject: [PATCH 4/6] [REFACTOR:data-transfer] Highlight explanation about plain text passwords --- docs/data/transfer.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/data/transfer.md b/docs/data/transfer.md index a8be77e0..8a27c498 100644 --- a/docs/data/transfer.md +++ b/docs/data/transfer.md @@ -286,9 +286,12 @@ For more details on the university central storage, you can have a look at !!! info "Connecting to central data storage services from a personal machine" The examples presented here are targeted to the university HPC machines. To connect to the university central data storage with a (Linux) personal machine from outside of the university network, you need to start first a VPN connection. -The SMB shares exported for directories in the central data storage are meant to be accesses interactively. Unlike mounting with `sshfs`, you will always need to enter your password to access a directory from the central data storage, so you cannot use SMB share in job scripts at login nodes. Transfer your data manually after your job has finished. You can mount directories from the central data storage in the login nodes, and access the central data storage through the interface of `smbclient` from both the login nodes and the compute nodes in interactive jobs. +The SMB shares exported for directories in the central data storage are meant to be accessed interactively. Transfer your data manually before and after your jobs are run. You can mount directories from the central data storage in the login nodes, and access the central data storage through the interface of `smbclient` from both the compute nodes during interactive jobs and the login nodes. -The following commands are for Atlas, but commands for Poseidon are similar. +!!! danger "Never store your password in plain text" + Unlike mounting with `sshfs`, you will always need to enter your password to access a directory in an SMB share. Avoid, storing your password in any manner that it makes it recoverable from plain text. For instance, **do not** create job scripts that contain your password in plain text just to move data to Atlas within a job. + +The following commands target Atlas, but commands for Poseidon are similar. ### Mounting an SMB share to a login node From 54667cf71d252770a50034b9387597c1435223ae Mon Sep 17 00:00:00 2001 From: Georgios Kafanas Date: Fri, 12 Jul 2024 12:32:48 +0200 Subject: [PATCH 5/6] [REFACTOR:data-transfer] Reorganize the presentation of smb-storage script --- docs/data/transfer.md | 26 ++++++++++++-------------- 1 file changed, 12 insertions(+), 14 deletions(-) diff --git a/docs/data/transfer.md b/docs/data/transfer.md index 8a27c498..10edffc2 100644 --- a/docs/data/transfer.md +++ b/docs/data/transfer.md @@ -297,7 +297,7 @@ The following commands target Atlas, but commands for Poseidon are similar. The UL HPC team provides the `smb-storage` script to mount SMB shares in login nodes. -- To mount your default user directory from the default `users` share (only for staff members) call in an shell session +- There exists an SMB share `users` where all staff member have a directory named after their user name (`name.surname`). To mount your directory in an shell session at a login node execute the command ```bash smb-storage mount name.surname ``` @@ -305,7 +305,7 @@ and your directory will be mounted to the default mount location: ``` ~/atlas.uni.lux-users-name.surname ``` -- To mount a project share `project_name` call in a shell session +- To mount a project share `project_name` in a shell session at a login node execute the command ```bash smb-storage mount name.surname --project project_name ``` @@ -322,27 +322,25 @@ or: smb-storage unmount ~/atlas.uni.lux-project_name ``` -The `smb-storage` script provides a optional flags to modify the default options: +The `smb-storage` script provides optional flags to modify the default options: -- `--help` or `-h` prints information about the usage and options of he script, -- `--server ` or `-s ` specifies the server from which the SMB share is mounted (use `--server poseidon.uni.lux` to mount a share from Poseidon), -- `--project ` or `-p ` mounts the share `` (the default project `users` is mounted), -- `--mountpoint ` or `-m ` selects the path where the share will be mounted (the default location is `~/--`), -- `--debug` of `-d` print details of the operations performed by the mount script. +- `--help` prints information about the usage and options of he script; +- `--server ` specifies the server from which the SMB share is mounted (defaults to `--server atlas.uni.lux` if not specified, use `--server poseidon.uni.lux` to mount a share from Poseidon); +- `--project []` mounts the share `` and creates a symbolic link to the optionally provided location ``, or to the project root directory if a location is not provided (defaults to `--project users name.surname` if not specified); +- `--mountpoint ` selects the path where the share directory will be available (defaults to `~/--` if nbot specified); +- `--debug` prints details of the operations performed by the mount script. !!! info "Best practices" - - Mounted SMB shares will be available in the login node, the mount point will appear as a dead symbolic link in compute nodes. This is be design, you can only mount SMB shares in login nodes because SMB shares are meant to be used in interactive sections. + Mounted SMB shares will be available in the login node, and he mount point will appear as a dead symbolic link in compute nodes. This is be design, you can only mount SMB shares in login nodes because SMB shares are meant to be used in interactive sections. Mounted shares will remain available as long as the login session where the share was mounted remains active. You can mount shares in a `tmux` session in a login node, and access the share from any other session in the login node. ??? info "Details of the mounting process" - There exists a default SMB share `users` where all staff member have a directory named after their user name (`name.surname`). If no share is specified with the `--project` flag, the default share `users` is mounted in a specially named directory in `/run/user/${UID}/gvfs`, and a symbolic link to the user folder is created in the mount location by the `smb-storage` script. - - All projects have a share named after the project name. If a project is specified with the `--project` flag, the project share is mounted in a specially named directory in `/run/user/${UID}/gvfs`, and a symbolic link to the whole project directory is created in the mount location by the `smb-storage` script. + There exists an SMB share `users` where all staff member have a directory named after their user name (`name.surname`). All other projects have an SMB share named after the project name (in lowercase characters). - During unmounting, the symbolic links are deleted by the `smb-storage` script, and the shares mounted in `/run/user/${UID}/gvfs` are unmounted and their mount points are removed. **If a session with mounted SMB shares terminates without unmounting the shares, the shares in `/run/user/${UID}/gvfs` will be unmounted and their mount points deleted, but the symbolic links created by `smb-storage` must be removed manually.** + The `smb-storage` scripts uses `gio mount` to mount SMB shares. Shares are mounted in a specially named mount point in `/run/user/${UID}/gvfs`. Then, `smb-storage` creates a symbolic link to the requested `directory in project` in the path specified in the `--mountpoint` option. + During unmounting, the symbolic links are deleted by the `smb-storage` script and then the shares mounted in `/run/user/${UID}/gvfs` are unmounted and their mount points are removed using `gio mount --unmount`. **If a session with mounted SMB shares terminates without unmounting the shares**, the shares in `/run/user/${UID}/gvfs` will be unmounted and their mount points deleted, but **the symbolic links created by `smb-storage` must be removed manually**. ### Accessing SMB shares with `smbclient` From 9fe42151c6cf6b94ee35a5e04346bee7a9f0ff0f Mon Sep 17 00:00:00 2001 From: Georgios Kafanas Date: Fri, 12 Jul 2024 12:44:20 +0200 Subject: [PATCH 6/6] [BUGFIX:data-transfer] Fix buggy flags for SSHSF Many of the flags used in the version of SSHFS originally documented are now deprecated. Updated the recommended options. --- docs/data/transfer.md | 20 ++++++++------------ 1 file changed, 8 insertions(+), 12 deletions(-) diff --git a/docs/data/transfer.md b/docs/data/transfer.md index 10edffc2..8fe590c8 100644 --- a/docs/data/transfer.md +++ b/docs/data/transfer.md @@ -248,22 +248,18 @@ sshfs [user@]host:[dir] mountpoint [options] ``` Proceed as follows (_assuming_ you have a working [SSH connection](../connect/ssh.md)): - ```bash -# Create a local directory hosting the mountng point -mkdir -p ~/ulhpc # /!\ ADAPT accordingly to match your taste -sshfs iris-cluster: ~/ulhpc -o allow_other,defer_permissions,follow_symlinks,reconnect -ocache=no -onolocalcaches -# General options: -# allow_other: Allow other users than the mounter (i.e. root) to access the share -# reconnect: try to reconnnect -# Optional options to be more "Mac-like": -# -ocache=no -# -onolocalcaches -# -o volname=ulhpc_home Name of the volume in Finder +# Create a local directory for the mounting point +mkdir -p ~/ulhpc # Your prefered mount point +sshfs iris-cluster:~/ulhpc -o follow_symlinks -o reconnect -o dir_cache=no ``` +Options used: -Later on (once you no longer need it), you **MUST** unmount your remote FS +- `follow_symlinks` presents symbolic links in the remote files system as regular files in the local file system, useful when the symbolic link points outside the mounted directory; +- `reconnect` allows the SSHFS client to automatically reconnect to server if connection is interrupted; +- `dir_cache` enables or disables the directory cache which holds the names of directory entries (can be slow for mounted remote directories with many files). +When you no longer need the mounted remote directory, you **must** unmount your remote file system: ```bash # Linux fusermount -u ~/ulhpc